jacobsvante/cargo-chef

cargo-chef CI镜像

镜像概述

cargo-chef CI镜像是一个专为Rust项目持续集成(CI)流程设计的Docker镜像，基于官方Rust工具链构建，并预装了cargo-chef工具。cargo-chef是一款用于优化Rust项目依赖管理的工具，能够生成依赖清单并实现依赖缓存，从而显著减少CI环境中的重复构建时间，提高构建效率。

核心功能与特性

• 预装组件：包含完整的Rust工具链（rustc、cargo等）和cargo-chef，开箱即可使用
• 依赖优化：通过cargo-chef生成依赖清单(Cargo.chef)，支持依赖层缓存，避免重复下载和编译依赖
• CI友好：专为CI/CD流程设计，支持主流CI平台（如GitHub Actions、GitLab CI、Jenkins等）
• 版本同步：镜像版本与Rust官方工具链版本同步，确保开发环境与CI环境一致性

使用场景

• Rust项目的持续集成构建流程
• 需要频繁构建的Rust应用开发场景
• 希望优化CI构建时间、减少资源消耗的Rust项目
• 多环境一致的Rust依赖管理需求

使用方法

基本使用

直接运行镜像进入交互式环境：

bash
docker run --rm -it jmagnusson/cargo-chef:latest

在CI配置中使用

GitHub Actions示例

在.github/workflows/ci.yml中配置：

yaml
name: CI

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Build with cargo-chef
        uses: docker://jmagnusson/cargo-chef:latest
        with:
          args: |
            cargo chef prepare --recipe-path recipe.json
            cargo chef cook --recipe-path recipe.json
            cargo build --release

GitLab CI示例

在.gitlab-ci.yml中配置：

yaml
build:
  image: jmagnusson/cargo-chef:latest
  script:
    - cargo chef prepare --recipe-path recipe.json
    - cargo chef cook --recipe-path recipe.json
    - cargo build --release
  artifacts:
    paths:
      - target/release/

自定义配置

指定Rust版本

镜像标签与Rust版本对应，可指定特定Rust版本：

bash
docker run --rm -it jmagnusson/cargo-chef:1.70.0  # 使用Rust 1.70.0版本

挂载项目目录

挂载本地Rust项目目录进行构建：

bash
docker run --rm -v $(pwd):/app -w /app jmagnusson/cargo-chef:latest cargo chef prepare

注意事项

• 确保CI环境中已配置Docker运行环境
• 对于私有依赖或需要特定网络配置的项目，可能需要在CI配置中添加额外的网络或认证设置
• 镜像体积较大（包含完整Rust工具链），建议在CI配置中启用镜像缓存以加速后续构建