opnfv/functest-benchmarking

OPNFV Functest Benchmarking镜像文档

镜像概述

OPNFV Functest Benchmarking镜像是基于OPNFV（开放平台网络功能虚拟化）项目中的Functest组件构建的专用测试工具镜像。该镜像集成了Functest测试框架及相关基准测试工具，旨在为NFV（网络功能虚拟化）环境提供标准化、自动化的功能验证与性能评估能力，支持对NFV基础设施（如计算、存储、网络资源）及上层网络功能（VNF/CNF）的测试验证。

核心功能与特性

• 标准化测试框架：基于OPNFV Functest项目规范，提供统一的测试执行与管理框架，兼容OPNFV认证测试用例。
• 多类型测试支持：
  • 功能测试：验证NFV基础设施及网络功能的基础功能正确性，如虚拟机生命周期管理、网络连通性、服务链转发等。
  • 基准测试：评估NFV环境性能指标，包括计算资源（CPU/内存利用率）、网络性能（吞吐量、时延、抖动）、存储I/O性能等。
• 兼容性验证：支持与主流NFV架构（如OpenStack、Kubernetes）及网络功能（VNF/CNF）的兼容性测试。
• 自动化测试流程：内置测试用例调度与执行逻辑，支持批量测试任务自动化运行，减少人工干预。
• 测试报告生成：提供结构化测试报告，包含测试结果、性能指标数据及可视化分析，便于问题定位与性能优化。

使用场景与适用范围

• NFV基础设施部署验证：在NFV平台（如基于OpenStack/Kubernetes的NFV基础设施）部署完成后，通过该镜像执行功能测试，验证基础设施功能完整性。
• 网络功能性能评估：针对虚拟网络功能（VNF）或云原生网络功能（CNF），执行基准测试以评估其在不同负载下的性能表现（如吞吐量、时延）。
• 持续集成/持续部署（CI/CD）测试：集成至NFV平台或网络功能的CI/CD流程，在代码提交或版本更新后自动触发测试，确保功能稳定性与性能一致性。
• NFV合规性认证：作为OPNFV认证测试工具，支持厂商或用户验证其NFV解决方案是否符合OPNFV技术规范。

使用方法与配置说明

基本使用方式

通过docker run命令启动容器并执行测试任务，基础命令格式如下：

bash
docker run -it --rm \
  -v /path/to/test/config:/etc/functest/config \  # 挂载测试配置文件（可选）
  -e TEST_TYPE=<test_type> \                      # 指定测试类型（功能测试/基准测试）
  -e TARGET_ENV=<env_address> \                   # 目标NFV环境地址（如OpenStack Keystone地址）
  opnfv/functest-benchmarking:<tag> \             # 镜像名称及标签
  functest run <test_suite>                       # 执行测试命令（指定测试套件）

环境变量配置

容器支持通过环境变量自定义测试行为，常用配置如下：

测试执行示例

1. 执行NFV基础设施冒烟测试
   验证NFV环境基础功能（如虚拟机创建、网络连通性）：

   bash
   docker run -it --rm \
     -e TARGET_ENV="http://opnfv-controller:5000/v3" \
     -e TEST_TYPE="functional" \
     -e TEST_SUITE="smoke" \
     -v /local/reports:/var/functest/reports \  # 持久化测试报告
     opnfv/functest-benchmarking:latest \
     functest run
   

2. 执行网络性能基准测试
   评估NFV网络吞吐量与时延：

   bash
   docker run -it --rm \
     -e TARGET_ENV="http://opnfv-controller:5000/v3" \
     -e TEST_TYPE="benchmark" \
     -e TEST_SUITE="performance" \
     -e LOG_LEVEL="DEBUG" \
     opnfv/functest-benchmarking:latest \
     functest run performance-network
   

测试报告查看

测试执行完成后，报告默认生成在容器内/var/functest/reports路径下（或通过REPORT_PATH指定路径）。通过挂载本地目录（如示例中的-v /local/reports:/var/functest/reports），可在宿主机/local/reports目录下获取HTML或JSON格式的测试报告，包含测试用例执行结果、性能指标数据及异常详情。

注意事项

• 目标NFV环境需提前配置好访问权限（如OpenStack的认证凭证），可通过环境变量或配置文件传入认证信息。
• 基准测试可能消耗较多系统资源，建议在非生产环境或低负载时段执行。
• 镜像标签建议使用与目标OPNFV版本匹配的标签（如euphrates、fraser等OPNFV版本代号），确保测试兼容性。