rhastie/nmos-cpp

AMWA NMOS 容器化注册器、浏览器客户端/控制器和节点

构建状态: https://github.com/rhastie/build-nmos-cpp/workflows/ci-build-test-publish/badge.svg?branch=master](https://github.com/rhastie/build-nmos-cpp/actions?query=workflow%3Aci-build-test-publish)

实现概述

本仓库包含创建AMWA网络媒体开放规范（NMOS）Docker容器实现所需的所有文件。有关AMWA、NMOS和网络媒体孵化器的更多信息，请参考[***]

本项目主要基于Sony的开源实现。详见：http://github.com/sony/nmos-cpp

生成的Docker容器经过专门优化，可在Mellanox交换机上运行，也可在其他多种平台上独立运行。详见2019年IBC IP Showcase的概述演示：

• 视频演示
• 幻灯片

具体而言，该实现支持以下规范：

• https://amwa-tv.github.io/nmos-discovery-registration%EF%BC%88%E6%94%AF%E6%8C%81v1.0-v1.3%EF%BC%89
• https://amwa-tv.github.io/nmos-device-connection-management%EF%BC%88%E6%94%AF%E6%8C%81v1.0-v1.1%EF%BC%89
• https://amwa-tv.github.io/nmos-event-tally%EF%BC%88%E6%94%AF%E6%8C%81v1.1%EF%BC%89
• https://amwa-tv.github.io/nmos-audio-channel-mapping%EF%BC%88%E6%94%AF%E6%8C%81v1.0%EF%BC%89
• https://amwa-tv.github.io/nmos-system%EF%BC%88%E6%9C%80%E5%88%9D%E5%AE%9A%E4%B9%89%E4%BA%8EJT-NM TR-1001-1:2018附录A）（支持v1.0）
• https://amwa-tv.github.io/nmos-grouping - 自然分组
• https://amwa-tv.github.io/nmos-api-security - 通信安全

此外，它还支持以下附加组件：

• 在Mellanox交换机上运行时，支持自动识别交换机边界时钟PTP域，并通过AMWA IS-09系统资源发布
• 支持嵌入式NMOS浏览器客户端/控制器，支持使用AMWA IS-05进行NMOS控制，同时支持AMWA IS-08（当前仅查看功能）
• 支持嵌入式MQTT Broker（mosquitto），简化AMWA IS-05和IS-07的NMOS MQTT传输类型使用
• 支持DNS-SD到HTML的桥接实现，同时支持mDNS和DNS-SD

nmos-cpp容器包含NMOS节点、注册和查询API以及NMOS连接API的实现。还包含JavaScript编写的NMOS浏览器客户端/控制器、MQTT Broker和DNS-SD API，这些不属于规范内容。

容器测试、支持的架构和发布说明

JT-NM测试认证

