OPNFV Functest Smoke 镜像技术文档

1. 镜像概述和主要用途

OPNFV Functest Smoke 镜像是基于 OPNFV Functest 测试框架构建的轻量级 Docker 镜像，旨在为 NFV（网络功能虚拟化）基础设施提供快速、自动化的基础功能验证能力。该镜像封装了 Functest 测试套件中的 "smoke" 测试用例集，专注于验证 NFV 环境的核心组件（如计算、网络、存储资源及基础 VNF 部署能力）是否正常工作，可作为 NFV 环境部署、升级或配置变更后的首道功能验证工具。

2. 核心功能和特性

2.1 核心功能

• 基础设施基础验证：检测 NFV 环境计算节点资源（CPU、内存、存储）可用性及分配能力。
• 网络功能测试：验证基础网络连通性（如 VLAN、VXLAN 隧道）、DHCP 服务、跨节点通信等核心网络功能。
• VNF 部署基础验证：测试简单 VNF（如虚拟路由器、负载均衡器）的实例化、启动及基本运行状态。
• 测试报告生成：自动输出结构化测试报告（支持 JSON/XML 格式），包含测试用例执行结果、耗时及故障详情。

2.2 主要特性

• 轻量级设计：镜像体积小，依赖精简，可快速拉取和启动。
• 快速执行：smoke 测试用例集聚焦核心功能，单轮测试耗时通常在 5-15 分钟。
• 环境兼容性：支持 OPNFV 主流版本（如 Euphrates、Fraser、Gambia）及基于 OpenStack 的 NFV 环境。
• 配置灵活：通过环境变量或配置文件自定义测试目标、用例集及报告输出方式。

3. 使用场景和适用范围

3.1 典型使用场景

• NFV 环境新部署后验证：在 OPNFV 或基于 OpenStack 的 NFV 基础设施首次部署完成后，快速验证核心功能是否正常。
• 版本升级/配置变更后验证：环境升级或关键配置（如网络策略、资源配额）变更后，确认基础功能未受影响。
• CI/CD 流程集成：作为 NFV 环境自动化部署流程（如通过 Ansible、Kubernetes 管理）的后置测试环节，实现部署-测试一体化。
• 故障排查辅助：当 NFV 环境出现功能异常时，通过 smoke 测试定位基础组件（如计算节点、网络插件）是否存在问题。

3.2 适用范围

• 基于 OpenStack 的 NFV 基础设施（如 OPNFV 官方部署环境、运营商定制 NFV 平台）。
• 虚拟化环境（KVM、VMware 等）及容器化 NFV 环境（轻量级 VNF 场景）。
• 开发/测试环境及生产环境的预验证环节（非生产流量直接承载场景）。

4. 使用方法和配置说明

4.1 镜像获取

通过 Docker Hub 或 OPNFV 官方镜像仓库拉取镜像：

docker pull opnfv/functest-smoke:latest  # 最新版本
# 或指定版本（如针对 OPNFV Gambia 版本）
docker pull opnfv/functest-smoke:gambia.1.0

4.2 容器运行（docker run）

4.2.1 基础运行命令

docker run -it --rm \
  -e TARGET_IP=192.168.1.100 \  # 目标 NFV 环境控制节点 IP
  -e AUTH_URL=[***] \  # OpenStack Keystone 认证 URL
  -e USERNAME=admin \  # 目标环境管理员用户名
  -e PASSWORD=opnfv_password \  # 管理员密码
  -e PROJECT_NAME=admin \  # 项目名称
  -v /local/report:/opt/functest/report \  # 挂载本地目录存储测试报告
  opnfv/functest-smoke:latest

4.2.2 自定义测试用例

通过 TEST_CASES 环境变量指定需执行的测试用例（默认执行全部 smoke 用例）：

docker run -it --rm \
  -e TARGET_IP=192.168.1.100 \
  -e AUTH_URL=[***] \
  -e USERNAME=admin \
  -e PASSWORD=opnfv_password \
  -e TEST_CASES="compute-basic,network-ping,vnf-router" \  # 仅执行计算基础、网络连通、VNF 路由器测试
  -v /local/report:/opt/functest/report \
  opnfv/functest-smoke:latest

4.3 docker-compose 配置示例

创建 docker-compose.yml 文件，定义测试服务：

version: '3'
services:
  functest-smoke:
    image: opnfv/functest-smoke:latest
    environment:
      - TARGET_IP=192.168.1.100
      - AUTH_URL=[***]
      - USERNAME=admin
      - PASSWORD=opnfv_password
      - PROJECT_NAME=admin
      - DOMAIN_NAME=default  # Keystone 域名称（默认 default）
      - REPORT_FORMAT=json  # 报告格式：json/xml/html（默认 json）
      - LOG_LEVEL=INFO  # 日志级别：DEBUG/INFO/WARNING/ERROR（默认 INFO）
    volumes:
      - ./report:/opt/functest/report  # 本地报告目录挂载
    network_mode: "host"  # 如需直接访问宿主机网络（如目标环境在本地）

启动服务：

docker-compose up

5. 配置参数说明

5.1 核心环境变量

5.2 测试报告输出

测试执行完成后，报告默认存储于容器内 ${REPORT_PATH} 目录（需通过 -v 挂载至本地目录以持久化）。报告文件命名格式为 functest-smoke-<timestamp>.<format>（如 functest-smoke-202405201530.json），包含测试用例名称、状态（PASS/FAIL）、耗时、详细日志等信息。

6. 注意事项

• 目标 NFV 环境需提前开放必要端口（如 Keystone 5000、Nova 8774、Neutron 9696 等），确保容器可访问。
• 执行测试时需确保目标环境有足够的计算资源（至少 2 vCPU、4GB 内存、10GB 存储）用于临时 VNF 实例化。
• 生产环境使用时建议限制测试范围（通过 TEST_CASES），避免影响业务流量。
• 镜像版本需与目标 OPNFV 环境版本匹配（如 OPNFV Gambia 环境对应使用 gambia.x 版本镜像）。