opnfv/functest-kubernetes-healthcheck

OPNFV Functest Kubernetes 健康检查镜像

镜像概述

OPNFV Functest Kubernetes健康检查镜像是OPNFV（开放平台NFV）项目中Functest测试框架的一部分，专门针对Kubernetes集群提供健康检查和功能验证能力。该镜像集成了预设的测试用例和检查工具，旨在通过标准化的测试流程，评估Kubernetes集群的核心功能、组件状态及整体健康度，为NFV基础设施的部署和维护提供可靠的测试支持。

核心功能与特性

• Kubernetes集群健康检查：验证集群控制平面（kube-apiserver、etcd、kube-scheduler等）和节点（kubelet、容器运行时）的运行状态。
• 功能测试用例执行：内置针对Kubernetes核心功能的测试套件，包括Pod调度、服务发现、网络策略、存储卷等基础功能验证。
• 健康状态报告生成：输出结构化的测试结果，包含通过/失败用例统计、异常详情及建议修复措施。
• 兼容性支持：适配主流Kubernetes版本（如1.20+）及OPNFV认证的NFV部署环境。
• 轻量级设计：基于精简基础镜像构建，减少资源占用，支持在资源受限的NFV环境中运行。

使用场景

• 集群部署验收：在Kubernetes集群部署完成后，执行初始化健康检查，验证部署质量。
• 定期健康巡检：作为定时任务运行，持续监控集群长期运行的稳定性。
• NFV基础设施测试：在NFV场景下，验证Kubernetes作为基础设施层的功能完整性。
• 开发/测试环境验证：在Kubernetes版本升级或配置变更后，快速验证功能影响范围。

使用方法与配置说明

前提条件

• 目标Kubernetes集群已部署并正常运行。
• 执行环境需具备访问集群API的网络权限。
• 需提供集群管理员权限的kubeconfig配置文件（或通过环境变量注入集群认证信息）。

基本使用命令（Docker Run）

bash
docker run -it \
  -v /path/to/local/kubeconfig:/root/.kube/config:ro \
  opnfv/functest-kubernetes-healthcheck:latest

环境变量配置

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

自定义测试套件示例

若需指定自定义测试用例，可通过挂载测试定义文件实现：

bash
docker run -it \
  -v /path/to/local/kubeconfig:/root/.kube/config:ro \
  -v /path/to/custom/testcases.yaml:/opt/functest/custom-testcases.yaml \
  -e TEST_SUITE=custom \
  -e CUSTOM_TESTCASES_PATH=/opt/functest/custom-testcases.yaml \
  opnfv/functest-kubernetes-healthcheck:latest

测试报告获取

默认情况下，测试报告以JSON和HTML格式保存至REPORT_PATH指定路径。可通过挂载本地目录导出报告：

bash
docker run -it \
  -v /path/to/local/kubeconfig:/root/.kube/config:ro \
  -v /local/report/dir:/tmp/functest-report \
  opnfv/functest-kubernetes-healthcheck:latest

执行完成后，本地/local/report/dir目录将包含生成的测试报告文件。

输出说明

测试执行过程中，控制台会实时输出测试进度（通过[PASS]/[FAIL]标识用例结果）。最终输出包含汇总统计，示例：

=== Test Summary ===
Total cases: 20
Passed: 18
Failed: 2
Skipped: 0
Failure details:
  - TestCase[pod-network-connectivity]: timeout waiting for pod to reach running state
  - TestCase[etcd-cluster-health]: member etcd-2 is unreachable
Report saved to: /tmp/functest-report/functest-report.html