rapidsai/citestwheel

rapidsai/citestwheel 镜像文档

镜像概述

rapidsai/citestwheel是Rapids AI项目官方维护的持续集成(CI)测试专用镜像，基于https://github.com/rapidsai/ci-imgs/%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%97%A8%E5%9C%A8%E4%B8%BARapids AI生态系统中的wheel包提供标准化、一致性的测试环境，确保wheel包在构建流程中的正确性、兼容性及跨平台可用性。

核心功能与特性

• 标准化CI环境：提供预配置的持续集成测试环境，消除因开发环境差异导致的测试结果不一致问题。
• wheel包测试支持：集成wheel包构建验证、兼容性测试所需的工具链和依赖组件，支持自动化测试流程。
• Rapids生态兼容：与Rapids AI项目的其他工具和环境深度集成，确保测试环境与生产环境的一致性。
• CI流程优化：针对持续集成场景优化，可无缝接入主流CI/CD平台（如GitHub Actions、GitLab CI等）。

使用场景与适用范围

• Rapids AI项目开发：供Rapids AI项目开发者在代码提交、PR审核等CI环节中验证wheel包质量。
• wheel包兼容性测试：测试不同Python版本、操作系统及硬件环境下wheel包的兼容性。
• 自动化测试流程：作为CI pipeline的关键环节，自动化执行wheel包的单元测试、集成测试等验证步骤。

使用方法与配置说明

前提条件

• 已安装Docker Engine（推荐版本20.10+）
• 熟悉Docker容器基本操作及CI/CD流程配置

获取镜像

通过Docker Hub直接拉取最新版本镜像：

bash
docker pull rapidsai/citestwheel:latest

如需特定版本，可指定标签（标签列表请参考https://github.com/rapidsai/ci-imgs/%EF%BC%89%EF%BC%9A

bash
docker pull rapidsai/citestwheel:<tag>

基础使用示例

1. 本地测试

启动容器并进入交互模式：

bash
docker run -it --rm rapidsai/citestwheel:latest /bin/bash

在容器内执行wheel包测试命令（具体命令需根据项目测试规范调整）。

2. 集成到GitHub Actions

在.github/workflows/test-wheel.yml中添加以下配置片段：

yaml
jobs:
  test-wheel:
    runs-on: ubuntu-latest
    container:
      image: rapidsai/citestwheel:latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Run wheel tests
        run: |
          # 执行项目自定义的wheel测试脚本
          ./ci/test_wheel.sh

配置说明

该镜像的详细配置（包括环境变量、测试工具路径、依赖管理等）请参考https://github.com/rapidsai/ci-imgs/%E9%A1%B9%E7%9B%AE%E6%96%87%E6%A1%A3%EF%BC%8C%E5%BB%BA%E8%AE%AE%E6%A0%B9%E6%8D%AE%E5%85%B7%E4%BD%93%E6%B5%8B%E8%AF%95%E9%9C%80%E6%B1%82%E8%B0%83%E6%95%B4%E5%AE%B9%E5%99%A8%E5%90%AF%E5%8A%A8%E5%8F%82%E6%95%B0%E5%8F%8A%E6%B5%8B%E8%AF%95%E8%84%9A%E6%9C%AC%E3%80%82

注意事项

• 镜像仅用于测试环境，不建议用于生产部署
• 定期同步官方仓库更新，确保测试环境与Rapids AI最新版本兼容
• 复杂测试场景需结合项目CI文档进行定制化配置

参考链接

• 官方项目仓库：https://github.com/rapidsai/ci-imgs/
• Docker Hub镜像页面：https://hub.docker.com/r/rapidsai/citestwheel