360分の最大実行時間を超過: 修正方法
最終更新: · 初回公開:
The job running on runner ... has exceeded the maximum execution time of 360 minutes は、ジョブが6時間(GitHub ホステッドランナーの上限)実行され、GitHubによって強制終了されたことを意味します。ほとんどの場合、ジョブは遅かったのではなく停止していました。テストのハング、入力待ちのプロセス、デッドロックなどが原因です。このページでは、ジョブとステップに対するtimeout-minutesの仕組み、停止した箇所の見つけ方、そして6時間分の分数を消費せずに早期に失敗させる方法を説明します。上限値は2026年10月時点の利用制限のページおよびワークフロー構文に基づいています。
表示される正確なメッセージ
The job running on runner GitHub Actions 5 has exceeded the maximum execution time of 360 minutes.
ランナー名や番号は環境によって異なります。timeout-minutesをより小さい値に設定している場合、メッセージの数値は360ではなくその設定値になります。タイムアウトしたステップはキャンセル扱いになり、場合によってはThe operation was canceledと表示されます(そのページを参照してください)。
上限値
- GitHub ホステッドジョブ: 上限は6時間です。上限に達したジョブは終了され、失敗となります。
- セルフホステッドジョブ: 上限は5日間です。
- ステップの
timeout-minutes: ホステッドランナーとセルフホステッドランナーのいずれも最大360です。 - ワークフローの実行: 待機時間と承認時間を含めて35日間です。上限に達した実行はキャンセルされます。
- セルフホステッドランナーのジョブキュー待機時間: 24時間を超えるとキャンセルされます。
ジョブにtimeout-minutesを設定しない場合、ジョブはホステッドランナーの既定値である最大360分まで実行され得ます。大規模ランナーで6時間停止したジョブは高額になります。8コアの料金で6時間は決して小さくありません。実行時間の上限と料金を参照してください。
timeout-minutesの仕組み
ジョブレベル
jobs:
test:
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@v4
- run: npm ci
- run: npm test
ジョブが20分を超えると、GitHubはそのジョブをキャンセルし、if: always()またはif: cancelled()を指定したステップをベストエフォートで実行したうえで、ジョブを失敗としてマークします。
ステップレベル
steps:
- run: ./integration-tests.sh
timeout-minutes: 10
ステップは10分後に強制終了されます。ステップにcontinue-on-error: trueが指定されていない限り、ジョブは失敗します。ステップのタイムアウトはジョブのタイムアウトを延長しません。ジョブレベルの上限は合計時間に対して引き続き適用されます。
マトリックスジョブ
timeout-minutesはマトリックスの各ジョブに個別に適用されます。あるセルがタイムアウトすると、他のセルでfail-fastによるキャンセルが発生する場合があります(詳細はThe operation was canceledを参照してください)。
ジョブが6時間停止したのはなぜか
1. 終わらないテスト
オープンなハンドル、解決されないPromise、デッドロック、またはタイムアウトのないネットワーク呼び出しなどが原因です。ランナー側でテストごとのタイムアウトを追加してください(Jestの--testTimeout、pytest-timeout、go test -timeout 10mなど)。
- run: go test -timeout 10m ./...
- run: pytest --timeout=300
2. 入力を待っているコマンド
インストーラー、apt、ssh、npm initは入力を求めることがあります。非対話型のフラグを使用してください:
- run: sudo apt-get install -y --no-install-recommends build-essential
env:
DEBIAN_FRONTEND: noninteractive
3. ステップを維持し続けるバックグラウンドプロセス
&で起動し停止させなかった開発用サーバーは、その出力が紐付いたままだとステップを開いたままにしてしまいます。出力をリダイレクトし、プロセスを停止させてください:
- run: |
npm run start > server.log 2>&1 &
npx wait-on http://localhost:3000 --timeout 60000
npx playwright test
4. 外部サービスや承認を待っている状態
デプロイ状況を永遠にポーリングするステップや、環境の承認を待つジョブなどです。ポーリングのループには期限を設けてください。
5. メモリ不足のランナー
スラッシングによって全体の処理が極端に遅くなります。終了コード137の兆候と通信の喪失を確認してください。
6. 作業が本当にそれだけ長い場合
正当なジョブが6時間を超える必要がある場合は、ジョブを分割してください(マトリックスやシャーディング。テストのシャーディングを参照)。または、上限が5日間であるセルフホステッドランナーを使用してください。より高速なマシンも有効です。runs-on: [self-hosted, Linux, compiler-ci]に1行変更するだけで、既存のジョブをcompiler.devの8 vCPU / 16 GBのマシンで実行できます。詳しくはベンチマークと料金を参照してください。
停止箇所の特定
- キャンセルされたジョブのログを開いてください。キャンセル直前の最後の行で、どのステップかがわかります。
ACTIONS_STEP_DEBUG変数をtrueに設定して、デバッグログを有効にして再実行してください。- 6時間待たずに済むよう、短いタイムアウトで再現させてください。一時的に
timeout-minutes: 10を設定します。 - 原因と思われるコマンドに
timeoutを追加してください:
timeout 300 ./slow-command.sh || echo "timed out after 300s"
適切な値の設定方法
目安として、通常の所要時間の2〜3倍を設定するとよいでしょう。テストに8分かかるなら、20または25分を設定します。直近の実行履歴を見て、95パーセンタイル(p95)の時間を確認してください。CIの遅延に関するガイドでは通常の所要時間の短縮方法を扱っており、CIの遅さのコスト計算ツールでは停止したジョブのコストを確認できます。
予防方法
- すべてのジョブに
timeout-minutesを設定してください。既定の360分のままにしないでください。 - ハングすることが知られているステップ(E2Eテスト、デプロイのポーリングなど)には、より短い制限を設定します。
- 加えて、テストランナーのタイムアウトも使用すると、役立つスタックトレースを得られます。
- PRには
concurrencyとcancel-in-progressを追加すると、放棄された実行を早期に停止できます。詳しくはActionsの料金を削減するをご覧ください。 - 中央値の2倍を超えるジョブがあれば、アラートを出すように設定します。
よくある質問
GitHub Actionsジョブのデフォルトのタイムアウトは何ですか?
GitHub がホストするランナーでは360分(6時間)です。timeout-minutesを設定すると、そのジョブに対してこの値を短くできます。
上限を360分より引き上げることはできますか?
GitHub がホストするランナーでは引き上げできません。セルフホステッドランナーのジョブは最大5日間実行できます。
ステップのタイムアウトでジョブは失敗しますか?
はい。ただし、そのステップにcontinue-on-error: trueが設定されている場合は除きます。
タイムアウトになった分にも料金はかかりますか?
はい。ホステッドランナーの時間は、ジョブが終了するまでに実行された時間に対して課金されるため、ハングしたジョブは全期間分の料金がかかります。
関連記事
- CI分とは? GitHub Actionsの料金の仕組みCI分とは、パイプラインが使用する課金対象のコンピュート時間です。GitHub Actionsでの分の数え方、切り上げと乗数、そして使用量を減らす方法を説明します。
- Cache Service Responded With 429: 修正方法GitHub Actions の「Failed to restore: Cache service responded with 429」を修正します。キャッシュへのリクエストが多すぎる場合の対処法です。actions/cache を更新し、復元は何度行っても構いませんが、保存は一度だけにしてください。
- fatal: could not read Username for github.com: 修正方法GitHub Actionsで"fatal: could not read Username for 'https://github.com'"を解決する方法:プライベートリポジトリ、サブモジュール、gitの依存関係にはトークンが必要です。
- Invalid Workflow File: YAML構文エラーの修正方法GitHub Actionsで"Invalid workflow file"と"You have an error in your yaml syntax"を解決する方法:インデント、予期しない値、不正な式をactionlintで確認します。