opnfv/functest-kubernetes-smoke

镜像概述

OPNFV Functest Kubernetes冒烟测试镜像是OPNFV（开放平台用于网络功能虚拟化）项目旗下Functest测试框架的一部分，专门为Kubernetes集群设计的轻量级测试工具。该镜像封装了执行Kubernetes基础功能验证所需的测试套件和依赖组件，旨在通过执行核心测试用例，快速评估集群基础功能是否正常运行，为集群部署验证、日常维护和自动化测试提供基础验证能力。

核心功能与特性

• 基础功能验证：执行Kubernetes核心组件基础测试用例，包括节点状态检查、Pod创建与调度、服务（Service）访问、配置映射（ConfigMap）与密钥（Secret）管理等核心功能验证。
• 快速健康反馈：测试流程轻量化，执行周期短（通常5-10分钟内完成），可快速输出集群健康状态评估结果。
• 标准化测试流程：遵循OPNFV测试规范与标准，确保测试结果的一致性和行业兼容性。
• 低依赖部署：作为Docker镜像分发，无需复杂本地环境配置，通过挂载Kubernetes配置文件即可直接运行。
• 多格式结果输出：支持文本、JSON等多种测试报告格式，便于结果查看、解析及集成至自动化报告系统。

使用场景与适用范围

• Kubernetes集群部署后验证：新集群部署完成后，通过冒烟测试确认节点就绪、网络连通、容器运行时等基础功能是否正常。
• 日常维护健康检查：集群升级或配置变更后，执行快速测试验证核心功能未受影响，及时发现潜在问题。
• CI/CD流程自动化测试：嵌入Kubernetes集群部署的CI/CD流水线，作为自动化测试环节，确保每次部署后基础功能可用。
• 开发环境快速验证：供开发人员在本地或测试环境中快速验证集群配置是否满足基础运行要求。

使用方法与配置说明

前提条件

• 目标Kubernetes集群已部署并可访问（测试节点需能通过网络连接集群API Server）。
• 测试节点已安装Docker引擎。
• 已准备有效的KUBECONFIG配置文件（用于镜像内工具访问Kubernetes集群）。

基本使用命令

通过以下命令启动容器并执行冒烟测试：

bash
docker run --rm \
  -v /本地KUBECONFIG路径:/root/.kube/config \  # 挂载本地Kubernetes配置文件至容器内默认路径
  opnfv/functest-kubernetes-smoke:latest       # 镜像名称（可指定版本，如stable或具体版本号）

环境变量配置

通过-e参数设置环境变量可调整测试行为，常用配置如下：

示例：设置测试超时时间为600秒，日志级别为DEBUG：

bash
docker run --rm \
  -v /本地KUBECONFIG路径:/root/.kube/config \
  -e TEST_TIMEOUT=600 \
  -e LOG_LEVEL=DEBUG \
  opnfv/functest-kubernetes-smoke:latest

测试结果查看与报告保存

• 实时查看：测试过程中，结果实时输出至容器标准输出（stdout），可通过终端直接查看。
• 报告保存：通过挂载报告目录持久化保存测试报告：

  bash
  docker run --rm \
    -v /本地KUBECONFIG路径:/root/.kube/config \
    -v /本地报告目录:/functest/reports \  # 挂载本地目录存储测试报告
    opnfv/functest-kubernetes-smoke:latest
  

  测试报告（如JSON或HTML格式）将保存至/本地报告目录，包含测试用例总数、通过数、失败数及详细失败原因（如有）。