Ganeti CI镜像文档

镜像概述和主要用途

Ganeti CI镜像是专为Ganeti项目设计的持续集成环境镜像，旨在标准化和简化Ganeti相关代码的自动化构建、测试及集成流程。该镜像预配置了Ganeti开发与测试所需的依赖环境、工具链及脚本，可直接集成于主流CI平台（如GitHub Actions、Jenkins、GitLab CI等），帮助开发团队高效验证代码质量、自动化执行测试套件，并加速集成流程。

核心功能和特性

1. 预配置的开发环境

• 包含Ganeti构建所需的编译工具（GCC、Make等）、依赖库（如Python开发库、libvirt-devel等）及版本控制工具（Git）。
• 集成Python虚拟环境管理工具，支持多Python版本测试（匹配Ganeti兼容性需求）。

2. 自动化测试支持

• 内置Ganeti单元测试框架（pytest）、集成测试脚本及代码覆盖率工具（coverage.py）。
• 支持测试报告生成（JUnit格式），便于CI平台解析和展示测试结果。

3. CI平台兼容性

• 适配主流CI/CD平台，提供标准化入口脚本（如run-ci.sh），支持自定义测试流程。
• 兼容容器化CI环境，可通过环境变量灵活配置测试参数。

4. 版本化管理

• 镜像标签与Ganeti版本对应（如ganeti/ci-images:3.0对应Ganeti 3.0系列），确保环境一致性。
• 定期更新基础镜像及依赖，修复安全漏洞。

使用场景和适用范围

适用场景

• 日常开发验证：开发人员提交代码后，自动触发构建与单元测试，快速反馈代码问题。
• 发布前集成测试：在Ganeti版本发布前，执行全量集成测试，验证跨组件兼容性。
• 多版本兼容性测试：通过不同标签的镜像，测试代码对Ganeti历史版本的兼容性。
• 第三方贡献审核：为外部贡献者提供一致的测试环境，确保PR符合项目质量标准。

适用对象

• Ganeti核心开发团队
• 基于Ganeti进行二次开发的企业或个人
• 参与Ganeti社区贡献的开发者

使用方法和配置说明

基本使用流程

1. 拉取镜像
   从镜像仓库拉取对应版本的CI镜像（以Ganeti 3.0为例）：

   bash
   docker pull ganeti/ci-images:3.0
   

2. 运行容器
   挂载本地代码目录并执行测试（假设代码位于./ganeti-src）：

   bash
   docker run -it \
     -v $(pwd)/ganeti-src:/workspace/ganeti \  # 挂载代码目录
     -v $(pwd)/test-reports:/workspace/reports \  # 挂载测试报告目录
     -e GANETI_VERSION=3.0 \  # 指定目标Ganeti版本
     -e TEST_TYPE=unit \  # 指定测试类型（unit/integration）
     ganeti/ci-images:3.0 \
     run-ci.sh  # 执行CI入口脚本
   

环境变量配置

CI平台集成示例（GitHub Actions）

在Ganeti项目的.github/workflows/ci.yml中配置：

yaml
name: Ganeti CI
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Run Ganeti CI tests
        uses: docker/run-action@v3
        with:
          image: ganeti/ci-images:3.0
          volumes:
            - ${{ github.workspace }}:/workspace/ganeti
            - ${{ github.workspace }}/reports:/workspace/reports
          env:
            GANETI_VERSION: 3.0
            TEST_TYPE: all
            REPORT_PATH: /workspace/reports

自定义测试流程

若需扩展测试步骤，可通过挂载自定义脚本覆盖默认入口脚本：

bash
docker run -it \
  -v $(pwd)/custom-ci.sh:/workspace/run-ci.sh \  # 挂载自定义脚本
  -v $(pwd)/ganeti-src:/workspace/ganeti \
  ganeti/ci-images:3.0 \
  /workspace/run-ci.sh  # 执行自定义脚本

注意事项

• 本地代码目录需确保可被容器读取（权限设置为755或调整容器用户）。
• 测试报告目录需提前创建，避免权限错误。
• 对于集成测试，可能需要额外配置网络或依赖服务（如通过--network=host共享主机网络）。