CentOS如何配置Rust的持续集成环境

在 CentOS 上搭建 Rust 持续集成环境的实操指南

一 基础环境准备

• 安装系统构建工具与基础依赖（Rust 编译与链接需要 C 工具链）：
  • CentOS 7/8：执行 sudo yum groupinstall “Development Tools” -y && sudo yum install -y gcc openssl-devel
  • CentOS Stream 8/9：执行 sudo dnf groupinstall “Development Tools” -y && sudo dnf install -y gcc openssl-devel
• 安装 Rust 工具链（rustup）：
  • 执行 curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 使环境立即生效：source “$HOME/.cargo/env”
  • 验证：rustc --version 与 cargo --version 均应输出版本号
• 国内镜像加速（可选，提升下载速度）：
  • 配置 rustup 镜像：
    • echo ‘export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static’ >> /etc/profile
    • echo ‘export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup’ >> /etc/profile
    • source /etc/profile
  • 配置 Cargo 源（~/.cargo/config）：
    • [source.crates-io] registry = “https://github.com/rust-lang/crates.io-index” replace-with = ‘ustc’
    • [source.ustc] registry = “git://mirrors.ustc.edu.cn/crates.io-index”
• 若遇到 linker cc not found，说明缺少 gcc，按上一步安装构建工具即可。

二 本地验证流水线

• 在仓库根目录准备最小流水线脚本（.github/workflows/ci.yml），用于 GitHub Actions 的 CentOS 运行器：
  • 使用官方 ubuntu-latest 运行器（自带较新工具链）；如需在自托管 CentOS 运行器上执行，将 runs-on 改为 self-hosted 并确保已安装 rustup 与 gcc
  • 示例要点：
    • 安装工具链：actions-rs/toolchain@v1（指定 channel: stable，components: rustfmt, clippy）
    • 缓存：actions/cache 保存 ~/.cargo/registry 与 target，加速依赖与构建
    • 任务：cargo fmt --check、cargo clippy – -D warnings、cargo build --release、cargo test --all-targets – --nocapture
• 本地先行验证（在 CentOS 构建机或容器内）：
  • cargo fmt --check
  • cargo clippy – -D warnings
  • cargo build --release
  • cargo test --all-targets – --nocapture
• 常用 Cargo 测试参数（CI 友好）：
  • –no-run：仅编译测试，快速校验可编译性
  • –all-targets：覆盖 examples、bins、tests
  • –all-features：启用全部特性
  • –jobs ：并行度控制，避免资源争用

三 自托管 CentOS Runner 搭建

• 安装 GitHub Actions Runner（适用于内网/离线场景）：
  • 前往仓库 Settings → Actions → Runners → New self-hosted runner，选择 Linux x64，下载并解压
  • 运行 ./config.sh 按提示配置仓库 URL 与 Token
  • 启动：./run.sh（建议使用 systemd 或 screen/tmux 守护）
• 在自托管 Runner 上预装环境：
  • 按“基础环境准备”安装 gcc、openssl-devel、rustup，并配置镜像（可选）
  • 验证：rustc -vV、cargo -vV、gcc -v
• 安全建议：
  • 以专用低权限用户运行 Runner
  • 隔离网络与存储，限制可访问仓库范围
  • 定期更新 Runner 与工具链，保留构建日志与产物

四 常见故障与优化

• 构建报错 linker cc not found：安装 gcc 与基础开发工具（见上文）
• 依赖下载慢或失败：启用 USTC 镜像（rustup 与 Cargo 双管齐下）
• 缓存命中率低：合理设置 Cargo 缓存键（按 OS、Rust 版本、依赖锁文件），并持久化 ~/.cargo/registry 与 target
• 运行测试超时或资源争用：使用 --jobs 限制并发，拆分慢测，必要时按特性/模块并行
• 旧系统（如 CentOS 7）glibc/工具链较老：优先使用较新 Runner 镜像；如必须在旧系统构建，考虑容器化（在较新基础镜像中运行 cargo）