GitHub Actions の実行時間制限: ジョブごとに 6 時間、35 日 (2026 年)
最終更新 · 初回公開
GitHub Actionsの時間制限は、GitHubホステッドランナーではジョブあたり6時間、ワークフロー実行あたり35日です。そのほかにも、知らないと遅さのように見える制限がいくつかあります。このガイドでは、公式に文書化された制限(2026-10-11にGitHubの利用制限ページで確認)を一覧にし、より短いタイムアウトの設定方法を示します。さらに、ジョブ、ステップ、ワークフロー全体を意図的に遅らせる方法も扱います。関連する内容はCIが遅い場合のガイドにあります。
重要な制限
| 制限 | 値 |
|---|---|
| ジョブの実行時間(GitHubホステッドランナー) | 6時間。ジョブは終了され、失敗します |
| ワークフロー実行時間 | 35日。実行はキャンセルされます(キュー待ちと承認待ちの時間を含む) |
| ジョブのキュー待ち時間(セルフホストランナー) | 24時間。その後キャンセルされます |
| マトリックスのサイズ | ワークフロー実行あたり256ジョブ |
| トリガーされるワークフロー実行数 | リポジトリあたり10秒で500回 |
| 環境での承認 | 実行は最長30日間待機することがあります |
制限は変更されることがあるため、最新の数値はGitHubの利用制限に関するドキュメントで確認してください。実際によく問題になるのはジョブの制限です。ジョブが6時間に近づいている場合は別の問題が起きているので、その解決策はシャーディングやマトリックスです。
より短いタイムアウトを設定する
ジョブのデフォルトのtimeout-minutesは360で、これは同じ6時間です。ハングしたテストがあると、課金対象の時間を6時間分消費してしまいます。通常の実行時間のおよそ2倍程度のタイムアウトを設定してください:
jobs:
test:
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- run: npm ci
- run: npm test
timeout-minutes: 10 # steps can have their own timeout
タイムアウトを設定すると、ジョブはきれいに失敗し、課金も止まります。concurrencyと組み合わせると、置き換えられた古い実行をキャンセルできます(高速化ガイド)。ワークフローYAMLチェッカーでは、タイムアウトの未設定を検出できます。ジョブが定期的にタイムアウトに達する場合は、GitHub Actionsが遅いとE2Eテストが遅いを参照してください。
ステップを遅らせる方法
最も簡単な遅延はシェルコマンドです:
- name: Wait for deploy to settle
run: sleep 60
これは課金対象の時間を消費するため、控えめに使ってください。より良い方法は、固定の時間を待つのではなく、タイムアウト付きで条件を待つことです:
- name: Wait for the service
run: |
for i in $(seq 1 30); do
curl -fsS https://staging.example.com/health && exit 0
sleep 10
done
exit 1
ジョブを遅らせる方法
ジョブはneedsで指定したジョブが完了すると開始します。特定のジョブを遅らせるには、待機するジョブを追加し、次のジョブがそれに依存するようにします。待機中にランナー時間を支払わずに済む方法は次の2つです:
- 待機タイマー付きの環境。リポジトリの設定で、最大43,200分(30日)の待機タイマーと、任意で必須レビュアーを設定した環境(例:
production)を作成します。その環境を参照するジョブは、ランナーを使わずに待機します:
jobs:
deploy:
runs-on: ubuntu-latest
environment: production # wait timer and approvals configured in settings
steps:
- run: ./deploy.sh
環境の待機タイマーは、パブリックリポジトリで利用できるほか、対応プランのプライベートリポジトリでも利用できます。ご利用のプランを確認してください。
- 同時実行グループで遅らせるのではなく直列化します。
concurrency: group: deployを指定すると、次の実行は現在の実行が終わるまで待ちます。
ワークフローを遅らせる方法
- スケジュールする。
on: scheduleを使い、将来の時刻に実行します。スケジュールはUTCで動作し、特に毎時の開始時には負荷によって遅れることがあります。構文と「スケジュールが実行されない」問題についてはcronスケジュールを参照してください。最短の間隔は5分ごとです。 - 後で発行する。別のワークフローや外部のスケジューラーから、APIまたは
gh workflow runを使ってworkflow_dispatchを呼び出し、任意の時刻に実行できます。 - 別のワークフローを待つ。
workflow_runトリガーは、別のワークフローが完了したときに開始します。時計による遅延ではなく、依存関係による遅延です。
制限に見える予期しない遅延
- 実行されずキュー待ち:空いているランナーがない、または同時実行の上限に達しています。セルフホストのジョブは最大24時間キューに入ります。
- cronの遅れ:負荷が高いと、スケジュールされた実行が数分遅れて開始することがあります。
- 承認:レビュアーの承認を待っている実行も、35日のワークフロー制限に含まれます。
- レート制限されたアクション:サードパーティのAPIが429を返すと、リトライループがスリープします。合計のタイムアウトを設定してください。
多くのジョブがランナーを待っている場合は、キャパシティを増やすか、より高速なランナーを使うと、ジョブがスロットを占有する時間を減らせます。高速なGitHub Actionsランナーを参照してください。compiler.devは、測定した18のスタックでGitHubの2コアランナーより中央値で1.5倍速く(15が高速、2が同等、1が低速)、自前のランナーに自動的にフォールバックします。
課金に関する注意
sleepのように、ランナーを占有する遅延は、GitHub Actionsの料金の解説に記載されたレートでランナー時間として課金されます。環境の待機タイマーはランナーを占有しません。
よくある質問
GitHub Actionsのタイムアウト上限は?
GitHub-hosted ランナーでは、ジョブごとに6時間、ワークフロー実行ごとに35日です。timeout-minutesをより小さく設定すると、応答しないジョブを早めに停止できます。
GitHub Actionsのジョブを遅延させるには?
待機タイマーを設定した環境を使うか、待機する前のジョブに依存させる方法があります。短い待機であれば、ステップでsleepを使うこともできますが、課金対象の時間が消費されます。
ワークフローを遅延させるには?
on: scheduleでスケジュール設定するか、workflow_dispatchで後から手動でトリガーするか、workflow_runで連鎖させることができます。
ジョブが上限に達するとどうなりますか?
ジョブは強制終了され、失敗としてマークされます。それ以前に生成されたキャッシュやアーティファクトは残ります。
関連記事
- GitHub Actionsのキャッシュの上限、サイズ、削除ルールGitHub Actionsのキャッシュ上限とサイズを解説します。10 GBの上限、削除の仕組み、キャッシュが遅くなる原因、pnpmやDockerイメージ、cache v4の詳細を説明します。
- GitHub ActionsでTypeScriptモノレポを高速化するGitHub Actionsで TypeScriptモノレポの型チェックとリンターを高速化する: インクリメンタルtsc、プロジェクト参照、Lintキャッシュ、並列ジョブ
- GitHub ActionsでモノレポのPlaywrightを高速化するGitHub Actions で Node モノレポの Playwright E2E テストを高速化: アプリを一度だけビルドし、Web アプリに変更がないときは E2E をスキップし、シャーディングとレポートのマージを行います。
- READMEにCIの速度バッジを追加するREADME のバッジで CI の速さを表示しましょう。リポジトリの GitHub Actions 実行時間の中央値が自動で更新されます。公開リポジトリは無料です。