[]([][]([]

NVIDIA NMOS Docker容器已通过JT-NM对注册器和控制器的严格测试要求。该容器在使用Onyx Docker子系统的Mellanox Spectrum/Spectrum-2交换机上运行时进行了测试。可访问JT-NM测试矩阵。

此外，该容器已在AMWA网络媒体孵化器研讨会中成功测试。

测试平台和支持的CPU架构

本仓库中的Dockerfile设计为可在Docker Experimental BuildX CLI功能集下运行（如需要）。容器针对以下CPU架构发布：

• Intel和AMD x86_64 64位架构
• ARMv8 AArch64（64位ARM架构）
• ARMv7 AArch32（32位ARM架构）

容器已在以下平台上测试兼容性：

• Mellanox SN2000、SN3000和SN4000系列交换机
• Mellanox Bluefield系列SmartNIC（在SmartNIC ARM核心上原生运行）
• NVIDIA Jetson AGX Xavier开发套件（尽管未全面测试，但容器应在所有NVIDIA AGX平台上运行）
• 树莓派RPi 3 Model B和RPi 4 Model B（已测试Raspbian标准32位和新实验性64位内核）
• 运行Ubuntu Linux和Windows的标准Intel和AMD服务器 - 已测试裸机和虚拟化环境

持续集成（CI）测试

与NMOS规范一样，NVIDIA NMOS容器旨在随时可用且持续开发。为减少开发开销并持续验证容器状态，现在通过GitHub Actions进行CI测试。此CI测试旨在作为容器功能的基本检查，而非nmos-cpp功能的全面测试。有关nmos-cpp的深入测试，请参见https://github.com/sony/nmos-cpp/blob/master/README.md#build-status%E3%80%82

以下配置由ci-build-test-publish作业定义，通过持续集成自动构建和单元测试。如果测试成功完成，容器将直接发布到Docker Hub，并作为工件保存到GitHub Action作业中。未来可能会添加其他配置。

https://github.com/AMWA-TV/nmos-testing%E4%BC%9A%E8%87%AA%E5%8A%A8%E5%AF%B9%E5%9C%A8%22nmos-node%22%E5%92%8C%22nmos-registry%22%E9%85%8D%E7%BD%AE%E4%B8%8B%E8%BF%90%E8%A1%8C%E7%9A%84%E5%B7%B2%E6%9E%84%E5%BB%BA**NMOS%E5%AE%B9%E5%99%A8**%E8%BF%9B%E8%A1%8C%E6%B5%8B%E8%AF%95%E3%80%82

测试套件结果/状态:

发布说明和版本控制

尽管NVIDIA NMOS Docker容器持续开发，我们仍努力在各个重要节点提供软件包。https://hub.docker.com/r/rhastie/nmos-cpp/tags?page=1&ordering=last_updated%E5%A7%8B%E7%BB%88%E6%8F%90%E4%BE%9B%E5%90%84%E7%A7%8D%E6%A0%87%E7%AD%BE%E5%88%97%E8%A1%A8%EF%BC%8C%E5%90%AB%E4%B9%89%E5%A6%82%E4%B8%8B%EF%BC%9A

• latest - 始终映射到容器的最新正式发布版本
• 1.XY-CCCCCCC - 其中X是数字，Y是字母，C是nmos-cpp提交引用 - 多架构正式发布版本，经测试后发布。这些版本将在Docker Hub允许的范围内保留
• dev-CCCCCCC - 其中C是nmos-cpp提交引用 - 非多架构开发分支测试版本 - 不应依赖此版本，可能会无通知删除
• master-CCCCCCC - 其中C是nmos-cpp提交引用 - 非多架构主分支测试版本 - 不应依赖此版本，可能会无通知删除
• 0.1X - 其中X是字母 - 容器正式发布前的旧版本

除Docker Hub外，我们还在GitHub上维护一组对齐的发布包 - https://github.com/rhastie/build-nmos-cpp/releases

对于容器的正式发布版本，可参考https://github.com/rhastie/build-nmos-cpp/blob/master/Release-Notes.md%E6%96%87%E6%A1%A3%E4%BA%86%E8%A7%A3%E5%8F%98%E6%9B%B4%E5%86%85%E5%AE%B9%E3%80%82

如何安装和运行容器NMOS注册器/控制器

在运行Onyx NOS的Mellanox交换机上

前提条件：

• 至少运行Onyx版本3.8.2000+
• 在交换机上设置准确的日期和时间 - 使用PTP、NTP或通过"clock set"命令手动设置
• 为要公开容器的所有VLAN创建"interface vlans"

执行以下交换机命令在交换机上下载并运行容器：

• 以管理员身份登录交换机CLI
• "docker" - 启用交换机上的Docker子系统（确保使用"exit"退出docker菜单树）
• "docker no shutdown" - 激活交换机上的Docker
• "docker pull rhastie/nmos-cpp:latest" - 从Docker Hub拉取Docker容器的最新版本
• "docker start rhastie/nmos-cpp latest nmos now privileged network" - 立即启动Docker容器
• "docker no start nmos" - 停止Docker容器

附加/可选步骤：

在Mellanox交换机上，容器使用的DNS配置继承自交换机配置

• 如需为容器配置DNS服务器，可使用"ip name-server"交换机命令指定DNS服务器。默认情况下，容器将使用DHCP提供的任何DNS服务器
• 如需为容器配置DNS搜索域，可使用"ip domain-list"交换机命令指定DNS搜索域。默认情况下，容器将使用DHCP提供的任何DNS搜索域。如未配置，默认使用".local"（即mDNS）
• 如需了解当前DNS配置，使用交换机命令"show hosts"

在Mellanox Bluefield SmartNIC上

前提条件：

• 通常建议使用基于Ubuntu 20.04+的BFB（Bluefield启动流）镜像，因为它包含所有必要的驱动程序和操作系统作为单个捆绑包。参见下载页面
• 拥有准确的日期和时间
• 确保SmartNIC Ubuntu OS可进行外部连接和名称解析 - 有多种方法可实现。请查看Bluefield文档
• Mellanox BFB镜像通常提供Docker，如不可用，使用[说明]([***]