Process Completed With Exit Code 143:SIGTERMの修正
最終更新:
Process completed with exit code 143 は、プロセスがSIGTERMによって停止を要求されたことを意味します。この番号は128に15を足したもので、15はSIGTERMシグナルです。exit code 137は強制終了ですが、SIGTERMはプロセスが捕捉して後処理を行える、穏やかな要求です。GitHub Actionsでは、何らかの要因がステップの停止を指示しました。通常は、実行のキャンセル、タイムアウト、またはランナーのシャットダウンです。
表示される正確なメッセージ
Error: Process completed with exit code 143.
その直前のログにTerminatedと出力されることがあり、ログの末尾付近にThe operation was canceledが出ることも多くあります。
考えられる原因(可能性の高い順)
1. 実行がキャンセルされた
誰かが実行をキャンセルしたか、cancel-in-progress: trueを設定したconcurrencyグループが、新しい実行の開始に伴って既存の実行をキャンセルしました。そのタイミングで実行中だったステップは143で終了します。
concurrency:
group: ci-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
これはプルリクエストのビルドでは想定どおりの動作ですが、デプロイ用のワークフローでは危険です。デプロイを途中で中断しないよう、そこではcancel-in-progress: falseを使用してください。The operation was canceledを参照してください。
2. ジョブまたはステップがtimeout-minutesに達した
ジョブやステップがtimeout-minutesを超えると、GitHubによって終了されます。ジョブの実行時間が設定した上限を超えていないか確認し、timeout-minutesを参照してください。
3. ランナーがシャットダウン中
セルフホストランナーでは、サービスの停止、再起動、またはスケールダウンによってジョブにSIGTERMが送られます。The runner has received a shutdown signalを参照してください。
4. docker stop、またはコンテナの置き換え
docker stopはまずSIGTERMを送信し、猶予期間(既定では10秒)の後に強制終了します。メインプロセスがSIGTERMを無視するコンテナは137で終了し、それを処理するコンテナは143または0で終了します。
5. 自作のスクリプトが送信した
kill、pkill、timeoutは、既定でSIGTERMを送信します。意図より多くのプロセスに一致するpkill nodeは、ビルドツールも停止させてしまいます。
自作スクリプトでSIGTERMを処理する
ジョブが停止されたときにクリーンアップを行うには、シグナルをtrapします。
- run: |
cleanup() { echo "stopping"; docker compose down; }
trap cleanup TERM INT
./long-running-task.sh &
wait $!
ジョブがキャンセルされたあとも必ず実行すべきステップには、if: always()またはif: cancelled()を使用します。
- name: Stop services
if: always()
run: docker compose down
キャンセルされたジョブがこれらのステップを実行できる時間は短いため、クリーンアップは素早く終わるようにしてください。
予防方法
cancel-in-progressは、中断しても安全なワークフローでのみ使用してください。timeout-minutesは、通常の実行時間より余裕を持たせて設定してください。- 長時間かかるタスクは再開可能にし、SIGTERMをtrapしてロックやコンテナを解放してください。
- セルフホストランナーでは、再起動の前に実行中のジョブを排出(ドレイン)してください。
pkillとkillのコマンドは、対象を具体的に指定してください。
よくある質問
終了コード143は何を意味しますか?
プロセスはSIGTERM(128 + 15)を受け取りました。終了を要求され、そのとおりに終了したということです。
終了コード143は私のコードのエラーですか?
通常はそうではありません。ステップの外部の要因によって停止させられたことを示しています。まずキャンセル、タイムアウト、ランナーを確認してください。
137と143の違いは何ですか?
137はSIGKILLで、捕捉できず、メモリ不足による強制終了で典型的に見られます。143はSIGTERMで、プロセスが捕捉して処理できます。
成功したはずのジョブが143で終了したのはなぜですか?
後のステップが失敗してワークフローが残りの処理をキャンセルした場合、またはfail-fast: trueのmatrixで同じ実行内の別のジョブが失敗した場合、実行中のジョブはキャンセルされ、143で終了することがあります。完了させたい場合はfail-fast: falseを設定してください。
関連記事
- exit code 1で終了しました:デバッグ方法GitHub Actionsの「Process completed with exit code 1」は、コマンドが失敗したことを意味します。その上にある本当のエラーを見つけ、デバッグし、よくある原因を修正する方法を説明します。
- Process Completed With Exit Code 127:コマンドが見つからないGitHub Actionsの「Process completed with exit code 127」を修正する方法:コマンドが見つからない場合です。ツールの不足、ステップ間のPATH、スクリプトパスの誤り、CRLFの改行コードについて説明します。
- 終了コード128で失敗したプロセス '/usr/bin/git'GitHub Actionsで「The process '/usr/bin/git' failed with exit code 128」を解決します。認証、不足しているref、シャローclone、所有者の不一致(dubious ownership)について修正方法を説明します。
- GitHub Actionsの終了コード137: メモリ不足の修正方法GitHub Actionsで「Process completed with exit code 137」と表示される場合、SIGKILLによる強制終了を意味し、多くはメモリ不足が原因です。Node、Jest、Gradle、DockerのRAM対策と、ランナーのRAMについて説明します。