Skip to main content

Setting exit codes for actions (Festlegen von Exitcodes für Aktionen)

Du kannst mittels Exitcodes den Status einer Aktion festlegen. GitHub zeigt Status, um erfolgreiche oder fehlgeschlagene Aktionen kenntlich zu machen.

Note

Auf GitHub gehostete Runner werden aktuell nicht auf GitHub Enterprise Server unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der GitHub public roadmap.

Informationen zu Exitcodes

GitHub verwendet den Exitcode, um den Status der Überprüfungsausführung der Aktion festzulegen. Dieser kann success oder failure lauten.

BeendigungsstatusPrüflaufstatusBESCHREIBUNG
0successDie Aktion wurde erfolgreich abgeschlossen, und andere Tasks, die von dieser abhängig sind, können nun starten.
Wert ungleich Null (eine beliebige ganze Zahl außer 0)failureAlle anderen Exit-Codes weisen darauf hin, dass die Aktion fehlgeschlagen ist. Wenn eine Aktion fehlschlägt, werden alle derzeit laufenden Aktionen abgebrochen, und künftige Aktionen werden übersprungen. Sowohl Überprüfungsausführung als auch Überprüfungssuite erhalten den Status failure.

Fehler-Exit-Code in einer JavaScript-Aktion festlegen

Wenn du eine JavaScript-Aktion erstellst, kannst du das Aktionstoolkitpaket @actions/core verwenden, um eine Nachricht zu protokollieren und einen Fehlerexitcode festzulegen. Beispiel:

try {
  // something
} catch (error) {
  core.setFailed(error.message);
}

Weitere Informationen findest du unter Creating a JavaScript action (Erstellen einer JavaScript-Aktion).

Fehler-Exit-Code in einer Docker-Container-Aktion festlegen

Wenn du eine Docker-Containeraktion erstellst, kannst du einen Fehlerexitcode in deinem entrypoint.sh-Skript festlegen. Beispiel:

if <condition> ; then
  echo "Game over!"
  exit 1
fi

Weitere Informationen findest du unter Creating a Docker container action (Erstellen einer Docker-Containeraktion).