CIが遅い場合:CIパイプラインの時間を短縮する方法
最終更新
遅い CI は、すべてのプルリクエストにかかる税のようなものです。CI パイプラインが遅いと、開発者は待ち時間に別の作業へ切り替え、変更のまとまりは大きくなり、人々が緑のチェックを待たなくなるため、バグが main に届いてしまいます。このガイドは CI 時間を短縮するための起点となるページで、CI のビルド時間を計測する方法、最初に効果が出る改善策、そして各改善策の詳細へのリンクをまとめています。
CI パイプラインが遅いのはなぜですか?
CI/CD のビルド時間は次の 4 つの合計で、それぞれに異なる対処法があります。
- キュー待ち時間: ジョブがランナーの空きを待つ時間です。キャパシティの追加、別のランナープールの利用、同時実行ジョブの削減で対処します。
- セットアップ時間: チェックアウト、ツールチェーンのインストール、依存関係のインストール、Docker イメージのプルなどの時間です。キャッシュの利用と、より小さいイメージで対処します。
- 作業時間: コンパイル、リント、テストの時間です。並列化、シャーディング、インクリメンタルビルド、テストの選択で対処します。
- 後処理時間: アーティファクトのアップロード、レポートの統合、デプロイ手順、必須チェックの完了待ちなどの時間です。
何かを変更する前に、最も遅いワークフローについてこれら 4 つの数値を書き出してください。Actions の UI では各ステップの所要時間が表示され、実行の概要ではキュー待ち時間を確認できます。多くのチームでは、いずれか 1 つの区分が合計の半分以上を占めていることがわかります。それを金額に換算したい場合は、CI 遅延のコスト計算ツールで待ち時間にチーム人数と時給を掛けて算出できます。
CI 時間を短縮する: 効果の大きい順に並べた改善策
1. 不要な作業の実行をやめる
パスフィルター、cancel-in-progress付きのconcurrencyグループ、ドキュメントのみの変更のスキップは、コストがかからず、多くの場合、実行回数の20〜40%を削減できます。モノレポでは、変更された部分のみをビルドしてください。詳しくはモノレポCIガイドを参照してください。
concurrency:
group: ci-${{ github.ref }}
cancel-in-progress: true
on:
pull_request:
paths-ignore: ["docs/**", "**.md"]
2. 依存関係とビルド成果物をキャッシュする
パッケージキャッシュの復元は、ダウンロードし直すより almost 必ず速くなります。ロックファイルのハッシュをキーにしてください。基本はキャッシュガイドに、上限(リポジトリあたり 10 GB、削除の仕組み、pnpm や Docker 固有の事項)はGitHub Actions のキャッシュ上限にまとめています。コンテナのビルドについては、Docker レイヤーキャッシュを参照してください。
3. テストスイートを分割する
シャーディングは、テストスイートを複数の並列ジョブとして実行します。経過時間はおおむねシャード数に比例して短くなり、課金される分数はわずかに増えます。テストシャーディングガイドでは主要なフレームワークをすべて扱っており、テストシャーディングプランナーでシャード数を決められます。フレームワーク別のアドバイスは次のとおりです。
ブラウザーを使うスイート全般については、遅い E2E テストの柱記事をお読みください。
4. 不安定なテストを修正する。リトライは隠れた遅さだからです
フレーク率 5 パーセントのスイートは、頻繁に再実行されます。再実行のたびに経過時間が積み重なります。不安定なテストの発見と封じ込めを、ブラウザーを使うスイートの場合は不安定な E2E テストを参照してください。
5. 適切なテストの組み合わせを使う
すべてが E2E テストのスイートは、構造上遅くなります。ユニットテストと E2E テストの比較ガイドでは、フィードバックを 10 分以内に保つテストピラミッドを紹介しています。
6. より大きい、または速いランナーを使う
作業時間が大半を占め、ジョブが CPU に依存している場合は、ハードウェアの強化も正当な対処法です。GitHub の標準 Linux ランナーは 2 vCPU です。選択肢は GitHub の larger runners、セルフホストのマシン、サードパーティのランナープロバイダーです。高速な GitHub Actions ランナーガイドでは、公開価格(日付入り)を用いて比較しています。運用上のトレードオフはセルフホスト対 GitHub ホステッドで扱っています。
今日は GitHub 側が遅いのですか?
そういう場合もあります。キューの遅延やパフォーマンス低下は実際に起こり、githubstatus.com で報告されます。GitHub Actions が遅いガイドでは、プラットフォームの障害と、ご自身のワークフローにある問題を切り分けて説明しています。
制限と請求額を理解する
遅いパイプラインと高額なパイプラインは、たいてい同じ原因を共有しています。実行時間の制限と遅延、料金体系、そして Actions の請求額を減らす方法を把握してください。プラットフォームの変更を検討している場合は、GitHub Actions の代替サービスで、多くのチームが Actions を維持したままランナーを変更する理由を説明しています。また、Blacksmith と GitHub Actions の比較では、ひとつのプロバイダーを公平な視点で評価しています。パイプラインを高速化すると利用量がどう変わるかは、CI 分数の予測ツールで確認できます。
30 分でできる計画
- 最も遅い必須ワークフローを選びます。直近 5 回の実行から、キュー、セットアップ、作業、後処理の各時間を記録します。
concurrencyとパスフィルターを追加します。- 依存関係のキャッシュを追加または修正し、ログでヒット率を確認します。
- テストジョブをシャーディングします。4 シャードから始め、プランナーを使って調整します。
- 再計測します。そのうえで初めてより大きいランナーを試し、ベンダーのベンチマークではなく、ご自身のジョブで測定してください。
compiler.devの位置づけ
compiler.dev は、既存の GitHub Actions ジョブをより高速なマシンで実行します。18 の計測対象スタックで、GitHub の 2 コアランナーと比べた中央値は 1.5 倍の高速化でした(15 件が高速、2 件が同等、1 件が低速)。Linux 8 vCPU は 1 分あたり $0.008、macOS M4 Pro は 1 分あたり $0.028 です。必要に応じてご自身のランナーへ自動的にフォールバックします。比較モードではご自身のジョブを計測するため、当社の数値ではなくご自身の数値に基づいて判断できます。上記の無料の改善策の代わりではなく、それらを行ったうえで活用してください。
よくある質問
なぜ CI パイプラインはこんなに遅いのですか?
通常は次の4つのいずれかが原因です。キューでの待ち時間、依存関係のセットアップ、テスト実行そのもの、または不安定なテストによる再試行です。変更を加える前に、各項目を実行ごとに計測してください。
ランナーを変えずにCI時間を短縮するには?
置き換えられた実行をキャンセルし、関係のないパスをスキップし、依存関係をキャッシュし、テストを分割し、不安定なテストを修正してください。これらは無料で実施でき、通常は3分の1以上の時間を削減できます。
CIのビルド時間はどのくらいが適切ですか?
多くのチームは、必須のPRチェックを10分未満にすることを目標にしています。開発者がその完了を待つためです。より長いスイートは並列で実行するか、遅いチェックをマージ時や夜間の実行に移してください。
より高速なランナーを使えば、CIは必ず速くなりますか?
いいえ。CPUを多く使うコンパイルやテスト実行には効果がありますが、キューでの待ち時間、ネットワークダウンロード、外部サービスの応答待ちにはほとんど効果がありません。
関連記事
- CIでDockerビルドが遅い?原因を特定して解決CIでDockerビルドが遅いですか?ビルドコンテキストのサイズ、.dockerignore、レイヤーの順序、キャッシュミス、BuildKitの設定を診断し、最も影響の大きい問題から修正しましょう。
- Cypressのテストが遅い?Cypressを高速化する方法CIでCypressのテストが遅いですか?cy.session、インターセプト、固定待機の廃止でCypressを高速化する方法と、GitHub ActionsでのCypress並列テストを解説します。
- Jestが遅い? Jestテストを高速化する:ワーカーと--shardJestテストが遅いですか? 高速なTypeScript変換、適切なワーカー数、CIでの--shardの利用で高速化できます。まず最も遅いテストを特定してください。設定例も掲載しています。
- CIでPlaywrightのテストが遅い?ワーカーとシャーディングで解決CIでPlaywrightのテストが遅いですか?ワーカー数の増加、storageStateの再利用、ブラウザのキャッシュ、--shardによるテストのシャーディングで高速化できます。Pythonにも対応しています。