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;  #  执行带覆盖率报告的单元测试

核心单元测试

核心的新单元测试可以用nosetest框架编写，位于/tests/utest/目录下。

适配器单元测试

每个适配器的单元测试通过适配器目录下的test.mk 子make文件来发现。例如：

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）。

为了使适配器的测试覆盖率被报告，请确保测试工具生成junit xml格式的覆盖率报告。大多数测试工具可以轻松生成此报告格式。如果按照Jenkins配置将报告文件命名为junit-report.xml，Jenkins Job将拾取您的覆盖率报告。