コンテンツへスキップ

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で連鎖させることができます。

ジョブが上限に達するとどうなりますか?

ジョブは強制終了され、失敗としてマークされます。それ以前に生成されたキャッシュやアーティファクトは残ります。

このワークフローを compiler.dev で実行する カード登録不要 · 200 無料分

無料で試す