GitHub ActionsでRust Cargoを高速化する
最終更新
GitHub Actionsで Rust と Cargo を高速化するには、target ディレクトリと cargo レジストリを Swatinem/rust-cache でキャッシュし、CARGO_INCREMENTAL=0 でインクリメンタルコンパイルを無効にして、cargo-nextest でテストを実行し、ビルドにより多くのコアを割り当ててください。Rust の CI が遅くなる主な理由は、依存関係のコンパイル負荷が大きく、毎回新しい VM 上で繰り返されることです。
このガイドでは、動作するワークフローとそのトレードオフを説明します。一般的な方法については、GitHub Actions を高速化する方法をご覧ください。
rust-cache で依存関係をキャッシュする
Swatinem/rust-cache が標準的な選択肢です。README には、キャッシュする対象が記載されています。~/.cargo(レジストリ、キャッシュ、Git の依存関係、インストール済みのバイナリ)と ./target(依存関係のビルド成果物)です。保存前に、次回以降に役立たないものを削除します。増分コンパイルの成果物、ワークスペースのクレート、未使用の依存関係、1 週間より古いファイルです。これによりキャッシュのサイズを小さく保ちます。
- uses: actions/checkout@v7
- uses: dtolnay/rust-toolchain@stable
- uses: Swatinem/rust-cache@v2
知っておくと役立つ入力項目(いずれも README より):
shared-key:同じものをビルドするジョブ間で 1 つのキーを共有します。例えばbuildとtestでキャッシュを共有できます。指定しない場合は、ジョブ ID がキーに含まれます。workspaces:ワークスペースとターゲットディレクトリを対応付けます。例えば. -> targetのように指定します。標準的でないレイアウトの場合に必要です。save-if:${{ github.ref == 'refs/heads/main' }}に設定すると、mainだけがキャッシュを書き込み、PR は読み取りのみになります。これにより、PR のキャッシュでクォータが埋まるのを防げます。cache-on-failure:trueに設定すると、テストが失敗した場合でもキャッシュを保存します。そのため、失敗したビルドでも次回の実行を温めておけます。cache-all-cratesとcache-workspace-crates:どちらも既定値はfalseです。大きなワークスペースで内部クレートが安定している場合にのみ、後者を有効にしてください。
- uses: Swatinem/rust-cache@v2
with:
shared-key: ci
save-if: ${{ github.ref == 'refs/heads/main' }}
cache-on-failure: true
CI で増分コンパイルを無効にする
増分コンパイルは、余分なデータをディスクに保存することで、開発者のマシンでの再ビルド時間を短縮します。CI ではほぼクリーンな状態から一度だけビルドするため、効果がなく、オーバーヘッドと大きな成果物だけが増えます。ジョブ全体で無効にしてください。
env:
CARGO_INCREMENTAL: 0
CARGO_TERM_COLOR: always
RUSTFLAGS: "-D warnings"
rust-cache は保存前に増分データを削除しますが、CARGO_INCREMENTAL=0 を設定すると、そのデータを生成するコストも省けます。-D warnings は任意です。警告をビルドの失敗扱いにするポリシーであり、ビルドフラグも変わるため、キャッシュを共有するすべてのジョブで同じ設定にしてください。
sccache によるコンパイラキャッシュ
mozilla-actions/sccache-action は second layer を追加します。sccache は個々の rustc の出力をキャッシュします。README に従い、env に SCCACHE_GHA_ENABLED: "true" と RUSTC_WRAPPER: "sccache" を設定し、アクションのステップを追加してください。
env:
SCCACHE_GHA_ENABLED: "true"
RUSTC_WRAPPER: "sccache"
steps:
- uses: mozilla-actions/sccache-action@v0.0.11
sccache と rust-cache は機能が重なります。まず rust-cache を使ってください。sccache が特に効果を発揮するのは、1 つのクレートの変更で target の多くが無効になる大規模なワークスペース、多数の異なる機能セットでのビルド、共有のリモートストレージを使うチームといった場合です。制約もあります。増分コンパイルの出力はキャッシュされず(CARGO_INCREMENTAL=0 を設定するもう 1 つの理由です)、一部のクレートの種類はキャッシュできません。追加の仕組みを残す前に、両方の方法で計測してください。
cargo-nextest でテストを実行する
cargo-nextest は各テストを個別のプロセスで実行し、すべてのコアにスケジューリングします。テストバイナリが多いスイートでは、cargo test より速いことが多く、シャーディング用のパーティショニングにも対応しています。nextest のドキュメントでは taiki-e/install-action を使ったインストール方法が示されています。
- uses: taiki-e/install-action@v2
with:
tool: nextest
- run: cargo nextest run --workspace --profile ci
nextest は doctest を実行しないため、cargo test --doc は別のステップとして残してください。ジョブ間でシャーディングする場合、nextest には --partition count:1/4 があります(hash: モードもあります)。インデックスは matrix に入れてください。詳しくは GitHub Actions でのテストシャーディングをご覧ください。
リンカーとビルドプロファイル
- 高速なリンカー。リンクは単一スレッドで、大きなバイナリでは遅くなります。
RUSTFLAGSまたは.cargo/config.tomlでlldやmoldを使うと、リンク時間を大きく短縮できる場合があります。最近の stable ツールチェーンでは、x86_64 Linux で既定でより高速なリンカーが使われている場合もあります。フラグを追加する前に、お使いのバージョンのリリースノートを確認してください。 - デバッグ情報。CI ビルドでは
[profile.dev] debug = "line-tables-only"またはdebug = falseを設定してください。デバッグ情報が少ないほど、書き出しとリンクの負荷が下がります。 - ビルド前のチェック。
cargo clippyは型チェックも行います。cargo checkとcargo buildを続けて実行する代わりに、テストと並行したジョブで実行してください。 - リリースビルド。
--releaseのビルドは、出荷する場所でのみ行ってください。lto = "thin"は"fat"よりも負荷が小さくなります。
CPU コア数を増やす効果
rustc はクレートとコード生成単位の間で並列化し、nextest はテスト間で並列化するため、Rust はリンクの段階まではコア数に応じて拡張されます。ベンチマークには Rust の行が 1 つあります。React + Rust (Axum) + Postgres は、GitHub ホステッドランナーでは 2m37s、compiler.dev では 1m45s でした(1.5x)。これは 10 個のテストシャードと実際のデータベースを使った CI 全体の実行で、2026 年 10 月 8 日に計測しました。Go や Gradle のスタックより短縮幅は小さく、その理由の一つはキャッシュが温まっていることです。キャッシュ済みのビルドではコンパイルする部分がほとんど残らないためです。
runs-on: [self-hosted, Linux, compiler-ci] の 1 行を変更するだけで、ご自身のワークフローを試せます。料金と ランナーサイズの選択ツールをご覧ください。関連ページとして、Rust テンプレート、GitHub Actions のキャッシュ、コンテナビルド向けの Docker レイヤーキャッシュもあります。
よくある質問
rust-cache と sccache の両方が必要ですか?
通常は必要ありません。まず rust-cache から始めてください。大規模なワークスペースや多数の機能の組み合わせで、まだ再ビルドが多すぎる場合に sccache を追加してください。
CI で CARGO_INCREMENTAL=0 を設定するのはなぜですか?
増分データは、ローカルでの繰り返しの再ビルドには役立ちます。CI では、クリーンビルドの助けにならずに、ディスクへの書き込みとキャッシュサイズを増やすだけです。
cargo-nextest は cargo test より速いですか?
多くの場合、テストの数が多いスイートで有効です。これは、テストをプロセスごとに分けてコア間に割り当てるためです。ドキュメントテストは対象外になるため、別途実行してください。
PRでキャッシュが増え続けるのを防ぐにはどうすればよいですか
save-if: ${{ github.ref == 'refs/heads/main' }}をrust-cacheに設定してください。これにより、PRではキャッシュを復元するだけで、保存は行われなくなります。
関連記事
- GitHub ActionsでTypeScriptモノレポを高速化するGitHub Actionsで TypeScriptモノレポの型チェックとリンターを高速化する: インクリメンタルtsc、プロジェクト参照、Lintキャッシュ、並列ジョブ
- GitHub ActionsでモノレポのPlaywrightを高速化するGitHub Actions で Node モノレポの Playwright E2E テストを高速化: アプリを一度だけビルドし、Web アプリに変更がないときは E2E をスキップし、シャーディングとレポートのマージを行います。
- READMEにCIの速度バッジを追加するREADME のバッジで CI の速さを表示しましょう。リポジトリの GitHub Actions 実行時間の中央値が自動で更新されます。公開リポジトリは無料です。
- GitHub Actions で Cargo と Rust のビルドをキャッシュするSwatinem/rust-cache または actions/cache を使用して、GitHub Actions で Cargo レジストリ、git 依存関係、target ディレクトリをキャッシュします。キャッシュが肥大化しないように注意します。