opnfv/functest-vnf

OPNFV Functest VNF 镜像技术文档

1. 镜像概述和主要用途

OPNFV Functest VNF 镜像是基于 OPNFV（开放平台网络功能虚拟化）项目的 Functest 测试框架构建的专用容器镜像，旨在为虚拟网络功能（VNF）提供标准化的功能验证环境。该镜像集成了 Functest 框架的 VNF 测试套件、自动化测试工具及报告生成模块，可直接部署于容器化环境中，用于验证 VNF 的功能正确性、合规性及与 NFV 基础设施的兼容性。

2. 核心功能和特性

2.1 核心功能

• VNF 功能验证：支持对 VNF 关键功能（如路由、防火墙、负载均衡、SDN 控制器交互等）的自动化测试。
• 标准化测试用例：内置符合 ETSI NFV 规范及 OPNFV 测试计划的标准化测试用例集，覆盖 VNF 生命周期各阶段。
• 多场景兼容性测试：支持对不同厂商 VNF、NFV 基础设施（如 OpenStack、Kubernetes）的兼容性验证。
• 测试报告生成：自动生成结构化测试报告（HTML/JSON 格式），包含测试结果、日志及性能指标。

2.2 关键特性

• 轻量化容器化：基于 Alpine 或 Ubuntu 精简镜像构建，体积小、启动速度快，适合 CI/CD 流水线集成。
• 自动化测试流程：支持测试用例编排、依赖自动解析及结果自动汇总，减少人工干预。
• 可扩展测试框架：支持用户自定义测试用例（通过挂载外部测试脚本或配置文件）。
• 多环境适配：兼容 Docker、Kubernetes 等容器运行时，支持物理机/虚拟机/NFV 基础设施混合部署场景。

3. 使用场景和适用范围

3.1 目标用户

• VNF 开发商（验证产品功能合规性）；
• NFV 解决方案提供商（验证基础设施与 VNF 的兼容性）；
• 电信运营商（网络部署前 VNF 功能验收测试）；
• 第三方测试机构（执行标准化 VNF 认证测试）。

3.2 典型使用场景

• VNF 开发测试：在 VNF 迭代开发过程中，通过镜像快速执行功能回归测试，验证新特性或修复。
• NFV 基础设施兼容性验证：测试 VNF 在不同 NFV 基础设施（如基于 OpenStack 的云平台）上的功能一致性。
• 运营商网络部署验收：在 VNF 正式部署到运营商网络前，执行预定义测试套件，确保满足业务需求。
• 多厂商 VNF 互操作性测试：验证不同厂商 VNF 之间的协议交互（如 SDN 控制器与转发面 VNF 的通信）。

4. 使用方法和配置说明

4.1 镜像获取

镜像可通过 OPNFV 官方仓库或 Docker Hub 获取（需提前申请访问权限）：

bash
# 从 OPNFV 仓库拉取（示例）
docker pull opnfv/functest-vnf:latest

# 从 Docker Hub 拉取（若已同步）
docker pull docker.io/opnfv/functest-vnf:latest

4.2 基本使用命令

4.2.1 简单运行（默认测试套件）

bash
docker run -it --rm \
  --name functest-vnf \
  opnfv/functest-vnf:latest

默认执行基础 VNF 功能测试套件，测试报告生成于容器内 /opt/functest/reports 目录。

4.2.2 挂载本地目录保存测试报告

bash
docker run -it --rm \
  --name functest-vnf \
  -v /local/reports:/opt/functest/reports \  # 挂载本地目录保存报告
  opnfv/functest-vnf:latest

4.2.3 指定测试套件和目标 VNF

通过环境变量自定义测试参数：

bash
docker run -it --rm \
  --name functest-vnf \
  -v /local/reports:/opt/functest/reports \
  -e TEST_SUITE="advanced" \          # 指定高级测试套件
  -e TARGET_VNF="192.168.1.100" \     # 目标 VNF 的管理 IP
  -e LOG_LEVEL="DEBUG" \              # 日志级别（DEBUG/INFO/WARN/ERROR）
  opnfv/functest-vnf:latest

4.3 配置参数与环境变量

容器支持通过环境变量或配置文件（挂载 /opt/functest/config 目录）自定义测试行为，关键参数如下：

4.4 Docker Compose 部署示例

适用于需要与外部服务（如测试结果数据库）集成的场景，示例 docker-compose.yml：

yaml
version: '3'
services:
  functest-vnf:
    image: opnfv/functest-vnf:latest
    container_name: functest-vnf
    volumes:
      - ./local-reports:/opt/functest/reports  # 本地报告目录
      - ./custom-tests:/opt/functest/custom   # 挂载自定义测试用例
    environment:
      - TEST_SUITE=custom
      - TARGET_VNF=192.168.1.100
      - VNF_CREDENTIALS=admin:password123
      - LOG_LEVEL=DEBUG
      - DB_HOST=test-db  # 测试结果数据库地址（关联下方 db 服务）
    depends_on:
      - db

  db:
    image: postgres:14
    container_name: test-db
    environment:
      - POSTGRES_DB=functest
      - POSTGRES_USER=testuser
      - POSTGRES_PASSWORD=testpass
    volumes:
      - db-data:/var/lib/postgresql/data

volumes:
  db-data:

5. 集成与扩展

5.1 自定义测试用例

用户可通过挂载自定义测试脚本至容器 /opt/functest/custom 目录，并设置 TEST_SUITE=custom 启用。脚本需符合 Functest 测试用例规范（如 Python 脚本，继承 FunctestCase 基类）。

5.2 与 OPNFV 基础设施集成

若需与 OPNFV 控制器（如 OpenStack、Kubernetes）联动，需在运行容器时挂载基础设施认证配置文件（如 OpenStack clouds.yaml）：

bash
docker run -it --rm \
  -v /local/clouds.yaml:/opt/functest/config/clouds.yaml \
  -e OS_CLOUD=default \  # 指定 OpenStack 云环境名称
  opnfv/functest-vnf:latest

6. 注意事项

• 目标 VNF 需提前部署并确保网络可达（容器需与 VNF 管理网、数据网互通）；
• 测试报告默认保留 7 天，建议通过外部存储（如 NFS）长期保存；
• 高负载测试场景（如性能测试）需为容器分配足够资源（通过 --cpus、--memory 参数限制）；
• 镜像版本需与目标 VNF 支持的 Functest 版本匹配（参考 OPNFV 版本兼容性矩阵）。