voltha/bbsim

BBSim Docker镜像文档

镜像概述

BBSim（Broadband Simulator）是针对VOLTHA（Virtual Optical Line Terminal Hardware Abstraction）的控制平面模拟器，新版本在原有基础上优化了性能与兼容性。该镜像提供轻量级VOLTHA控制平面模拟环境，可模拟VOLTHA网络中的控制平面交互，支持网络功能测试、协议验证及相关开发工作。

核心功能与特性

• VOLTHA控制平面模拟：精确模拟VOLTHA环境中的控制平面协议与交互流程，包括ONU/OLT等设备的控制平面行为。
• 多设备模拟支持：可配置模拟设备数量、类型及参数，支持复杂网络拓扑下的多设备并发模拟。
• 测试与开发适配：提供标准化接口，便于与VOLTHA核心组件或第三方测试工具集成，加速功能验证与问题定位。
• 兼容性优化：新版本增强了与主流VOLTHA版本的兼容性，适配控制平面协议更新。
• 轻量级部署：基于Docker容器化设计，简化环境配置，降低依赖管理复杂度。

使用场景与适用范围

• VOLTHA控制平面开发：辅助开发人员在本地模拟VOLTHA控制平面，无需真实硬件即可进行功能调试。
• 网络协议验证：验证VOLTHA控制平面协议（如OpenFlow、gRPC）的正确性与稳定性。
• VOLTHA环境测试：在部署前模拟控制平面负载，评估系统性能与稳定性。
• 教育与研究：用于VOLTHA网络架构学习及宽带接入网络控制平面机制研究。

使用方法与配置说明

前提条件

• 已安装Docker Engine（推荐20.10+版本）
• （可选）Docker Compose（用于多组件协同部署）
• 目标VOLTHA环境或测试平台访问权限（如需交互）

基本使用（Docker Run）

启动BBSim容器的基础命令：

bash
docker run -d --name bbsim \
  -p 50051:50051 \  # GRPC服务端口
  -e BBSIM_DEVICE_COUNT=10 \  # 模拟设备数量
  -e BBSIM_VOLTHA_ADDR=voltha-service:50055 \  # 目标VOLTHA服务地址
  -e LOG_LEVEL=info \  # 日志级别：debug/info/warn/error
  voltha/bbsim:latest  # 新版本镜像标签

环境变量配置

常用配置参数如下：

Docker Compose配置示例

与VOLTHA核心组件协同部署示例：

yaml
version: '3'
services:
  bbsim:
    image: voltha/bbsim:latest
    container_name: bbsim
    ports:
      - "50051:50051"
      - "8080:8080"
    environment:
      - BBSIM_DEVICE_COUNT=20
      - BBSIM_VOLTHA_ADDR=voltha-core:50055
      - LOG_LEVEL=debug
    depends_on:
      - voltha-core
  voltha-core:
    image: voltha/voltha-core:latest
    # VOLTHA核心服务配置（根据实际需求补充）

验证运行

容器启动后，通过日志验证状态：

bash
docker logs -f bbsim

若日志显示"Started BBSim successfully"等信息，表明模拟器已正常启动并开始控制平面模拟。

注意事项

• 确保BBSim版本与目标VOLTHA版本匹配，新版本可能需对应特定VOLTHA版本。
• 调整BBSIM_DEVICE_COUNT时注意宿主机资源，过多设备模拟可能增加CPU/内存占用。
• 生产环境测试建议使用隔离网络，避免影响实际业务。