OSM Docker镜像技术文档

一、镜像概述和主要用途

本镜像基于ETSI（欧洲电信标准协会）开源项目OSM（Open Source Mano）构建，提供网络功能虚拟化（NFV）管理与编排（MANO）能力。主要用途包括：

• 实现NFV环境中的网络服务（NS）编排与生命周期管理
• 管理虚拟网络功能（VNF）的部署、配置与运维
• 对接NFV基础设施（NFVI），协调计算、存储与网络资源
• 提供标准化的NFV管理接口，支持电信网络云化转型

二、核心功能和特性

2.1 核心功能

• 网络服务编排：支持基于TOSCA/ETSI标准的网络服务模板（NSD）解析与实例化，实现服务的部署、升级、扩容与终止
• VNF生命周期管理：覆盖VNF的 onboard、实例化、配置、监控、故障恢复及退役全流程
• 多租户隔离：通过租户管理机制实现资源与服务的逻辑隔离，满足多运营商或部门共享平台需求
• NFVI资源协调：对接OpenStack、Kubernetes等NFVI平台，动态分配计算、存储与网络资源

2.2 关键特性

• 符合ETSI NFV ISG规范，兼容MANO架构标准
• 提供REST API与CLI管理接口，支持自动化集成
• 内置监控与告警模块，实时跟踪服务与资源状态
• 轻量级容器化部署，支持单机测试与集群化生产环境

三、使用场景和适用范围

3.1 典型使用场景

• 电信运营商NFV部署：用于5G核心网、IP承载网等网络功能的云化管理
• 云服务提供商网络管理：为客户提供定制化网络服务编排能力
• 企业私有云网络自动化：简化企业数据中心内虚拟网络功能的部署与维护
• 科研与测试环境：作为NFV技术验证、标准兼容性测试的基础平台

3.2 适用范围

• 需构建NFV MANO系统的电信运营商、云服务商及大型企业
• 基于ETSI NFV标准进行网络云化转型的组织
• 开展NFV技术研究或教学的机构

四、使用方法和配置说明

4.1 前置要求

• Docker Engine 20.10+ 或 Kubernetes环境
• 至少4核CPU、8GB内存、50GB磁盘空间（生产环境建议8核16GB以上）
• 网络需开放80/443（API）、5672（消息队列）等端口（具体端口依赖部署模式）

4.2 Docker Run部署示例

# 基础运行命令（单节点测试环境）
docker run -d \
  --name osm-core \
  --network host \
  -e OSM_DB_HOST=db.example.com \
  -e OSM_DB_USER=osmuser \
  -e OSM_DB_PASSWORD=osmpassword \
  -v /osm/data:/var/lib/osm \
  etsifoundation/osm:latest

4.3 Docker Compose配置示例

version: '3.8'
services:
  osm:
    image: etsifoundation/osm:latest
    container_name: osm-core
    network_mode: host
    environment:
      - OSM_DB_HOST=db
      - OSM_DB_USER=osmuser
      - OSM_DB_PASSWORD=osmpassword
      - OSM_LOG_LEVEL=INFO
    volumes:
      - osm_data:/var/lib/osm
    depends_on:
      - db

  db:
    image: postgres:13
    container_name: osm-db
    environment:
      - POSTGRES_USER=osmuser
      - POSTGRES_PASSWORD=osmpassword
      - POSTGRES_DB=osm
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  osm_data:
  postgres_data:

4.4 环境变量说明

4.5 配置参数

配置文件路径：容器内 /etc/osm/osm.conf，可通过宿主机挂载自定义配置：

docker run -v /path/to/custom/osm.conf:/etc/osm/osm.conf ...

核心配置项包括：

• nfvi_connection：NFVI平台连接信息（如OpenStack认证URL、租户名）
• service_lifetime：默认网络服务生命周期（单位：小时）
• monitoring_interval：资源监控采样间隔（单位：秒）

五、许可证信息

5.1 OSM软件许可证

本镜像包含的OSM软件许可证信息详见：OSM License

5.2 第三方软件许可证

本镜像基于基础操作系统（如Ubuntu）构建，可能包含Bash、Python等第三方软件，其许可证由对应基础镜像及依赖包定义。

5.3 用户责任

使用本镜像时，用户需自行确保对镜像内所有软件的使用符合其 respective 许可证要求。

六、参考链接

• OSM项目代码库：[***]
• 贡献指南：OSM Developer Workflow
• 官方文档：OSM Documentation