Stratum 开源项目安装与使用指南

1. 项目目录结构及介绍

Stratum项目位于GitHub上，仓库地址为：https://github.com/stratum/stratum.git。这个项目旨在提供一个开放的平台来实现软件定义的转发设备（如交换机），它基于开放网络基金会（ONF）的Stratum架构设计。

主要目录介绍：

• stratum/hal: 包含硬件抽象层(HAL)的相关代码，用于与不同类型的物理或虚拟交换机通信。
• stratum/lib: 提供基本的库支持和服务，包括通用功能和数据结构。
• stratum/bmv2: 是一个特定于BMV2虚拟交换机的实现，BMV2是P4Runtime的一个常见目标。
• stratum switchd: 这是主要的服务进程，运行在转发节点上，管理转发逻辑。
• stratum/switchinterface: 定义了与上层应用接口的标准。
• p4runtime: 相关的P4Runtime客户端和支持文件，用于管理交换机的配置。
• bazel: 构建系统相关文件，用于编译和管理依赖。

2. 项目的启动文件介绍

Stratum项目的启动主要通过其服务脚本或Bazel构建系统来执行。关键的启动流程通常涉及以下步骤：

• 主服务 (stratum_switch) 的启动脚本通常不直接暴露给最终用户，而是通过Bazel构建后的可执行文件直接调用，或者在某些部署方案中，可能会有专门的启动脚本处理依赖注入、环境变量设置等。

• 使用Bazel构建：首先需要构建项目，命令一般为 bazel build //stratum/switchd:switchd 来编译出switchd服务程序。

• 启动服务：构建完成后，可以通过类似 ./bazel-bin/stratum/switchd/switchd --config_file=/path/to/config.pbtxt 的命令来启动服务，其中--config_file参数指定配置文件路径。

3. 项目的配置文件介绍

配置文件是Stratum项目运行的核心部分，它指导着switchd如何连接到硬件以及它的运行时行为。典型的配置文件通常是 Protocol Buffers (.pbtxt) 格式，例子如下：

• config.pbtxt 示例文件包含多个部分，如node_config, bootstrap_config, 和其他特定于HAL的配置。

• Node Config: 定义了节点的基本属性，包括节点ID、名称以及它连接的硬件类型。

• Bootstrap Config: 指定如何加载Stratum守护进程的配置，包括gRPC服务端点和可能的日志配置。

• HAL Config: 根据不同的 HAL，如gNOI或P4Runtime，会有相应的配置来指定通信方式和细节。

要创建或修改配置文件，需参照项目提供的样本或文档，确保正确设置了所有必要的字段以符合你的部署需求。

---

以上是对Stratum项目的关键结构、启动流程及其配置文件的简要介绍。具体实施时，强烈建议参考项目最新的官方文档和示例，因为开源项目的内容更新频繁，细节可能会有所变化。