Verwalten von Regelsätzen für ein Repository

Sie können vorhandene Regelsätze in einem Repository bearbeiten, überwachen und löschen, um zu ändern, wie Personen mit bestimmten Verzweigungen und Tags interagieren können.

Wer kann dieses Feature verwenden?

Alle Personen mit Lesezugriff auf ein Repository können die Regelsätze des Repositorys anzeigen. Personen mit Administratorzugriff auf ein Repository oder mit einer benutzerdefinierten Rolle mit der Berechtigung „Repositoryregeln bearbeiten“, können Regelsätze für ein Repository erstellen, bearbeiten und löschen sowie Erkenntnisse zu Regelsätzen anzeigen. Weitere Informationen findest du unter Informationen zu benutzerdefinierten Repositoryrollen.

Regelsätze sind verfügbar in öffentlichen Repositorys mit GitHub Free und GitHub Free für Organisationen, und in öffentlichen und privaten Repositorys mit GitHub Pro, GitHub Team und GitHub Enterprise Cloud. Weitere Informationen findest du unter GitHub-Pläne.

Push-Regelsätze sind für den Plan GitHub Enterprise Cloud in internen und privaten Repositorys, Repositorys mit aktivierten Push-Regelsätzen und Organisationen in Ihrem Unternehmen verfügbar.

In diesem Artikel

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 findest du unter REST-API-Endpunkte für Regeln und Mutationen.

Tip

Wenn du Besitzer 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 finden Sie unter Erstellen von Regelsätzen für Repositorys in deiner Organisation.

Anzeigen von Regelsätzen für ein Repository

Auf der Seite „Rulesets“ können alle Personen mit Lesezugriff auf das Repository die aktiven Regelsätze für einen bestimmten Branch, ein bestimmtes Tag oder eine bestimmte Pusheinschränkung anzeigen. Außerdem kannst du Regelsätze einsehen, die im Modus „Evaluate“ ausgeführt und 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.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. 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.

    Screenshot der Dateistrukturansicht für ein Repository, Ein Dropdownmenü für Branches ist aufgeklappt und dunkelorange umrandet.

  3. Klicken Sie links neben dem Branch-Namen auf .

  4. Wenn Sie die Ergebnisse optional filtern möchten, klicken Sie auf die Registerkarten, oder verwenden Sie die Suchleiste „Verzweigungen durchsuchen“.

  5. Klicke auf den Namen des Regelsatzes, den du ansehen möchtest.

Bearbeiten eines Regelsatzes

Note

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 finden Sie 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.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. 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.

    Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke auf der linken Randleiste unter „Code und Automatisierung“ auf Regeln und dann auf Regelsätze.

    Screenshot: Randleiste der Seite „Einstellungen“ für ein Repository Das Untermenü „Regeln“ ist erweitert, und die Option „Regelsätze“ ist orange umrandet.

  4. Wähle auf der Seite „Regelsätze“ den Namen des Regelsatzes aus, den du bearbeiten möchtest.

  5. Führe die gewünschten Änderungen aus. Weitere Informationen zu den verfügbaren Regeln findest du unter „Verfügbare Regeln für Regelsätze“.

  6. Klicke unten auf der Seite auf Änderungen speichern.

Löschen eines Regelsatzes

Tip

Wenn du einen Regelsatz vorübergehend deaktivieren, aber nicht löschen möchtest, lege dessen Status auf „Disabled“ fest. Weitere Informationen findest du unter Bearbeiten eines Regelsatzes.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. 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.

    Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke auf der linken Randleiste unter „Code und Automatisierung“ auf Regeln und dann auf Regelsätze.

    Screenshot: Randleiste der Seite „Einstellungen“ für ein Repository Das Untermenü „Regeln“ ist erweitert, und die Option „Regelsätze“ ist orange umrandet.

  4. Klicke auf den Namen des Regelsatzes, den du löschen möchtest.

  5. Klicke rechts neben dem Namen des Regelsatzes auf und dann auf Regelsatz löschen.

    Screenshot: Seite zum Bearbeiten eines Regelsatzes Unterhalb einer Schaltfläche mit drei Punkten befindet sich eine orange umrandete Option mit der Bezeichnung „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.

Screenshot: Seite „Regelerkenntnisse“. Es werden drei Aktionen aufgeführt: Eine Aktion ist mit „Erfolgreich“ markiert, eine mit „Umgehung“ und eine mit „Fehler“ und der Bezeichnung „Auswerten“.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. 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.

    Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  3. Klicke auf der linken Randleiste unter „Code und Automatisierung“ auf Erkenntnisse und dann auf Regelsätze.

    Screenshot: Randleiste der Seite „Einstellungen“ für ein Repository Das Untermenü „Erkenntnisse“ ist erweitert, und die Option „Regelsätze“ ist orange umrandet.

  4. Verwende oben auf der Seite „Regelerkenntnisse“ die Dropdownmenüs, um die Aktionen nach Regelsatz, Branch, Akteur und Zeitraum zu filtern.

  5. Klicke auf , und erweitere den Namen des Regelsatzes, um zu ermitteln, welche Regeln fehlgeschlagen sind oder für welche Regeln eine Umgehung erforderlich war.

    Screenshot: Seite „Regelerkenntnisse“. Rechts neben einem Ereignis mit der Bezeichnung „octocat created not-allowed“ ist das Symbol der drei horizontalen Punkte orange umrandet.

  6. Ü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.

  1. 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:

StatusBeschreibung
CancelledDie Anforderung wurde vom Mitwirkender abgebrochen.
CompletedDie Anforderung wurde genehmigt und der Commit(s) wurde an das Repository verschoben.
DeniedDie Anforderung wurde überprüft und abgelehnt.
ExpiredDie Anforderung ist abgelaufen. Anforderungen sind sieben Tage gültig.
OpenDie 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.