Longhorn Test Runner 镜像文档

镜像概述和主要用途

Longhorn Test Runner 是一个用于自动化测试 Longhorn 分布式块存储系统的 Docker 镜像。该镜像封装了 Longhorn 测试框架及依赖工具，支持在隔离环境中执行各类测试用例，验证 Longhorn 集群的功能正确性、稳定性及性能表现。主要用途包括 Longhorn 开发迭代中的自动化测试、CI/CD 流程集成、版本发布前验证等场景。

核心功能和特性

核心功能

• 多测试类型支持：覆盖单元测试、集成测试、端到端测试及性能测试，支持自定义测试用例集。
• Longhorn 集群集成：通过 Longhorn API 或 Kubernetes API 与目标 Longhorn 集群通信，自动完成测试环境准备与清理。
• 测试报告生成：支持输出 JSON/XML/HTML 格式测试报告，包含用例执行结果、耗时、错误日志等详情。
• 参数化配置：通过环境变量或配置文件自定义测试范围、超时时间、资源限制等参数。

特性

• 轻量级封装：基于 Alpine 或 Ubuntu 基础镜像，体积小，启动速度快。
• 无状态设计：测试过程不依赖本地持久化数据，支持横向扩展测试任务。
• 版本兼容性：适配 Longhorn v1.2+ 版本，通过参数指定目标集群版本。
• CI/CD 友好：支持与 Jenkins、GitLab CI、GitHub Actions 等主流 CI/CD 工具集成。

使用场景和适用范围

典型使用场景

• Longhorn 开发测试：开发人员本地验证代码修改对 Longhorn 功能的影响。
• CI/CD 流程集成：在代码提交或 PR 合并后自动触发测试，确保功能稳定性。
• 版本发布验证：在 Longhorn 版本发布前执行全量测试，验证集群部署、故障恢复、数据一致性等核心能力。
• 自定义测试场景：通过挂载外部测试用例文件，执行用户自定义的 Longhorn 测试逻辑。

适用范围

• Longhorn 存储系统的开发团队、运维团队及测试团队。
• 需要自动化验证 Longhorn 集群功能的 Kubernetes 环境。
• 对 Longhorn 进行二次开发或定制化的企业用户。

使用方法和配置说明

前提条件

• 已安装 Docker Engine (20.10+)/Docker Compose (v2+).
• 目标 Longhorn 集群处于运行状态，且测试节点可通过网络访问 Longhorn API 或 Kubernetes API Server。
• 若执行性能测试，建议测试节点配置 ≥4 CPU 核心、8GB 内存及 100GB 可用磁盘空间。

镜像拉取

docker pull longhornio/test-runner:latest  # 拉取最新版本
# 或指定版本（如 v1.6.0）
docker pull longhornio/test-runner:v1.6.0

基本使用方法

1. 基本测试命令（Docker Run）

以下示例执行 Longhorn 集成测试，连接至目标 Kubernetes 集群（通过 KUBECONFIG 挂载），并输出测试报告至本地目录：

docker run -it --rm \
  -v $HOME/.kube/config:/root/.kube/config:ro \  # 挂载 Kubernetes 配置（访问 Longhorn 集群）
  -v $(pwd)/test-results:/app/results \          # 挂载测试结果输出目录
  -e TEST_TYPE=integration \                     # 指定测试类型（integration/unit/e2e/performance）
  -e LONGHORN_VERSION=v1.6.0 \                   # 目标 Longhorn 版本（需与集群版本匹配）
  -e TEST_TIMEOUT=3600 \                         # 测试超时时间（秒，默认 3600）
  longhornio/test-runner:latest

2. Docker Compose 配置示例

创建 docker-compose.yml 文件，定义测试服务及依赖：

version: '3.8'
services:
  longhorn-test:
    image: longhornio/test-runner:latest
    volumes:
      - $HOME/.kube/config:/root/.kube/config:ro
      - ./test-results:/app/results
      - ./custom-testcases:/app/custom-testcases  # 挂载自定义测试用例（可选）
    environment:
      - TEST_TYPE=e2e
      - LONGHORN_VERSION=v1.6.0
      - TEST_TIMEOUT=7200
      - ENABLE_REPORT=true                        # 启用测试报告生成（默认 true）
      - REPORT_FORMAT=html                        # 报告格式（html/json/xml，默认 html）
      - DEBUG_MODE=false                          # 是否开启调试模式（默认 false，开启后输出详细日志）
    network_mode: host  # 直接使用主机网络，确保与 Kubernetes 集群网络连通

启动测试：

docker-compose up

配置参数详解

环境变量配置

卷挂载说明

注意事项

1. 版本兼容性：LONGHORN_VERSION 需与目标集群版本严格匹配，否则可能因 API 差异导致测试失败。
2. 网络要求：测试容器需与 Kubernetes API Server 及 Longhorn 组件（如 manager、engine）网络连通，建议使用 --net=host 或配置容器网络为集群所在网络。
3. 资源限制：执行性能测试时，建议通过 --memory 和 --cpus 参数限制容器资源（如 --memory=8g --cpus=4），避免影响测试结果准确性。
4. 权限要求：挂载的 KUBECONFIG 需具备足够权限（如 cluster-admin），否则可能因权限不足导致测试用例执行失败。