Zum Inhalt springen

Der Runner hat ein Shutdown-Signal erhalten: Fehler beheben

Zuletzt aktualisiert am

The runner has received a shutdown signal bedeutet, dass die Maschine oder der Dienst, auf dem Ihr Job läuft, angewiesen wurde, sich zu beenden, während der Job noch lief. Bei GitHub-gehosteten Runnern kommt das selten vor. Bei selbst gehosteten Runnern steckt meist etwas außerhalb des Jobs dahinter, das den Runner gestoppt hat: eine von der Cloud zurückgeforderte Spot-Instanz, ein Autoscaler, der herunterskaliert, ein Neustart oder ein beendeter Dienst. Diese Seite zeigt, wie Sie die Ursache ermitteln und verhindern, dass der Fehler erneut auftritt.

Die genaue Meldung

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.

Die zweite Zeile folgt meist auf die erste. Wenn Sie nur The operation was canceled sehen und der Lauf von einer Person oder durch einen neueren Push abgebrochen wurde, lesen Sie stattdessen The operation was canceled.

Ursachen, nach Wahrscheinlichkeit sortiert

1. Spot- oder preemptible Instanzen wurden zurückgefordert

Wenn Ihre selbst gehosteten Runner auf Spot-, Preemptible- oder Low-Priority-VMs laufen, kann die Cloud die Maschine kurzfristig zurücknehmen, und der Runner erhält ein Shutdown-Signal, während ein Job läuft. Prüfen Sie das Ereignisprotokoll Ihrer Cloud auf ein Unterbrechungs- oder Beendigungsereignis zum Zeitpunkt des Fehlers.

Lösung: Verwenden Sie On-Demand-Instanzen für Runner, die lange Jobs ausführen, oder halten Sie Jobs kurz und sicher wiederholbar. Siehe Spot-Instanzen für CI-Runner.

2. Ein Autoscaler hat den Runner während der Arbeit herunterskaliert

Eine Scale-Down-Logik, die inaktive Runner nach Alter oder Anzahl entfernt, kann einen Runner entfernen, der gerade einen Job übernommen hat. Bei Actions Runner Controller (ARC) kann ein Pod auch während eines Node-Drains oder eines Upgrades evictet oder neu gestartet werden.

Lösung: Skalieren Sie nur Runner herunter, die melden, dass kein Job läuft, verwenden Sie ephemere Runner (ein Job, danach werden sie entfernt), und setzen Sie Pod Disruption Budgets sowie eine Termination Grace Period für ARC-Runner-Pods.

3. Der Runner-Dienst wurde gestoppt oder der Rechner hat neu gestartet

Prüfen Sie den Dienst auf dem Runner-Host:

sudo ./svc.sh status
sudo journalctl -u 'actions.runner.*' --since "2 hours ago" | tail -50
last -x reboot shutdown | head

Ein unbeaufsichtigtes Upgrade, das den Host neu startet, ein Konfigurationswerkzeug, das den Dienst neu startet, oder das Drücken von Strg+C bei manuell gestartetem ./run.sh erzeugen alle diesen Fehler.

Lösung: Planen Sie Neustarts und Upgrades für Zeiten, in denen der Runner entleert ist, und betreiben Sie den Runner als Dienst statt aus einem Terminal heraus.

4. Dem Host ist der Speicher oder die Festplatte ausgegangen

Ein Host ohne freien Speicher kann den Runner-Prozess selbst beenden. Prüfen Sie dmesg auf Out of memory und lesen Sie hosted runner lost communication sowie exit code 137.

5. Ein GitHub-gehosteter Runner wurde ersetzt

Wenn Sie nur GitHub-gehostete Runner verwenden und kein Job von Ihnen die Maschine gestoppt hat, handelt es sich um einen Infrastrukturfehler. Prüfen Sie die GitHub-Statusseite und starten Sie die fehlgeschlagenen Jobs erneut.

Den Job einen Stopp überstehen lassen

Sie können eine zurückgeforderte VM nicht aufhalten, wohl aber den Schaden begrenzen. Halten Sie jeden Job kurz, speichern Sie Ergebnisse und Caches fortlaufend und machen Sie Schritte gefahrlos wiederholbar. Ein Bereinigungsschritt, der immer laufen muss, sollte if: always() verwenden:

- name: Upload partial results
  if: always()
  uses: actions/upload-artifact@v4
  with:
    name: results-${{ matrix.shard }}
    path: results/

So verhindern Sie den Fehler

  1. Verwenden Sie ephemere Runner, damit für jeden Job ein Runner erstellt und nicht durch ein Scale-Down wiederverwendet wird.
  2. Führen Sie lange Jobs nicht auf Spot-Instanzen aus, es sei denn, eine Wiederholung ist günstig.
  3. Entleeren Sie einen Runner (er nimmt keine neuen Jobs mehr an) vor Wartungsarbeiten, Neustarts oder Upgrades.
  4. Richten Sie Alarme für Neustarts des Runner-Dienstes und für Unterbrechungsereignisse der Cloud ein.
  5. Halten Sie Jobs kurz. Wenn Sie einen langen Job mit einer Matrix aufteilen, verringern Sie die Kosten einer einzelnen Unterbrechung.

FAQ

Wird dieser Fehler durch meinen Workflow verursacht?

Selten. Die Meldung beschreibt, dass der Runner von außerhalb des Jobs gestoppt wurde. Ein hängender Schritt endet eher mit einem Timeout als mit einem Shutdown-Signal.

Wiederholt GitHub den Job automatisch?

Nicht standardmäßig. Sie starten die fehlgeschlagenen Jobs selbst neu oder ergänzen eigene Wiederholungslogik um die Arbeit.

Tritt das bei GitHub-gehosteten Runnern auf?

Das kann vorkommen, ist aber selten und hängt meist mit einem Vorfall zusammen. Prüfen Sie die Statusseite und starten Sie dann neu.

Worin unterscheidet sich das von Exit-Code 143?

Exit-Code 143 bedeutet, dass ein Prozess SIGTERM erhält. Ein Shutdown-Signal auf dem Runner endet für den laufenden Schritt häufig mit 143. Siehe exit code 143.