voltha/voltha-onos

VOLTHA

什么是Voltha？

Voltha旨在在传统和下一代接入网络设备之上提供一层抽象，用于控制和管理。其最初专注于PON（GPON、EPON、NG PON 2），但目标是扩展到最终覆盖其他接入技术（xDSL、Docsis、G.FAST、专用以太网、固定无线）。

Voltha的核心概念：

• 网络即交换机：它使一组连接的接入网络设备看起来像一个（抽象的）可编程流设备，即L2/L3/L4交换机。例如：
  • PON作为交换机
  • PON + 接入回程作为交换机
  • xDSL服务作为交换机
• 向虚拟化演进：它可以与各种（接入）网络技术和设备协同工作，包括传统设备、完全虚拟化设备（从硬件和软件分离的角度）以及介于两者之间的设备。Voltha可以在设备上、中心局的通用服务器上或数据中心中运行。
• 统一OAM抽象：它提供统一的、与厂商和技术无关的设备管理任务处理，例如服务生命周期、设备生命周期（包括发现、升级）、系统监控、告警、故障排除、安全等。
• 云/DevOps桥接现代化：它在实现上述所有功能的同时，还将抽象的网络功能视为软件服务，可像云中的其他软件组件（即容器）一样进行管理。

为什么选择Voltha？

接入网络空间的控制和管理非常混乱。每种接入技术都带来了自己的协议集，此外，厂商对相同标准有自己的解释/扩展。更复杂的是，这些特定于厂商和技术的差异渗透到服务提供商的集中式OSS系统中，造成了许多效率低下的问题。

理想情况下，相同接入技术的所有厂商设备应提供相同的控制和管理接口。此外，跨技术应具有更高的协同效应。在等待厂商统一的过程中，Voltha通过将差异限制在接入局部并将其隐藏在OSS堆栈的上层之外，朝着这个方向提供了一个增量改进。

如何使用Voltha？

虽然我们仍处于开发的早期阶段，您可以查看BUILD.md文件，了解如何构建、运行、测试等。

如何提供帮助？

欢迎各种大小的贡献。小的贡献和错误修复始终以拉取请求的形式受到欢迎。对于较大的工作，最好与现有开发人员联系，了解最需要帮助的地方，并确保您的解决方案与Voltha的总体理念兼容。

贡献单元测试

首先，请根据OpenCord WIKI安装开发环境。 接下来，在shell环境中：

bash
source env.sh;             #  source环境设置并创建虚拟环境
make utest-with-coverage;  #  执行带覆盖率报告的单元测试

核心单元测试

核心的新单元测试可以用https://nose.readthedocs.io/en/latest/%E6%A1%86%E6%9E%B6%E7%BC%96%E5%86%99%EF%BC%8C%E4%BD%8D%E4%BA%8E/tests/utest/目录下。

适配器单元测试

每个适配器的单元测试通过适配器目录下的test.mk https://www.gnu.org/software/make/manual/html_node/Include.html%E6%9D%A5%E5%8F%91%E7%8E%B0%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%9A

Makefile
# voltha/adapters/my_new_adapter/test.mk

.PHONY test
test:
   @echo "Testing my amazing new adapter"
   @./my_test_harness

Voltha的测试框架将执行子make文件中的第一个目标作为单元测试函数。它可以包含所需的多个依赖项，例如使用不同的Python测试框架（pytest、unittest、tox）甚至其他语言（go、rust、php）。

为了使适配器的测试覆盖率被报告，请确保测试工具生成https://www.ibm.com/support/knowledgecenter/en/SSUFAU_1.0.0/com.ibm.rsar.analysis.codereview.cobol.doc/topics/cac_useresults_junit.html%E6%A0%BC%E5%BC%8F%E7%9A%84%E8%A6%86%E7%9B%96%E7%8E%87%E6%8A%A5%E5%91%8A%E3%80%82%E5%A4%A7%E5%A4%9A%E6%95%B0%E6%B5%8B%E8%AF%95%E5%B7%A5%E5%85%B7%E5%8F%AF%E4%BB%A5%E8%BD%BB%E6%9D%BE%E7%94%9F%E6%88%90%E6%AD%A4%E6%8A%A5%E5%91%8A%E6%A0%BC%E5%BC%8F%E3%80%82%E5%A6%82%E6%9E%9C%E6%8C%89%E7%85%A7Jenkins%E9%85%8D%E7%BD%AE%E5%B0%86%E6%8A%A5%E5%91%8A%E6%96%87%E4%BB%B6%E5%91%BD%E5%90%8D%E4%B8%BA**junit-report.xml**%EF%BC%8CJenkins Job将拾取您的覆盖率报告。