GitHub Actionsが遅いのはなぜですか?原因と対処法
最終更新
GitHub Actionsが遅いとき、原因は「GitHubが停止している」ことであるケースはまれです。多くは、キューの待ち時間、小さいランナー、キャッシュのコールドスタート、ダウンロードの遅さが組み合わさったものです。このガイドでは、自分の環境で何が原因になっているかを、「今日はGitHub Actionsが遅い」のように自分側で何も変更していない場合も含めて特定できるよう支援します。遅いCIのガイドの一部です。
まず確認: GitHubが今日遅いのか
githubstatus.comを確認してください。劣化したパフォーマンスやジョブの遅延を含め、Actionsに関するインシデントが一覧されます。インシデントが発生中であれば、キューの待ち時間と実行時間が影響を受けている可能性が高く、ワークフロー自体は問題ありません。その他の簡単な確認方法は次のとおりです。
- 同じワークフローの直近10回の実行を開いてください。ワークフローへのコミットがないのに、同じ日にすべてのジョブの実行時間が急に伸びている場合は、プラットフォームや変更された依存関係を疑ってください。
- キュー待ち時間(ジョブ開始前)とステップの実行時間を比較してください。プラットフォームの問題は通常、ステップ時間ではなくキュー時間に表れます。
ステータスが正常で遅さが安定している場合は、読み進めてください。「今日は遅い」と感じる問題の多くは、毎日遅いものです。
原因1: キュー時間
開始前に待機しているジョブは、遅いのではなくキューに入っている状態です。主な理由は次のとおりです。
- プランの同時実行数の上限に達しており、ほかのジョブの完了を待っている。大規模なマトリックスは状況を悪化させます。GitHubはマトリックスあたりの最大ジョブ数を256と文書化しています。
- scheduleやcronジョブが毎時0分に起動し、その時間帯はGitHubの負荷が最も高くなる。
- セルフホステッドランナーがオフライン、使用中、またはキャパシティ不足になっている。セルフホステッドのジョブは、キャンセルされるまで最長24時間待機することがあります。
- 大きいランナーに対して自動スケールの上限が低い。
修正方法としては、マトリックスの幅を下げるかmax-parallelを使用する、concurrencyで置き換えられた実行をキャンセルする、スケジュールされたジョブを:00から外す、そしてランナーの容量を追加する、といった方法があります。ドキュメントに記載された上限については、実行時間制限のガイドをご覧ください。
原因2: 小さい2コアランナー
標準のLinuxランナーは2 vCPU、7 GB RAMです(ランナースペックツールを参照)。CPUに依存するテストスイート、TypeScriptのビルド、Dockerビルドは、ノートPCよりも時間がかかります。兆候としては、ジョブ中にCPUがほぼ100%に張り付く、ワーカーを増やすとテストが遅くなる、メモリ不足によるプロセス強制終了などがあります。
対処法は、手間のかからないものから順に試してください。インクリメンタルビルドを使い、並列ワーカー数をコア数より少なくする。テストをシャーディングする。それでも足りなければ、重いジョブをより多くのコアを持つランナーに移す。より速いGitHub Actionsランナーでは、GitHubの大型ランナー、セルフホステッド、サードパーティのランナーを比較しています。ホステッドの選択肢については、compiler.devは測定した18スタックにおいて、GitHubの2コアランナーに比べて中央値で1.5×速く(15件が高速、2件が同等、1件が低速)、Linux 8 vCPUで1分あたり$0.008です。比較モードを使って、自分のジョブで実際に試してみてください。
原因3: コールドキャッシュ
npm ci、pip install、Dockerビルドが毎回3分かかる場合、キャッシュが存在しないか、削除されています。キャッシュステップのログで「Cache not found」や「Cache restored」を確認してください。GitHubはデフォルトでリポジトリあたりのキャッシュ容量を10 GBに制限し、上限を超えると削除します。そのため、利用頻度の高いリポジトリでは自分のキャッシュを頻繁に作り直すことがあります。キャッシュの上限と削除およびキャッシュの基本を参照してください。Dockerビルドには、Dockerレイヤーキャッシュに別のオプションがあります。
原因4: ネットワークと遅いダウンロード
ダウンロードのステップが遅い(「GitHub Actionsのダウンロードが遅い」)原因は次のとおりです。
- Docker Hubから大きなベースイメージを取得している。匿名のpullはレート制限される場合があります。レジストリミラーからpullするか、より小さいベースイメージを使用してください。
- 実行のたびにツールチェーンやブラウザ(Playwrightのブラウザ、JDK、Xcodeシミュレーター)をダウンロードしている。必要なものだけをインストールし、再ダウンロードより速い場合はキャッシュしてください。
- Gitの履歴全体を取得している。履歴が不要な場合は
fetch-depth: 1を使用してください。 - 外部レジストリやパッケージミラーが遅い。ランナーの近くに依存関係のプロキシを置くと効果があります。
- uses: actions/checkout@v4
with:
fetch-depth: 1
原因5: 作業そのもの
キューとセットアップの時間が短い場合は、テストやビルドが問題です。フレームワークごとのガイド: Playwright、Cypress、Jest、Vitest、pytest、および遅いE2Eテストのハブ。
5分でできる診断
- githubstatus.comを開く。
- 遅い実行を開き、キュー時間と、最も時間のかかっている上位3つのステップを確認する。
- キュー時間が長い場合: 同時実行数、マトリックス、スケジュール、ランナーを確認する。
- インストールやダウンロードが長い場合: キャッシュとイメージサイズを確認する。
- テストやビルドが長い場合: 並列化、シャーディング、ランナーのサイズを確認する。
高速化ガイドでは、それぞれの発見事項をYAMLの変更として説明しています。
よくある質問
今日GitHub Actionsが遅いのはなぜですか?
まずgithubstatus.comでActionsのインシデントがないか確認してください。インシデントがなければ、直近の実行でキュー時間とステップ時間を比較してください。キュー時間が急に伸びている場合は、プラットフォームの負荷または同時実行数の上限が原因である可能性があります。
ノートPCよりGitHub Actionsが遅いのはなぜですか?
デフォルトのLinuxランナーは2 vCPUで、ディスクとキャッシュがコールドな状態です。お使いのノートPCは、コア数がはるかに多く、キャッシュもウォームである可能性が高いです。
GitHub Actionsのダウンロードが遅いのはなぜですか?
多くの場合、大きなイメージやツールチェーンを実行のたびにダウンロードしていることが原因です。キャッシュする、サイズを縮小する、またはミラーリングしてください。
大きなランナーに課金すれば解決しますか?
ジョブが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にも対応しています。