Informationen zu Statuschecks
Statuschecks informieren Sie darüber, ob Ihre Commits die für das Repository, an dem Sie mitwirken, festgelegten Bedingungen erfüllen.
Inhalt dieses Artikels
Statuschecks basieren auf externen Prozessen, beispielsweise Builds mit fortlaufender Integration, die bei jedem Push an ein Repository ausgeführt werden. Sie können den Status Ausstehend, Bestanden oder Nicht bestanden des Statuschecks neben den einzelnen Commits in Ihrem Pull Request sehen.
Personen mit Schreibberechtigungen für ein Repository können den Zustand für Schreibberechtigungen im Repository festlegen.
Sie können den Gesamtzustand des letzten Commits an einen Branch auf der Branch-Seite Ihres Repositorys oder in der Liste der Pull Requests Ihres Repositorys sehen.
If status checks are required for a repository, the required status checks must pass before you can merge your branch into the protected branch. Weitere Informationen finden Sie unter „Informationen zu erforderlichen Statuschecks“.
Arten von Statuschecks auf GitHub Enterprise
Es gibt zwei Arten von Statuschecks auf GitHub Enterprise:
- Prüfungen
- Status
Prü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 Enterprise Prüfungen und Status erstellen. Weitere Informationen finden Sie unter „Prüfungen“ und „Status“ in die GitHub-Entwicklerdokumentation.
Prüfungen
Wenn Prüfungen in einem Repository eingerichtet sind, weisen Pull Requests die Registerkarte Checks (Prüfungen) auf, auf der Sie detaillierte Buildausgaben von Statuschecks und Wiederholungen fehlgeschlagener Prüfungen einsehen können.
Wenn eine Prüfung aufgrund einer bestimmten Zeile in einem Commit nicht bestanden wird, sehen Sie Einzelheiten über den Fehler, die Warnung oder den Hinweis neben dem entsprechenden Code auf der Registerkarte Files (Dateien) des Pull Requests.
Sie können zwischen den Prüfungszusammenfassungen für verschiedene Commits in einem Pull Request navigieren, indem Sie das Dropdownmenü „Commit“ auf der Registerkarte Conversation (Unterhaltung) verwenden.
Prüfungen für einzelne Commits überspringen und anfordern
Wenn ein Repository so konfiguriert ist, dass es automatisch Prüfungen für Pushes anfordert, können Sie die Prüfungen für einen einzelnen Commit, den Sie pushen, überspringen. Wenn ein Repository so nicht konfiguriert ist, dass es automatisch Prüfungen für Pushes anfordert, können Sie die Prüfungen für einen einzelnen Commit, den Sie pushen, anfordern. Weitere Informationen zu diesen Einstellungen finden Sie unter „Prüfsuiten“ in die GitHub-Entwicklerdokumentation.
Um Prüfungen für Ihren Commit zu überspringen oder anzufordern, fügen Sie eine der folgenden Trailerzeilen an das Ende Ihrer Commit-Mitteilung an:
-
Um Prüfungen auf einen Commit zu überspringen, geben Sie Ihre Commit-Mitteilung und eine kurze, aussagekräftige Beschreibung Ihrer Änderungen ein. Fügen Sie nach Ihrer Commit-Beschreibung anstelle eines abschließenden Anführungszeichens zwei leere Zeilen hinzu, gefolgt von
skip-checks: true
:$ git commit -m "Update README. > > skip-checks: true
-
Um Prüfungen für einen Commit anzufordern, geben Sie Ihre Commit-Mitteilung und eine kurze, aussagekräftige Beschreibung Ihrer Änderungen ein. Fügen Sie nach Ihrer Commit-Beschreibung anstelle eines abschließenden Anführungszeichens zwei leere Zeilen hinzu, gefolgt von
request-checks: true
:$ git commit -m "Refactor usability tests. > > request-checks: true