rapidsai/citestwheel

rapidsai/citestwheel 镜像文档

镜像概述

rapidsai/citestwheel是Rapids AI项目官方维护的持续集成(CI)测试专用镜像，基于https://github.com/rapidsai/ci-imgs/项目构建。该镜像旨在为Rapids 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 docker.xuanyuan.run/rapidsai/citestwheel:latest

如需特定版本，可指定标签（标签列表请参考https://github.com/rapidsai/ci-imgs/）：

bash
docker pull docker.xuanyuan.run/rapidsai/citestwheel:<tag>

基础使用示例

1. 本地测试

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

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

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

2. 集成到GitHub Actions

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

yaml
jobs:
  test-wheel:
    runs-on: ubuntu-latest
    container:
      image: docker.xuanyuan.run/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/项目文档，建议根据具体测试需求调整容器启动参数及测试脚本。

注意事项

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

参考链接

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