ランナーがシャットダウンシグナルを受信しました: 修正方法
最終更新:
The runner has received a shutdown signal は、ジョブを実行しているマシンまたはサービスが、ジョブの実行中に停止するよう指示されたことを意味します。GitHub がホストするランナーではまれにしか起きません。セルフホストランナーでは、ほぼ常にジョブの外部からランナーが停止させられています。原因としては、クラウドに回収されたスポットインスタンス、スケールダウンしたオートスケーラー、再起動、停止したサービスなどがあります。このページでは原因の特定方法と再発の防止方法を説明します。
表示される正確なメッセージ
Error: The runner has received a shutdown signal. This can happen when the runner service is stopped, or a manually started runner is canceled.
Error: The operation was canceled.
2行目は、通常は1行目に続いて表示されます。The operation was canceled だけが表示され、ユーザーや新しいpushによって実行がキャンセルされた場合は、代わりに The operation was canceled をご確認ください。
考えられる原因(可能性の高い順)
1. スポットインスタンスまたはプリエンプティブルインスタンスが回収された
セルフホストランナーをスポット、プリエンプティブル、低優先度のVMで動かしている場合、クラウドは短い予告でマシンを取り戻すことがあり、その結果ジョブの実行中にランナーがシャットダウンされます。失敗と同じ時刻に、クラウドのイベントログで中断または終了のイベントがないか確認してください。
修正方法: 長時間のジョブを実行するランナーにはオンデマンドインスタンスを使うか、ジョブを短くして再実行しても問題ないようにします。詳しくは CIランナーのスポットインスタンス をご覧ください。
2. 作業中のランナーがオートスケーラーによってスケールダウンされた
経過時間や台数に基づいてアイドル状態のランナーを削除するスケールダウンのロジックは、ちょうどジョブを受け取ったばかりのランナーを削除してしまうことがあります。Actions Runner Controller (ARC) では、ノードのドレインやアップグレードの最中にPodが退避または再起動されることもあります。
修正方法: ジョブを実行していないと報告しているランナーだけをスケールダウンし、エフェメラルランナー(1ジョブ実行後に削除されるランナー)を使い、ARCのランナーPodにPod Disruption Budgetと終了猶予期間を設定します。
3. ランナーサービスが停止した、またはマシンが再起動した
ランナーホスト上のサービスを確認します:
sudo ./svc.sh status
sudo journalctl -u 'actions.runner.*' --since "2 hours ago" | tail -50
last -x reboot shutdown | head
ホストを再起動する自動アップグレード、サービスを再起動する構成ツール、手動で起動した ./run.sh に対してCtrl+Cを押す操作などは、いずれもこのエラーの原因になります。
修正方法: 再起動やアップグレードは、ランナーのドレインが済んだタイミングに予定し、ランナーはターミナルからではなくサービスとして実行します。
4. ホストのメモリまたはディスクが不足した
メモリが不足したホストでは、ランナーのプロセス自体が強制終了されることがあります。dmesg で Out of memory がないか確認し、hosted runner lost communication と exit code 137 も参照してください。
5. GitHub がホストするランナーが回収された
GitHub がホストするランナーのみを使用していて、マシンを停止させるようなジョブを実行していない場合は、インフラの障害が考えられます。GitHub のステータスページ を確認し、失敗したジョブを再実行してください。
停止されてもジョブが影響を受けないようにする
回収されるVMを止めることはできませんが、被害を小さくすることはできます。ジョブは短く保ち、結果やキャッシュは随時保存し、ステップは繰り返し実行しても安全になるようにします。必ず実行すべきクリーンアップステップには if: always() を使用します:
- name: Upload partial results
if: always()
uses: actions/upload-artifact@v4
with:
name: results-${{ matrix.shard }}
path: results/
予防方法
- エフェメラルランナーを使用します。1ジョブごとにランナーを作成し、スケールダウンで再利用されないようにします。
- 再実行のコストが低くない限り、長時間のジョブをスポットインスタンスで実行しないでください。
- メンテナンス、再起動、アップグレードの前にランナーをドレインします(新しいジョブを受け付けないように停止します)。
- ランナーサービスの再起動とクラウドの中断イベントにアラートを設定します。
- ジョブは短く保ちます。マトリックス を使って長いジョブを分割すると、1回の中断による損失を減らせます。
よくある質問
このエラーはワークフローが原因ですか?
ほとんどの場合は違います。このメッセージは、ジョブの外部からランナーが停止させられたことを示しています。ハングしたステップは、シャットダウンシグナルではなく、通常は タイムアウト で終了します。
GitHub はジョブを自動で再試行しますか?
デフォルトでは再試行されません。失敗したジョブは手動で再実行するか、作業の周囲に独自の再試行ロジックを追加してください。
GitHub がホストするランナーでも発生しますか?
発生することはありますが、まれであり、通常は障害に関連しています。ステータスページを確認してから再実行してください。
終了コード143とはどう違いますか?
終了コード143は、プロセスがSIGTERMを受信したことを示します。ランナーのシャットダウンシグナルは、実行中だったステップの終了コードとして143で終わることがよくあります。終了コード143 をご覧ください。
関連記事
- 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で確認します。
- GitHub ActionsでのJavaScript Heap Out of Memoryの修正方法GitHub ActionsでNODE_OPTIONSを使い、"FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory"とnpm ENOMEMを解決する方法。