Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Informationen zu Statuschecks

Statusüberprüfungen informieren dich darüber, ob deine Commits die Bedingungen erfüllen, die für das Repository festgelegt wurden, an dem du mitwirkst.

Statuschecks basieren auf externen Prozessen, beispielsweise Builds mit fortlaufender Integration, die bei jedem Push an ein Repository ausgeführt werden. Du kannst die Zustände ausstehend, übergeben oder fehlerhaft der Statusüberprüfungen neben einzelnen Commits in deinem Pull Request anzeigen.

Liste der Commits und Status

Personen mit Schreibberechtigungen für ein Repository können den Zustand für Statusprüfungen im Repository festlegen.

Du kannst den Gesamtzustand des letzten Commits an einen Branch auf der Branch-Seite deines Repositorys oder in der Liste der Pull Requests deines Repositorys sehen.

Wenn Statusprüfungen für ein Repository erforderlich sind, müssen die erforderlichen Statusprüfungen bestanden werden, bevor Du Deinen Branch mit der geschützten Branch zusammenführen kannst. Weitere Informationen findest du unter Informationen zu geschützten Branches.

Arten von Statuschecks auf GitHub

Es gibt zwei Arten von Statuschecks auf GitHub:

  • Prüfungen
  • Status

Überprüfungen unterscheiden sich von Status dadurch, dass sie Zeilenanmerkungen und detailliertere Meldungen enthalten und nur für die Verwendung mit GitHub Apps verfügbar sind.

Organisationsinhaber und Benutzer mit Push-Zugriff auf ein Repository können mit der API von GitHub Prüfungen und Status erstellen. Weitere Informationen findest du unter Überprüfungen und Status.

Prüfungen

Wenn Überprüfungen in einem Repository eingerichtet sind, enthalten Pull Requests eine Registerkarte Überprüfungen, auf der du die detaillierte Buildausgabe aus Statusüberprüfungen anzeigen und fehlerhafte Überprüfungen erneut ausführen kannst.

Statuschecks innerhalb eines Pull Requests

Hinweis: Die Registerkarte Überprüfungen wird für Pull Requests nur ausgefüllt, wenn du für das Repository Überprüfungen einrichtest, nicht Status.

Wenn eine Überprüfung aufgrund einer bestimmten Zeile in einem Commit nicht bestanden wird, siehst du Einzelheiten zum Fehler, zur Warnung oder zum Hinweis neben dem entsprechenden Code auf der Registerkarte Dateien des Pull Requests.

Details eines Statuschecks

Du kannst zwischen den Überprüfungszusammenfassungen für verschiedene Commits in einem Pull Request navigieren, indem du das Dropdownmenü „Commit“ auf der Registerkarte Unterhaltung verwendest.

Prüfungszusammenfassungen für verschiedene Commits in einem Dropdownmenü

Prüfungen für einzelne Commits überspringen und anfordern

Wenn ein Repository so konfiguriert ist, dass es automatisch Prüfungen für Pushes anfordert, kannst du die Prüfungen für einen einzelnen Commit überspringen, den du überträgst. Wenn ein Repository nicht so konfiguriert ist, dass es automatisch Überprüfungen für Pushes anfordert, kannst du die Überprüfungen für einen einzelnen Commit anfordern, den du pushst. Weitere Informationen zu diesen Einstellungen findest du unter Überprüfen von Suites.

Du kannst Workflowausführungen überspringen, die durch die Ereignisse push und pull_request ausgelöst werden, indem du einen Befehl in deine Commitnachricht einfügst. Weitere Informationen findest du unter Überspringen von Workflowausführungen.

Alternativ kannst du eine der folgenden Trailerzeilen am Ende deiner Commitnachricht hinzufügen, um alle Überprüfungen für deinen Commit zu überspringen bzw. anzufordern.

  • Um Überprüfungen für einen Commit zu überspringen, gib deine Commitmitteilung und eine kurze, aussagekräftige Beschreibung deiner Änderungen ein. Füge nach der Commitbeschreibung vor dem schließenden Anführungszeichen zwei leere Zeilen hinzu, gefolgt von skip-checks: true:
    $ git commit -m "Update README
    >
    >
    skip-checks: true"
  • Um Überprüfungen für einen Commit anzufordern, gib deine Commitmitteilung und eine kurze, aussagekräftige Beschreibung deiner Änderungen ein. Füge nach der Commitbeschreibung vor dem schließenden Anführungszeichen zwei leere Zeilen hinzu, gefolgt von request-checks: true:
    $ git commit -m "Refactor usability tests
    >
    >
    request-checks: true"

Aufbewahrung von Statusüberprüfungen

Überprüft, ob Daten archiviert werden, die älter sind als 400 Tage. Im Rahmen des Archivierungsprozesses erstellt GitHub einen Rollupcommitstatus, der den Status aller Prüfungen für diesen Commit darstellt. Dies hat zur Folge, dass das Mergefeld in jedem Pull Request mit erforderlichen archivierten Prüfungen blockiert ist, und du die Prüfungen erneut durchführen musst, bevor du den Pull Request mergen kannst.