Verwalten von Regelsätzen für Repositorys in deiner Organisation

Du kannst vorhandene Regelsätze bearbeiten, überwachen und löschen, um zu ändern, wie Personen mit Repositorys in deiner Organisation interagieren können.

Wer kann dieses Feature verwenden?

Organization owners and users with the "Manage organization ref update rules and rulesets" permission can manage rulesets at the organization level.

In diesem Artikel

Informationen zum Verwalten von Regelsätzen für eine Organisation

Nachdem du einen Regelsatz auf Organisationsebene erstellt hast, kannst du Änderungen am Regelsatz vornehmen, um zu ändern, wie Personen mit den zielbezogenen Repositorys interagieren können. Sie können z. B. Regeln hinzufügen, um die Verzweigungen oder Tags in diesen Repositorys besser zu schützen, oder Sie können das Regelset aus dem Modus "Auswerten" in "Aktiv" wechseln, nachdem sie ihre Auswirkungen auf die Mitwirkendenerfahrung für Ihre Repositorys getestet haben.

Organisationsregeln, die für Verzweigungen eines Repositorys gelten, ermöglichen es dem Repositoryadministrator nicht, Verzweigungen des zielbezogenen Repositorys umzubenennen oder die Standardverzweigung in eine andere Verzweigung zu ändern.

Mit der delegierten Umgehung von Push-Regelsätzen können Sie steuern, wer den Push-Schutz umgehen kann und welche gesperrten Pushs zugelassen werden sollen.

Mit delegierter Umgehung müssen Mitwirkende eines Repositorys „Rechte umgehen“ anfordern, wenn Commits mit eingeschränktem Inhalt übertragen werden. Die Anforderung wird an eine bestimmte Gruppe von Prüfern gesendet, die die Anforderung zum Umgehen der Pushregeln genehmigen oder verweigern.

Wenn die Anforderung, Pushregeln zu umgehen, genehmigt wird, kann der Mitwirkende den Commit, der den eingeschränkten Inhalt enthält, pushen. Wenn die Anforderung abgelehnt wird, muss der Mitwirkende den Inhalt aus den Commits) entfernen, die die eingeschränkten Inhalte enthalten, bevor er es erneut veröffentlicht.

Um die delegierte Umgehung zu konfigurieren, erstellen Organisationsbesitzer oder Repositoryadministratoren zuerst eine „Umgehungsliste.“ Die Umgehungsliste umfasst bestimmte Rollen und Teams, z. B. Team- oder Repositoryadministratoren, die Anforderungen zum Umgehen des Pushschutzes überwachen. Weitere Informationen findest du unter Verwalten von Regelsätzen für Repositorys in deiner Organisation und Informationen zu Regelsätzen.

Mit REST und GraphQL APIs kannst du Regelsätze verwalten. Weitere Informationen findest du unter REST-API-Endpunkte für Regeln und Mutationen.

Hinweis

Alle Personen mit Lesezugriff auf ein Repository können die aktiven Regelsätze für dieses Repository anzeigen.

Bearbeiten eines Regelsatzes

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. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

  2. Wählen Sie eine Organisation aus, indem Sie darauf klicken.

  3. Klicke unter dem Organisationsnamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  4. Klicke auf der linken Randleiste im Abschnitt „Code, planning, and automation“ auf Repository und anschließend auf Rulesets.

    Screenshot: Seite „Einstellungen“ einer Organisation Auf der Randleiste ist ein Link mit der Bezeichnung „Regelsätze“ orange umrandet.

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

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

  7. 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 dessen Status auf „Disabled“ fest. Weitere Informationen findest du unter Bearbeiten eines Regelsatzes.

  1. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

  2. Wählen Sie eine Organisation aus, indem Sie darauf klicken.

  3. Klicke unter dem Organisationsnamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  4. Klicke auf der linken Randleiste im Abschnitt „Code, planning, and automation“ auf Repository und anschließend auf Rulesets.

    Screenshot: Seite „Einstellungen“ einer Organisation Auf der Randleiste ist ein Link mit der Bezeichnung „Regelsätze“ orange umrandet.

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

  6. Wähle rechts neben dem Namen des Regelsatzes aus, und klicke anschließend auf Delete ruleset.

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

Anzeigen von Erkenntnissen für Regelsätze

Du kannst Erkenntnisse für Regelsätze anzeigen, um zu sehen, wie diese sich auf die Repositorys in deiner Organisation auswirken. Auf der Seite „Regelerkenntnisse“ wird eine Zeitleiste der folgenden Benutzeraktionen angezeigt. Du kannst Filter verwenden, um das Gesuchte zu finden:

  • Aktionen, die mit einem oder mehreren Regelsätzen überprüft und bestanden wurden.
  • 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.

Darüber hinaus stehen diese Erkenntnisse über die REST-API der Regelsammlungen zur Verfügung.

Screenshot der Seite „Regel-Einblicke“. Drei Aktionen sind aufgelistet und markiert als: „Pass“, „Bypass“ und „Fail“. Die fehlgeschlagene Aktion ist mit der Bezeichnung „evaluate“ versehen.

  1. Klicke in der rechten oberen Ecke von GitHub auf dein Profilbild und dann auf Your organizations.

  2. Wählen Sie eine Organisation aus, indem Sie darauf klicken.

  3. Klicke unter dem Organisationsnamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

    Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.

  4. Klicken Sie in der linken Randleiste im Abschnitt "Code, Planung und Automatisierung" auf "Repository", und klicken Sie dann auf "Regelerkenntnisse".

    Screenshot: Seite „Einstellungen“ einer Organisation Auf der Randleiste ist ein Link mit der Bezeichnung „Regelerkenntnisse“ orange umrandet.

  5. Verwenden Sie oben auf der Seite „Regelerkenntnisse“ die Dropdownmenüs, um die Aktionen nach Regelsatz, Repository, Akteur und Zeitraum zu filtern.

  6. 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 „not-allowed“ ist das Symbol der drei horizontalen Punkte orange umrandet.

Verwalten von Anforderungen zum Umgehen von Pushregeln

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. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Repositorynamen auf Settings. 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. 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.