opnfv/functest-core

OPNFV Functest 核心镜像文档

1. 镜像概述

OPNFV Functest 核心镜像是OPNFV（开放平台网络功能虚拟化）项目的官方测试镜像，专注于为网络功能虚拟化(NFV)环境提供标准化的功能测试能力。该镜像集成了Functest测试框架的核心组件，支持对NFV基础设施（如VIM，虚拟化基础设施管理器）及虚拟网络功能(VNF)进行自动化测试，确保NFV平台的功能正确性、兼容性及可靠性。

2. 核心功能与特性

2.1 测试能力覆盖

• 多类型测试支持：涵盖NFV基础设施(VIM)测试（如OpenStack、Kubernetes等）、虚拟网络功能(VNF)测试、端到端(E2E)服务链测试等。
• 标准化测试套件：集成OPNFV Functest官方测试套件，包括Tempest（OpenStack API测试）、PingTest（连通性测试）、vIMS测试等。

2.2 自动化与集成

• 自动化测试流程：支持测试用例自动编排、执行及结果收集，减少人工干预。
• CI/CD集成：可无缝接入持续集成/持续部署(CI/CD)流水线，实现NFV平台迭代过程中的自动化测试验证。

2.3 兼容性与可扩展性

• 多平台兼容：适配主流NFV基础设施环境（OpenStack、Kubernetes、OpenVIM等）。
• 测试用例扩展：支持用户自定义测试用例集成，满足特定场景测试需求。

2.4 结果与报告

• 测试结果标准化：生成符合OPNFV规范的测试报告，包含通过率、详细日志及问题定位信息。
• 报告导出：支持JSON、HTML等多种格式报告导出，便于结果分析与归档。

3. 使用场景与适用范围

3.1 目标用户

• NFV平台开发者：验证新功能或代码变更对NFV基础设施的影响。
• 测试工程师：执行NFV环境功能验证、兼容性测试及回归测试。
• 运维人员：评估NFV平台部署后的功能完整性与稳定性。

3.2 典型场景

• NFV平台功能验证：在OpenStack/Kubernetes等VIM部署完成后，通过该镜像执行基础功能测试（如实例创建、网络连通性等）。
• VNF验收测试：对第三方VNF进行功能合规性验证，确保其符合ETSI NFV规范。
• CI/CD自动化测试：在OPNFV或自定义NFV项目的CI流程中，作为测试环节自动执行，确保代码提交质量。

4. 使用方法与配置说明

4.1 镜像获取

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

bash
docker pull opnfv/functest-core:latest

4.2 基本运行命令

bash
docker run -it --rm \
  -e TARGET_VIM=openstack \  # 目标VIM类型，支持openstack/kubernetes等
  -e VIM_AUTH_URL=http://<vim-ip>:5000/v3 \  # VIM认证地址
  -e VIM_USERNAME=<username> \  # VIM认证用户名
  -e VIM_PASSWORD=<password> \  # VIM认证密码
  -e VIM_TENANT_NAME=<tenant> \  # 项目/租户名称
  opnfv/functest-core:latest \
  functest run  # 执行默认测试套件

4.3 关键环境变量配置

4.4 测试执行与结果查看

1. 执行指定测试套件：

   bash
   docker run -it --rm [环境变量] opnfv/functest-core:latest functest run --suite tempest  # 仅执行Tempest测试
   

2. 查看测试结果： 测试执行完成后，默认在容器内/var/functest/results目录生成报告文件，可通过挂载目录持久化保存：

   bash
   docker run -it --rm -v $(pwd)/results:/var/functest/results [环境变量] opnfv/functest-core:latest functest run
   

   本地results目录下将生成测试报告文件。

5. 注意事项

• 确保目标NFV环境（VIM/VNF）已正确部署并可访问，网络连通性需满足测试要求。
• 敏感信息（如认证密码）建议通过环境变量注入，避免硬编码在命令中。
• 大规模测试场景下，建议为容器分配足够的CPU/内存资源（推荐4核8G以上）。