Zum Inhalt springen

Prozess mit Exit-Code 143 beendet: SIGTERM beheben

Zuletzt aktualisiert am

Process completed with exit code 143 bedeutet, dass ein Prozess aufgefordert wurde, sich mit SIGTERM zu beenden. Die Zahl ergibt sich aus 128 plus 15, und 15 ist das SIGTERM-Signal. Anders als Exit-Code 137, einem erzwungenen Abbruch, ist SIGTERM eine höfliche Aufforderung, die der Prozess abfangen und für die Bereinigung nutzen kann. In GitHub Actions hat etwas Ihren Schritt zum Beenden veranlasst: meist ein abgebrochener Lauf, ein Timeout oder das Herunterfahren des Runners.

Die genaue Meldung

Error: Process completed with exit code 143.

Darüber steht oft Terminated im Log, und gegen Ende häufig The operation was canceled.

Ursachen, nach Wahrscheinlichkeit sortiert

1. Der Lauf wurde abgebrochen

Jemand hat den Lauf abgebrochen, oder eine concurrency-Gruppe mit cancel-in-progress: true hat ihn beendet, weil ein neuerer Lauf gestartet wurde. Der Schritt, der in diesem Moment lief, endet mit 143.

concurrency:
  group: ci-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

Bei Pull-Request-Builds ist dieses Verhalten beabsichtigt, bei Deployment-Workflows aber riskant. Brechen Sie ein Deployment nicht mittendrin ab: Verwenden Sie dort cancel-in-progress: false. Siehe The operation was canceled.

2. Ein Job oder Step hat timeout-minutes erreicht

Überschreitet ein Job oder Schritt seine timeout-minutes, beendet GitHub ihn. Vergleichen Sie die Laufzeit des Jobs mit dem eingestellten Limit und lesen Sie timeout-minutes.

3. Der Runner wird heruntergefahren

Bei selbst gehosteten Runnern sendet ein beendeter Dienst, ein Neustart oder eine Skalierung nach unten SIGTERM an den Job. Siehe The runner has received a shutdown signal.

4. docker stop oder ein ersetzter Container

docker stop sendet zuerst SIGTERM und erzwingt nach einer Schonfrist (standardmäßig 10 Sekunden) das Beenden. Ein Container, dessen Hauptprozess SIGTERM ignoriert, endet dann mit 137, einer, der es behandelt, mit 143 oder 0.

5. Ihr eigenes Skript hat es gesendet

kill, pkill und timeout senden standardmäßig SIGTERM. Ein pkill node, das mehr trifft als beabsichtigt, beendet auch das Build-Tool.

SIGTERM in eigenen Skripten behandeln

Um beim Beenden des Jobs aufzuräumen, fangen Sie das Signal mit einem Trap ab:

- run: |
    cleanup() { echo "stopping"; docker compose down; }
    trap cleanup TERM INT
    ./long-running-task.sh &
    wait $!

Für Schritte, die auch dann laufen müssen, wenn der Job abgebrochen wird, verwenden Sie if: always() oder if: cancelled():

- name: Stop services
  if: always()
  run: docker compose down

Ein abgebrochener Job hat nur ein kurzes Zeitfenster für diese Schritte, halten Sie die Bereinigung daher schlank.

So verhindern Sie den Fehler

  1. Verwenden Sie cancel-in-progress nur bei Workflows, die sich gefahrlos unterbrechen lassen.
  2. Setzen Sie timeout-minutes mit ausreichend Puffer über der üblichen Laufzeit.
  3. Machen Sie lange Aufgaben wiederaufnehmbar und fangen Sie SIGTERM ab, um Sperren und Container freizugeben.
  4. Leeren Sie bei selbst gehosteten Runnern die Warteschlange, bevor Sie neu starten.
  5. Seien Sie bei pkill- und kill-Befehlen präzise.

FAQ

Was bedeutet Exit-Code 143?

Der Prozess hat SIGTERM erhalten (128 + 15). Er wurde aufgefordert, sich zu beenden, und hat das getan.

Ist Exit-Code 143 ein Fehler in meinem Code?

Meist nicht. Er weist auf etwas außerhalb des Schritts hin, das ihn stoppt. Prüfen Sie zuerst Abbrüche, Timeouts und den Runner.

Worin unterscheiden sich 137 und 143?

137 ist SIGKILL, das sich nicht abfangen lässt und typisch für Abbrüche wegen Speichermangels ist. 143 ist SIGTERM, das ein Prozess abfangen und behandeln kann.

Warum endete mein erfolgreicher Job mit 143?

Wenn ein späterer Schritt fehlgeschlagen ist und der Workflow die restliche Arbeit abgebrochen hat, oder ein Geschwister-Job in einer Matrix mit fail-fast: true fehlgeschlagen ist, werden laufende Jobs abgebrochen und können mit 143 enden. Setzen Sie fail-fast: false, wenn sie zu Ende laufen sollen.