opnfv/functest-smoke

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 官方镜像仓库拉取镜像：

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

4.2 容器运行（docker run）

4.2.1 基础运行命令

bash
docker run -it --rm \
  -e TARGET_IP=192.168.1.100 \  # 目标 NFV 环境控制节点 IP
  -e AUTH_URL=http://192.168.1.100:5000/v3 \  # 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 用例）：

bash
docker run -it --rm \
  -e TARGET_IP=192.168.1.100 \
  -e AUTH_URL=http://192.168.1.100:5000/v3 \
  -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 文件，定义测试服务：

yaml
version: '3'
services:
  functest-smoke:
    image: opnfv/functest-smoke:latest
    environment:
      - TARGET_IP=192.168.1.100
      - AUTH_URL=http://192.168.1.100:5000/v3
      - 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"  # 如需直接访问宿主机网络（如目标环境在本地）

启动服务：

bash
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 版本镜像）。