openebs/mayastor-fio-spdk

镜像概述和主要用途

该Docker镜像为Mayastor存储系统提供CI/CD测试工具，旨在通过自动化测试流程，确保Mayastor在持续集成（CI）和持续部署（CD）环境中的功能正确性、性能稳定性及兼容性。主要用于开发团队在代码提交、版本构建及部署前的自动化验证，减少人工测试成本，加速开发迭代。

核心功能和特性

• 自动化测试执行：支持批量运行预设测试用例，覆盖功能验证、集成测试及兼容性检查
• CI/CD平台集成：适配主流CI工具（如GitLab CI、Jenkins、GitHub Actions），可直接嵌入现有流水线
• 测试环境隔离：内置轻量级测试环境配置，避免对生产/开发环境的干扰
• 结果报告生成：输出标准化测试报告（支持JUnit、HTML格式），便于问题定位与状态追踪
• 版本适配：支持指定Mayastor版本进行测试，确保测试场景与目标部署版本匹配

使用场景和适用范围

• 开发阶段：代码提交后自动触发测试，快速发现功能回归或兼容性问题
• 版本发布：发布候选版本（RC）的集成测试与性能验证，确保符合发布标准
• 部署前验证：生产环境部署前的预测试，模拟实际运行场景验证稳定性
• 第三方集成测试：验证Mayastor与其他云原生组件（如Kubernetes、CSI驱动）的集成效果

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+）
• 网络可访问Mayastor测试镜像仓库（如Docker Hub或私有registry）
• （可选）CI/CD平台配置文件（如.gitlab-ci.yml、Jenkinsfile）

基本使用命令

拉取镜像

bash
docker pull docker.xuanyuan.run/mayastor/test-utility:latest

运行基础测试

bash
docker run --rm \
  -e MAYASTOR_VERSION=v2.5.0 \  # 指定目标Mayastor版本
  -e TEST_TYPE=functional \     # 测试类型：functional/integration/performance
  -v $(pwd)/reports:/reports \  # 挂载宿主机目录存储测试报告
  mayastor/test-utility:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  mayastor-test:
    image: docker.xuanyuan.run/mayastor/test-utility:latest
    environment:
      - MAYASTOR_VERSION=v2.5.0
      - TEST_TYPE=integration
      - REPORT_FORMAT=junit  # 报告格式：junit/html
      - LOG_LEVEL=info       # 日志级别：debug/info/warn/error
    volumes:
      - ./test-reports:/reports
      - ./test-config:/config  # 挂载自定义测试配置文件
    network_mode: host  # 如需访问宿主机Mayastor服务，可使用host网络

环境变量配置

集成CI/CD平台示例（GitLab CI）

在.gitlab-ci.yml中添加测试阶段：

yaml
stages:
  - test

mayastor-test:
  stage: test
  image: mayastor/test-utility:latest
  variables:
    MAYASTOR_VERSION: v2.5.0
    TEST_TYPE: integration
    REPORT_FORMAT: junit
  script:
    - /entrypoint.sh  # 镜像内置入口脚本，执行测试流程
  artifacts:
    paths:
      - reports/  # 保存测试报告为CI制品
    reports:
      junit: reports/junit.xml  # GitLab自动解析JUnit报告