opennetworking/mn-stratum

Stratum-enabled Mininet

镜像概述和主要用途

能够运行Mininet仿真网络的Docker镜像，默认使用stratum_bmv2作为交换机。该镜像适用于网络功能测试、SDN（软件定义网络）控制器开发及网络拓扑仿真场景。

获取镜像

可通过Docker Hub获取该镜像：

bash
docker pull opennetworking/mn-stratum

此镜像每日更新，基于Stratum项目的master分支构建。

运行容器

基本运行命令

运行容器的基本命令如下：

bash
docker run --privileged --rm -it opennetworking/mn-stratum [MININET参数]

执行后将进入Mininet命令行界面（mininet>）。

注意：必须使用--privileged模式，以便Mininet能够修改网络接口和属性，从而仿真所需拓扑。

镜像的入口点已配置为使用stratum_bmv2作为默认交换机的Mininet可执行文件。docker run命令中的[MININET参数]将直接传递给Mininet进程。有关支持的Mininet选项详情，请参考官方Mininet文档。

示例：运行包含3个交换机的线性拓扑：

bash
docker run --privileged --rm -it opennetworking/mn-stratum --topo linear,3

gRPC服务器端口

每个交换机绑定不同的gRPC端口，从50001开始递增。要将外部客户端（如SDN控制器）连接到交换机，需发布对应端口。

示例：运行包含3个交换机的拓扑时发布端口：

bash
docker run --privileged --rm -it -p 50001-50003:50001-50003 opennetworking/mn-stratum --topo linear,3

日志和临时文件

为便于访问日志和其他文件，建议使用-v选项将容器内的/tmp目录挂载到宿主机：

bash
docker run ... -v /tmp/mn-stratum:/tmp ... opennetworking/mn-stratum ...

容器运行期间，与stratum_bmv2执行相关的文件将保存在宿主机的/tmp/mn-stratum目录下，文件按Mininet中的交换机名称（如s1、s2等）组织。主要文件包括：

• s1/stratum_bmv2.log：交换机s1的stratum_bmv2日志
• s1/chassis-config.txt：交换机启动时使用的底盘配置文件
• s1/grpc-port.txt：该交换机关联的gRPC端口
• s1/onos-netcfg.json：连接交换机到ONOS SDN控制器的示例配置文件

Bash别名

为快速启动容器，可在bash配置文件（如.bashrc、.bash_aliases或.bash_profile）中创建别名。例如：

bash
alias mn-stratum="rm -rf /tmp/mn-stratum && docker run --privileged --rm -it -v /tmp/mn-stratum:/tmp -p50001-50030:50001-50030 --name mn-stratum --hostname mn-stratum opennetworking/mn-stratum"

使用示例：

• 运行包含1个交换机和2个主机的简单拓扑：

  bash
  $ mn-stratum
   Creating network
   Adding controller
   Adding hosts:
  h1 h2
   Adding switches:
  s1
   Adding links:
  (h1, s1) (h2, s1)
   Configuring hosts
  h1 h2
   Starting controller
  
   Starting 1 switches
  s1 ....⚡️ stratum_bmv2 @ 50001
  
   Starting CLI:
  mininet>
  

• 运行包含3个交换机和3个主机的线性拓扑：

  bash
  $ mn-stratum --topo linear,3
   Creating network
   Adding controller
   Adding hosts:
  h1 h2 h3
   Adding switches:
  s1 s2 s3
   Adding links:
  (h1, s1) (h2, s2) (h3, s3) (s2, s1) (s3, s2)
   Configuring hosts
  h1 h2 h3
   Starting controller
  
   Starting 3 switches
  s1 .....⚡️ stratum_bmv2 @ 50001
  s2 .....⚡️ stratum_bmv2 @ 50002
  s3 .....⚡️ stratum_bmv2 @ 50003
  
   Starting CLI:
  mininet>