GitHub ActionsでBazelを高速化する
最終更新
GitHub ActionsでBazelを高速化するには、実行をまたいでBazelのキャッシュを保持します。bazel-contrib/setup-bazelを使うと、Bazelisk、リポジトリキャッシュ、ディスクキャッシュをキャッシュでき、リポジトリが大きい場合はリモートキャッシュに移行できます。Bazelは再現可能なキャッシュ済みアクションを中心に設計されていますが、保存しなければ新しいCI VMはそのすべてを捨ててしまいます。
このガイドでは、手間の少ない順にオプションを紹介します。全体像については、GitHub Actionsを高速化する方法をご覧ください。
キャッシュなしのBazelビルドにかかるコスト
クリーンなマシンでは、Bazelは3つの負荷の高い処理を行う必要があります。Bazelelisk経由でBazel自体をダウンロードすること、外部リポジトリ(ルール、ツールチェーン、サードパーティのコード)を取得すること、そしてすべてのアクションを実行することです。それぞれに独自のキャッシュがあり、個別に保存する必要があります。最初の2つは簡単です。大きな効果と重要な判断が必要になるのは3つ目です。
setup-bazelで共通部分を処理する
bazel-contrib/setup-bazelは、コミュニティが管理しているアクションです。そのREADMEでは、以下の入力項目が説明されており、いずれもデフォルトでは無効になっています。
bazelisk-cache: Bazeliskのダウンロードをキャッシュします。キーは.bazelversionです。repository-cache: Bazelのリポジトリキャッシュをキャッシュします。キーはMODULE.bazelとWORKSPACEファイル、または指定したファイルです。disk-cache: BazelのディスクキャッシュをGitHubのキャッシュに保存する形で有効にします。trueまたは、キャッシュを分けるための文字列を指定できます。たとえばワークフローごとに分けられます。external-cache: 10 MBを超えるexternal/のリポジトリをキャッシュします。bazelrc: ユーザーのbazelrcに書き込む追加の行を、複数行のYAMLとして指定します。cache-save: 最後に保存するかどうかを指定します。READMEではプルリクエストに対してfalseにすることを推奨しています。
- uses: actions/checkout@v7
- uses: bazel-contrib/setup-bazel@0.19.1
with:
bazelisk-cache: true
disk-cache: ${{ github.workflow }}
repository-cache: true
cache-save: ${{ github.ref_name == 'main' }}
bazelrc: |
build --config=ci
- run: bazel test //...
READMEの例にあるバージョンは、2026年10月に確認した時点では0.19.1でした。このアクションは移動するメジャーバージョンではなく正確なタグでバージョン管理されているため、現在のタグはリリースページでご確認ください。
ディスクキャッシュを有効にすると、Bazelはアクションの出力をコンテンツのハッシュで保存します。前回保存したキャッシュ以降にアクションの入力が変わっていなければ、Bazelはアクションを実行せず出力をコピーします。GitHubのキャッシュにはサイズ上限があるため、GitHub Actionsのキャッシュ上限をご覧ください。大規模なモノレポのディスクキャッシュは、そこに保持する意味がある量を超えることがあります。そこで次のオプションが候補になります。
大規模リポジトリ向けのリモートキャッシュ
リモートキャッシュは、アクションの結果を全員向けに保存するサーバーです。CI、ノートPC、プルリクエストから利用できます。BazelはHTTPまたはgRPCで通信します。
# .bazelrc
build:ci --remote_cache=grpcs://cache.example.com
build:ci --remote_upload_local_results=false
build:ci --remote_timeout=60
一般的な方法は、信頼できるCIジョブだけがmainからアップロード(--remote_upload_local_results=true)し、プルリクエストは読み取りのみにすることです。これにより、壊れた結果や途中までしか作られていない結果が混入するのを防げます。選択肢には、bazel-remoteのようなセルフホストサーバー、お使いのストレージバケット、商用サービスなどがあります。認証情報はシークレットとして保存し、--remote_headerまたは認証ヘルパーで渡してください。特定のベンダーはお勧めしません。CIマシンからの価格、リージョン、読み取り速度で比較してください。
リモート実行はさらに進んだ方法で、アクションをワーカーのプールで実行します。非常に大規模なビルドでは効果がありますが、実際のインフラが必要です。まずはキャッシュから始めてください。
CIで重要なフラグ
build:ci --jobs=auto
build:ci --keep_going
build:ci --show_timestamps
build:ci --test_output=errors
build:ci --disk_cache=~/.cache/bazel-disk
--jobsは、同時に実行するアクションの数を指定します。デフォルトはCPU数に基づきます。アクションがCPU依存の場合はautoが適しています。I/Oやネットワーク(リモートキャッシュ)に依存する場合は、より大きい値が有効なことがあります。--keep_goingは、可能な限り多くのターゲットをビルドし、すべての失敗を1回の実行で報告します。再実行の回数を減らせます。--test_output=errorsは、ログを短く保ちます。--local_resourcesはメモリの使用量を制限します。Bazelは7 GBのランナーで多くのメモリを使うことがあります。終了コード137でジョブが強制終了された場合はメモリ不足です。終了コード137をご覧ください。
ターゲットの選択で実行量を減らす
Bazelの依存関係グラフを使うと、変更が影響する範囲を正確に把握できます。bazel-diffなどのツールは2つのコミット間で影響を受けるターゲットを計算するため、プルリクエストでは変更された部分だけにbazel testを実行できます。大規模なモノレポでは、キャッシュの調整よりも効果が大きいことがよくあります。他のモノレポツールについては、NxやTurborepoを使ったモノレポのCIをご覧ください。
テストのシャーディング
Bazelは、BUILDルールのshard_countで1つのテストターゲットを分割し、デフォルトではテストターゲットを並列に実行します。1つのターゲットがボトルネックになっている場合は、shard_countを増やし、テストフレームワークがBazelのシャーディングプロトコルに対応していることを確認してください。複数のマシンにまたがる場合は、ターゲットの一覧をマトリックスで分割します。GitHub Actionsでのテストシャーディングをご覧ください。
CPU コア数を増やす効果
Bazelは多数の独立したアクションを同時に実行するため、追加のコアを最もよく活用するツールの1つです。キャッシュが温まっていればほとんどのアクションはスキップされるため、コア数は変更された部分で効きます。2 vCPUのランナーでのCIのコールドランは、CPUに制限されます。ベンチマークにBazelの項目はないため、数値は示しません。確実な検証方法は、キャッシュを温めた状態で同じbazel test //...を2つのマシンサイズで実行し、コスト計算ツールで1回あたりのコストを比較することです。
compiler.devでは、ジョブはデフォルトで8 vCPU / 16 GBのマシンで実行されます。2、4、16、32 vCPUも利用できます。変更は1行で、runs-on: [self-hosted, Linux, compiler-ci]です。料金をご覧ください。
よくある質問
GitHub ActionsでBazeliskは必要ですか?
setup-bazelはBazeliskをインストールします。Bazeliskは.bazelversionを読み取り、適切なBazelをダウンロードします。bazelisk-cache: trueでキャッシュできます。
ディスクキャッシュとリモートキャッシュのどちらを使うべきですか?
まずはsetup-bazelで保存するディスクキャッシュから始めてください。リポジトリが大きい場合、GitHubのキャッシュが一杯になる場合、または開発者とCIで結果を共有したい場合は、リモートキャッシュに移行してください。
CIでBazelのキャッシュがまったくヒットしないのはなぜですか?
通常は、実行ごとに入力が異なるためです。絶対パス、タイムスタンプ、環境変数、非ヘルメティックなツールチェーンなどが原因になることがあります。--explainと--verbose_explanationsで確認できます。
プルリクエストはキャッシュに書き込むべきですか?
setup-bazelのREADMEでは、プルリクエストにcache-save: falseを推奨しています。mainで書き込み、プルリクエストでは読み取るようにしてください。
関連記事
- 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でBazelモノレポを最速でCIするGitHub Actions での高速な Bazel CI。影響を受けるビルドのためのターゲット判定、リモートキャッシュのフラグ、PR からの読み取り専用アップロード、シャーディング、完全なワークフローを紹介します。