コンテンツへスキップ

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

キャンセルされたジョブがこれらのステップを実行できる時間は短いため、クリーンアップは素早く終わるようにしてください。

予防方法

  1. cancel-in-progressは、中断しても安全なワークフローでのみ使用してください。
  2. timeout-minutesは、通常の実行時間より余裕を持たせて設定してください。
  3. 長時間かかるタスクは再開可能にし、SIGTERMをtrapしてロックやコンテナを解放してください。
  4. セルフホストランナーでは、再起動の前に実行中のジョブを排出(ドレイン)してください。
  5. pkillとkillのコマンドは、対象を具体的に指定してください。

よくある質問

終了コード143は何を意味しますか?

プロセスはSIGTERM(128 + 15)を受け取りました。終了を要求され、そのとおりに終了したということです。

終了コード143は私のコードのエラーですか?

通常はそうではありません。ステップの外部の要因によって停止させられたことを示しています。まずキャンセル、タイムアウト、ランナーを確認してください。

137と143の違いは何ですか?

137はSIGKILLで、捕捉できず、メモリ不足による強制終了で典型的に見られます。143はSIGTERMで、プロセスが捕捉して処理できます。

成功したはずのジョブが143で終了したのはなぜですか?

後のステップが失敗してワークフローが残りの処理をキャンセルした場合、またはfail-fast: trueのmatrixで同じ実行内の別のジョブが失敗した場合、実行中のジョブはキャンセルされ、143で終了することがあります。完了させたい場合はfail-fast: falseを設定してください。