Rustのビルド地獄から脱出せよ：`cargo-chef`でDockerビルドを「秒速」にする極意
こんにちは。Rustという、非常に強力だが、時としてその「ビルドの長さ」が開発者の集中力を削ぐ言語に向き合っている皆さん。
「Rustのコンパイルが遅いのは言語の仕様だから仕方ない」と諦めていませんか？ 特にDocker環境でのビルドは、CI/CDパイプラインを止める最大のボトルネックになりがちです。
なぜ遅いのか。答えはシンプルです。「コードを1行変えるたびに、数千行にも及ぶ依存ライブラリまで全て再コンパイルしているから」です。
今日は、Dockerのレイヤーキャッシュを極限まで活用し、Rustのビルド時間を劇的に短縮する「`cargo-chef`」という魔法のようなツールを紹介します。これをマスターすれば、あなたのCI/CDパイプラインは爆速になり、開発体験は劇的に向上します。
—
1. なぜ「普通のDockerビルド」ではダメなのか？
一般的なRustのDockerfileは以下のようになりがちです。
COPY . .
RUN cargo build –release
これの何が問題か。`COPY . .` でソースコード全体をコピーした瞬間、Dockerは「ソースコードが変わった」と判断し、以降のステップ（`cargo build`）をすべてキャッシュなしで再実行します。つまり、`Cargo.toml` や `Cargo.lock` に変更がなくても、小さなコメントを直しただけで、数分〜数十分のコンパイルを最初からやり直すことになるのです。
2. cargo-chefの役割：依存関係の「分離」と「独立」
`cargo-chef` は、Rustプロジェクトを2つのフェーズに分割します。
1. プランニングフェーズ: プロジェクトから依存関係（`Cargo.toml`）だけを抽出し、ダミーのソースコードと共に「レシピ」を作成する。
2. ビルドフェーズ: レシピを元に、依存ライブラリだけを先にビルドし、その結果をレイヤーとして保存する。
こうすることで、「依存関係が変わらない限り、重いライブラリのビルド結果は再利用し続ける」という理想的な環境が完成します。
—
3. 実践：cargo-chefのセットアップ
まずは、ホスト環境のcargoに `cargo-chef` をインストールします。
cargo-chefバイナリをインストール
cargo install cargo-chef
ステップ1: レシピの作成（プランニング）
プロジェクトのルートディレクトリで以下のコマンドを実行してください。
依存関係を解析し、ビルドに必要な情報（レシピ）をchef.jsonとして抽出する
cargo chef prepare –recipe-path recipe.json
この `recipe.json` が、あなたのプロジェクトの「ビルドの設計図」になります。
ステップ2: Dockerfileを「スマート」に書き換える
ここが最も重要な部分です。マルチステージビルドを駆使して、環境を分離します。
ステージ1: レシピ作成用（プランナー）
FROM rust:latest AS planner
RUN cargo install cargo-chef
WORKDIR /app
COPY . .
依存関係のみを解決するレシピを作成
RUN cargo chef prepare –recipe-path recipe.json
ステージ2: 依存関係の事前ビルド（キャッチャー）
FROM rust:latest AS cacher
RUN cargo install cargo-chef
WORKDIR /app
COPY –from=planner /app/recipe.json recipe.json
依存関係のみを先行してビルド（ここがキャッシュされる！）
RUN cargo chef cook –release –recipe-path recipe.json
ステージ3: 本番ビルド
FROM rust:latest AS builder
WORKDIR /app
COPY . .
事前ビルド済みの依存関係をコピーして利用
COPY –from=cacher /app/target target
RUN cargo build –release
ステージ4: 実行用イメージ（軽量化）
FROM debian:bookworm-slim
COPY –from=builder /app/target/release/your-app /usr/local/bin/your-app
CMD [“your-app”]
—
4. この設計がもたらす「圧倒的な利益」
この構成を導入すると、開発サイクルは以下のように変化します。
- 依存関係が変更されたとき: `Cargo.toml` や `Cargo.lock` が書き換わった時だけ、ステージ2（`cargo chef cook`）が再実行されます。
- ソースコードだけが変更されたとき: ステージ1と2はスキップされます。ステージ3の `cargo build` だけが走りますが、依存ライブラリはすでにコンパイル済みのため、実行バイナリのリンクと自作コードのコンパイルだけでビルドが完了します。
結果として、平均してビルド時間は 5分の1以下 に短縮されることも珍しくありません。
最後に：効率化は「愛」です
開発者がビルドの待ち時間に費やす時間は、年間で見れば膨大な損失です。その時間を、新しい機能の実装や、より深い設計の検討、あるいは心身を休めるコーヒーブレイクに回すべきです。
`cargo-chef` は単なるツールではなく、あなたの開発ライフサイクルを最適化するための強力なパートナーです。まずは小さなプロジェクトから、この「レシピ」を導入してみてください。コンパイルボタンを押した直後にバイナリが生成される快感を、ぜひ体験してください。
何か不明点があれば、いつでも聞いてくださいね。あなたのRust開発がより快適なものになるよう、応援しています。