GitHub ActionsでBazelモノレポを最速でCIする
最終更新
Bazelは元々インクリメンタルに動作するため、高速なCIには主に二つの要素があります。一つは共有のリモートキャッシュです。これにより、新しいランナーが別の実行で既にビルドされた内容を再ビルドせずに済みます。もう一つは大規模なリポジトリの場合で、変更の影響を受けるターゲットのみを実行することです。Bazelのキャッシュは設計上正しく動作するため、安全に共有できます。作業の中心は、それをGitHub Actionsに組み込むことです。
Bazelを使ってもCIが遅い理由
新しいGitHub Actionsランナーには、空の出力ベースと空のディスクキャッシュしかありません。そのため、Bazelは初回にすべてのターゲットを再ビルドします。インクリメンタルビルドの効果は、実行間で状態が保持される場合にのみ得られます。保持先は次の三つです。
| 保存場所 | 実行間で保持 | ランナー間で共有 | 備考 |
|---|---|---|---|
| ランナーのディスク | なし | なし | いいえ、ジョブごとに新しいVM |
ディスクキャッシュのactions/cache | あり | はい、ただしスコープの制限あり | 10 GBとブランチのスコープによる制限あり |
| リモートキャッシュサーバー | あり | あり | 大規模環境における最適な選択肢 |
リモートキャッシュ
Bazelのリモートキャッシュのドキュメント(2026年10月確認)では、--remote_cacheでエンドポイント(HTTP、HTTPS、gRPC、gRPCS)を指定します。簡単な構成では、認証情報をURLに含める方法が説明されていますが、これはHTTPS経由の場合にのみ安全です。フラグは.bazelrcのci構成に記述してください。そうすることで、開発者とCIが同じ定義を共有できます。
# .bazelrc
build:ci --remote_cache=https://cache.example.com
build:ci --remote_upload_local_results=false
ドキュメントでは--remote_upload_local_results=falseを、ビルドをリモートキャッシュに対して読み取り専用にするものとして説明しており、書き込み権限はCIシステムのみに持たせることを推奨しています。さらに一歩進めて、main上の信頼されたビルドのみが書き込みできるようにすることをおすすめします。
# passed from the workflow for main only
build:ci-write --config=ci
build:ci-write --remote_upload_local_results=true
この構成では、プルリクエストはmainがビルドした結果を読み取るだけで、その内容を汚染することはできません。ホスト型とセルフホスト型のキャッシュサーバーのどちらも利用できます。セキュリティ要件に合うものを選んでください。データの保存場所や規模によって適切な選択は異なるため、ここでは特定のベンダーを推奨しません。
ディスクキャッシュによる代替手段
キャッシュサーバーをまだ用意していない場合は、--disk_cacheを指定して、Bazelがローカルディレクトリを使うようにできます。actions/cacheで保存してください。
- uses: actions/cache@v6
with:
path: ~/.cache/bazel-disk
key: bazel-${{ runner.os }}-${{ hashFiles('MODULE.bazel', 'MODULE.bazel.lock', '.bazelversion') }}-${{ github.sha }}
restore-keys: |
bazel-${{ runner.os }}-${{ hashFiles('MODULE.bazel', 'MODULE.bazel.lock', '.bazelversion') }}-
- run: bazel build --disk_cache=~/.cache/bazel-disk //...
ディスクキャッシュは、デフォルトでは際限なく増え続けます。Bazel 7.4以降のドキュメントでは、ガベージコレクション用のフラグ--experimental_disk_cache_gc_max_sizeと--experimental_disk_cache_gc_max_ageが紹介されています。いずれかを設定してください。設定しないと、リポジトリの10 GB上限に達し、エビクションが発生します。詳しくはキャッシュの上限をご覧ください。
影響を受けるターゲットのみの実行: ターゲット判定
大規模なモノレポでは、キャッシュを使っていても、PRごとにbazel test //...を実行すると時間がかかります。数千ものターゲットの解析とキャッシュ参照が積み重なるためです。ターゲット判定を使うと、二つのコミット間で変更されたターゲットを特定できます。
オープンソースのTarget Determinator(bazel-contrib/target-determinator、2026年10月確認)は、変更前のリビジョンを受け取り、現在チェックアウトされているリビジョンを基準に、影響を受けるターゲットを1行に1つずつ標準出力に表示します。リリース版のバイナリとして提供されています。そのREADMEには、影響を受けるテストを直接実行するdriverバイナリについても記載されています。また、デフォルトではmanualタグが付いた影響を受けるテストをスキップします。
- uses: actions/checkout@v6
with:
fetch-depth: 0
- name: Find affected targets
run: |
BASE=$(git merge-base origin/${{ github.base_ref }} HEAD)
./tools/target-determinator -bazel bazel "$BASE" > affected.txt
- name: Test affected
run: |
if [ -s affected.txt ]; then
bazel test --config=ci --target_pattern_file=affected.txt
fi
ダウンロードしたバージョンの正確なコマンドラインは、READMEで確認してください。フラグの一覧(-bazel、-bazel-opts、-targets、-working-directory)と、位置引数である変更前リビジョンの指定方法が記載されています。ダウンロードするバージョンを固定し、チェックサムを検証してください。
このツールは二つのリビジョンを比較するため、ベースコミットがローカルに存在している必要があります。そのため、fetch-depth: 0を使用してください。また、精度はビルドグラフの精度に依存する点にも注意してください。MODULE.bazel、.bazelrc、またはツールチェーンへの変更は、正当にすべてに影響します。
影響を受けるターゲットのみの実行は必要でしょうか。リモートキャッシュがウォーム状態であれば、影響を受けないターゲットはキャッシュヒットとなり、数秒で完了します。そのため、小規模から中規模のリポジトリでは、通常のbazel test //...の方が単純で、速度も同等です。解析時間そのものがボトルネックになっている場合にのみ、ターゲット判定を追加してください。
シャーディングと並列化
Bazelは--jobsによってアクションを複数のコアで並列実行します。このデフォルト値はCPUに基づいて決まります。マシンの性能を上げると、キャッシュなしのビルドが直接速くなります。Bazel内でテストをシャーディングする場合は、テストルールにshard_countを指定します。複数のマシンに分割する場合は、次の方法があります。
- ターゲットグループ単位のマトリクス。テストターゲットを問い合わせて一覧を分割し、各スライスを個別のジョブで実行します。すべてのジョブはリモートキャッシュを共有します。
- リモート実行。Bazelはアクションをリモートクラスターで実行できます(
--remote_executor)。1台のマシンを超えて拡張できますが、インフラの整備と密閉性の高いビルドが必要です。
strategy:
matrix:
slice: [0, 1, 2, 3]
steps:
- run: |
bazel query 'kind(".*_test", //...)' --output=label | sort > all.txt
split -n l/4 -d all.txt part-
bazel test --config=ci --target_pattern_file=part-0${{ matrix.slice }}
スライスの所要時間に基づく分散については、GitHub Actionsでのテストシャーディングをご覧ください。
完全なワークフロー
name: CI
on:
push:
branches: [main]
pull_request:
jobs:
bazel:
runs-on: [self-hosted, Linux, compiler-ci] # or ubuntu-latest
timeout-minutes: 30
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 0
- name: Build and test (PR, read-only cache)
if: github.event_name == 'pull_request'
run: bazel test --config=ci //...
- name: Build and test (main, writes cache)
if: github.event_name == 'push'
run: bazel test --config=ci-write //...
Bazelはメモリや CPU を多く消費します。compiler.dev 固有の変更点は runs-on の行だけです。これにより、同じワークフローを 8 vCPU、16 GB のマシン上で、1 分あたり $0.008 で実行でき、Bazel のジョブはコア数に合わせて拡張されます。より大きなサイズ(16 vCPU および 32 vCPU)も利用できます。料金とランナーサイズの選択画面をご覧ください。
よくある間違い
- 非密閉なアクション。時刻、ネットワーク、またはホスト環境を読み取るアクションは、マシンごとに異なる出力を生成し、共有を妨げます。キャッシュではなく、アクションを修正してください。
- すべてのユーザーが書き込み。一つの不正なエントリが広がってしまいます。書き込みは制限してください。
- ターゲット判定を使う場合の浅いクローン。ベースコミットが存在しません。
- 上限のないディスクキャッシュ。他のキャッシュを押し出してしまいます。
- ランナーごとに異なるツールチェーン。
.bazelversionでBazelを、MODULE.bazelでツールチェーンを固定してください。
リポジトリの一部がJavaScriptの場合は、NxやTurborepoとの比較もご検討ください。
よくある質問
CIでBazelを使うにはリモートキャッシュが必要ですか。
実質的にははい。リモートキャッシュがないと、新しいランナーのたびにゼロからビルドし直すことになります。actions/cache によるディスクキャッシュは、あくまで一時的な対策です。
ターゲット決定は必要ですか?
いいえ。リモートキャッシュがウォームであれば、//... の大半はキャッシュヒットになります。対象となるターゲットグラフが巨大で解析に時間がかかる場合に効果を発揮します。
PR はリモートキャッシュにアップロードすべきですか?
アップロードしないほうが安全です。信頼できる main のビルドで書き込み、PR では読み取るだけにしてください。
CI マシンはどのくらいの大きさにすべきですか?
Bazel は与えられたコアをすべて使用します。メモリや I/O がボトルネックになるまでは、コアを増やすとコールドビルドの速度がほぼ線形に向上します。ご利用のリポジトリで計測して判断してください。
関連記事
- GitHub ActionsでTypeScriptモノレポを高速化するGitHub Actionsで TypeScriptモノレポの型チェックとリンターを高速化する: インクリメンタルtsc、プロジェクト参照、Lintキャッシュ、並列ジョブ
- GitHub ActionsでモノレポのPlaywrightを高速化するGitHub Actions で Node モノレポの Playwright E2E テストを高速化: アプリを一度だけビルドし、Web アプリに変更がないときは E2E をスキップし、シャーディングとレポートのマージを行います。
- GitHub ActionsでNxモノレポを最速でCIするGitHub Actions で Nx の CI を高速化。nx-set-shas を使った nx affected、Nx リモートキャッシュ、タスク分散、fetch-depth、完全なワークフローを紹介します。
- GitHub ActionsでpnpmワークスペースのCIを最速化するGitHub Actions 上の pnpm ワークスペース向けの高速な CI。変更されたパッケージのフィルタリング、ストアのキャッシュ、fetch-depth、マトリックスによるシャーディング、そしてそのままコピーして使える完全なワークフローを紹介します。