opnfv/functest-kubernetes-core

OPNFV Functest Kubernetes 核心镜像文档

1. 镜像概述

OPNFV Functest Kubernetes核心镜像是OPNFV（开放平台网络功能虚拟化）项目官方提供的Docker镜像，专门针对Kubernetes集群的核心功能测试场景设计。该镜像集成了Functest测试框架及Kubernetes专用测试套件，可用于验证Kubernetes集群的基础功能、组件兼容性及运行可靠性，是Kubernetes部署验证与持续测试的关键工具。

2. 核心功能与特性

2.1 核心功能

• Kubernetes基础组件测试：支持验证Kubernetes核心组件（API Server、etcd、Scheduler、Controller Manager等）的功能正确性。
• 标准测试套件集成：内置OPNFV Functest规范定义的Kubernetes测试套件，覆盖集群健康检查、服务可用性、网络功能等基础测试场景。
• 兼容性验证：支持主流Kubernetes版本（1.18+）的兼容性测试，确保集群符合行业标准。
• 测试结果标准化输出：生成符合OPNFV测试规范的结构化报告，包含测试用例执行状态、通过率及详细日志。

2.2 关键特性

• 轻量级设计，基于Alpine Linux构建，镜像体积小，启动速度快。
• 支持自定义测试参数，可通过环境变量配置测试范围、超时时间等。
• 兼容主流容器运行时（Docker、containerd）及Kubernetes集群部署方式（kubeadm、kube-spray等）。
• 定期更新，同步OPNFV Functest项目最新测试用例与规范。

3. 使用场景与适用范围

3.1 典型使用场景

• Kubernetes集群部署验证：新集群部署完成后，快速验证基础功能是否正常。
• 版本升级兼容性测试：Kubernetes集群版本升级前后，验证组件兼容性。
• CI/CD流程集成：嵌入持续集成/持续部署 pipeline，实现集群变更后的自动化测试。
• 第三方组件兼容性评估：测试网络插件（Calico、Flannel等）、存储插件等与Kubernetes的兼容性。

3.2 适用范围

• 开发/测试环境的Kubernetes集群功能验证。
• 生产环境部署前的预验证测试。
• 云平台Kubernetes服务（如EKS、AKS、GKE）的兼容性测试。

4. 使用方法与配置说明

4.1 基本使用（Docker Run）

bash
docker run -d \
  --name functest-k8s \
  -v /path/to/kubeconfig:/root/.kube/config \  # 挂载Kubernetes集群配置文件
  -e TEST_SUITE=basic \                       # 指定测试套件（basic/extended/full）
  -e TIMEOUT=3600 \                           # 测试超时时间（秒）
  opnfv/functest-kubernetes:latest

4.2 环境变量配置

4.3 测试结果查看

测试执行完成后，可通过以下命令查看结果：

bash
# 查看容器日志
docker logs functest-k8s

# 复制测试报告到本地
docker cp functest-k8s:/var/log/functest/report.xml ./

4.4 自定义测试用例

通过挂载自定义测试用例目录覆盖默认配置：

bash
docker run -d \
  --name functest-k8s-custom \
  -v /path/to/kubeconfig:/root/.kube/config \
  -v /path/to/custom-tests:/opt/functest/custom-tests \  # 挂载自定义测试用例
  -e TEST_SUITE=custom \
  opnfv/functest-kubernetes:latest

5. 注意事项

• 确保宿主机可访问Kubernetes集群API（通过KUBECONFIG配置正确的集群地址）。
• 测试过程中需保证集群资源充足（建议至少2 CPU、4GB内存）。
• 不同镜像标签对应不同Kubernetes版本兼容性，使用前请参考OPNFV Functest官方文档确认版本匹配。