Nachdem Sie einen Regelsatz erstellt haben, können Sie Änderungen daran vornehmen. Sie können beispielsweise Regeln hinzufügen, um Ihre Verzweigungen oder Tags besser zu schützen, oder Sie können Ihren Regelsatz vom Modus "Auswerten" auf "Aktiv" umstellen, nachdem Sie die Auswirkungen auf die Mitwirkendenerfahrung für Sie getestet haben Repository.
Mit REST und GraphQL APIs kannst du Regelsätze verwalten. Weitere Informationen finden Sie unter REST-API-Endpunkte für Regeln und unter Mutationen.
Tipp: Wenn du Besitzer*in einer Organisation bist, kannst du Regelsätze auf Organisationsebene erstellen. Du kannst diese Regelsätze auf bestimmte Repositorys in deiner Organisation und auf bestimmte Branches in diesen Repositorys anwenden. Weitere Informationen findest du unter Erstellen von Regelsätzen für Repositorys in deiner Organisation.
Anzeigen von Regelsätzen für ein Repository
Auf der Seite „Regelsätze“ kann jeder, der Lesezugriff auf das Repository hat, die aktiven Regelgruppen für eine bestimmte/n Verzweigung, Tag oder Push-Einschränkung anzeigen.
Außerdem werden Regelsätze angezeigt, die im Modus „Auswerten“ ausgeführt werden, die nicht erzwungen werden.
Für Pushregeln für Fork-Repositorys gibt die Seite „Regelsätze“ an, dass der Regelsatz vom Quell-Repository verwaltet wird, auf das die Regel angewendet wird.
-
Navigieren Sie auf GitHub zur Hauptseite des Repositorys.
-
Wähle in der Dateistrukturansicht auf der linken Seite das Branchdropdownmenü aus, und klicke dann auf Alle Branches anzeigen. Du findest das Branchdropdownmenü auch oben im integrierten Datei-Editor.
-
Klicken Sie links neben dem Branch-Namen auf .
-
Wenn Sie die Ergebnisse optional filtern möchten, klicken Sie auf die Registerkarten, oder verwenden Sie die Suchleiste „Verzweigungen durchsuchen“.
-
Klicke auf den Namen des Regelsatzes, den du ansehen möchtest.
Bearbeiten eines Regelsatzes
Hinweis: Wenn ein Regelsatz auf Organisationsebene erstellt wurde, kannst du den Regelsatz nicht über die Einstellungen des Repositorys bearbeiten. Wenn du über die Berechtigung zum Bearbeiten des Regelsatzes verfügst, ist dies in den Einstellungen deiner Organisation möglich. Weitere Informationen findest du unter Verwalten von Regelsätzen für Repositorys in deiner Organisation.
Du kannst einen Regelsatz bearbeiten, um Teile darin zu ändern, z. B. den Namen, Umgehungsberechtigungen oder Regeln. Du kannst einen Regelsatz auch bearbeiten, um seinen Status zu ändern. Dies ähnelt dem temporären Aktivieren oder Deaktivieren eines Regelsatzes.
-
Navigieren Sie auf GitHub zur Hauptseite des Repositorys.
-
Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.
-
Klicke auf der linken Randleiste unter „Code und Automatisierung“ auf Regeln und dann auf Regelsätze.
-
Wähle auf der Seite „Regelsätze“ den Namen des Regelsatzes aus, den du bearbeiten möchtest.
-
Führe die gewünschten Änderungen aus. Weitere Informationen zu den verfügbaren Regeln findest du unter „Verfügbare Regeln für Regelsätze“.
-
Klicke unten auf der Seite auf Änderungen speichern.
Löschen eines Regelsatzes
Tipp: Wenn du einen Regelsatz vorübergehend deaktivieren, aber nicht löschen möchtest, lege den Status des Regelsatzes auf „Deaktiviert“ fest. Weitere Informationen findest du unter Bearbeiten eines Regelsatzes.
-
Navigieren Sie auf GitHub zur Hauptseite des Repositorys.
-
Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.
-
Klicke auf der linken Randleiste unter „Code und Automatisierung“ auf Regeln und dann auf Regelsätze.
-
Klicke auf den Namen des Regelsatzes, den du löschen möchtest.
-
Klicke rechts neben dem Namen des Regelsatzes auf und dann auf Regelsatz löschen.
Verwenden des Regelsatzverlaufs
Importieren eines Regelsets
Anzeigen von Erkenntnissen für Regelsätze
Du kannst Erkenntnisse für Regelsätze anzeigen, um zu sehen, wie diese sich auf ein Repository auswirken. Auf der Seite „Regelerkenntnisse“ wird eine Zeitleiste der folgenden Benutzeraktionen angezeigt. Du kannst Filter verwenden, um das Gesuchte zu finden:
- Aktionen, die mindestens anhand eines Regelsatzes überprüft wurden und erfolgreich waren
- Aktionen, die mindestens anhand eines Regelsatzes überprüft wurden und fehlgeschlagen sind
- Aktionen, bei denen eine Benutzerin mindestens einen Regelsatz umgangen hat
Wenn ein Regelsatz im Modus „Auswerten“ ausgeführt wird, werden Aktionen angezeigt, die erfolgreich gewesen oder fehlgeschlagen wären, wenn der Regelsatz aktiv gewesen wäre.
-
Navigieren Sie auf GitHub zur Hauptseite des Repositorys.
-
Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.
-
Klicke auf der linken Randleiste unter „Code und Automatisierung“ auf Erkenntnisse und dann auf Regelsätze.
-
Verwende oben auf der Seite „Regelerkenntnisse“ die Dropdownmenüs, um die Aktionen nach Regelsatz, Branch, Akteur und Zeitraum zu filtern.
-
Klicke auf , und erweitere den Namen des Regelsatzes, um zu ermitteln, welche Regeln fehlgeschlagen sind oder für welche Regeln eine Umgehung erforderlich war.
-
Überprüfen Sie optional die Details der Mergewarteschlange für die entsprechenden Pull Requests in derselben Mergegruppe.
Verwalten von Anforderungen zum Umgehen von Pushregeln
Note
Die delegierte Umgehung für Push-Regeln befindet sich derzeit in der public preview und kann noch geändert werden.
Sie können alle Anforderungen für Umgehungsberechtigungen auf der Seite „Pushschutz-Umgehung“ anzeigen und verwalten, die sich auf der Registerkarte Regeln des Repositorys befindet.
- Klicken Sie auf Umgehungsanforderungen.
Sie können Anfragen nach Genehmiger (Mitglied der Umgehungsliste), anfordernde Person (Antragsteller), Zeitrahmen und Status filtern. Einer Anforderung werden die folgenden Status zugewiesen:
| Status | Beschreibung |
|---|---|
Cancelled | Die Anforderung wurde vom Mitwirkender abgebrochen. |
Completed | Die Anforderung wurde genehmigt und der Commit(s) wurde an das Repository verschoben. |
Denied | Die Anforderung wurde überprüft und abgelehnt. |
Expired | Die Anforderung ist abgelaufen. Anforderungen sind sieben Tage gültig. |
Open | Die Anforderung wurde entweder noch nicht überprüft oder wurde genehmigt, aber der Commit(s) wurde nicht an das Repository verschoben. |
Wenn ein Mitwirkender Umgehungsrechte anfordert, um einen Commit zu veröffentlichen, der eingeschränkte Inhalte enthält, erhalten alle Mitglieder der Umgehungsliste eine E-Mail-Benachrichtigung mit einem Link zu der Anforderung. Mitglieder der Umgehungsliste haben dann sieben Tage Zeit, die Anforderung zu überprüfen und zu genehmigen oder zu verweigern, bevor die Anforderung abläuft.
Die Mitwirkender wird per E-Mail über die Entscheidung informiert und muss die erforderlichen Maßnahmen ergreifen. Wenn die Anforderung genehmigt wird, kann der Mitwirkende den Commit, der den eingeschränkten Inhalt enthält, in das Repository stellen. Wird die Anforderung abgelehnt, muss der Mitwirkende den eingeschränkten Inhalt aus dem Commit entfernen, um den Commit erfolgreich in das Repository zu übertragen.