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. Du kannst z. B. Regeln hinzufügen, um die Verzweigungen oder Tags in diesen Repositorys besser zu schützen, oder du kannst den Regelsatz aus dem Modus „Auswerten“ in „Aktiv“ ändern, nachdem du seine Auswirkungen auf die Mitwirkendenerfahrung für deine Repositorys getestet hast. Organisationsregeln, die für den „Default Branch“ eines Repositorys gelten, erlauben dem Repositoryadministrator nicht mehr, Aktualisierungen an der Standardverzweigung des Zielrepositorys vorzunehmen.

Mit REST und GraphQL APIs kannst du Regelsätze verwalten. Weitere Informationen finden Sie unter REST-API-Endpunkte für Regeln und unter 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. Wähle in der oberen rechten Ecke von GitHub.com dein Profilfoto aus. Klicke dann auf Deine Organisationen.

    Screenshot des Dropdownmenüs unter dem Profilbild von @octocat. „Deine Organisationen“ ist in dunklem Orange eingerahmt.

  2. Klicke neben der Organisation auf Einstellungen.

  3. Wähle auf der linken Randleiste im Abschnitt „Code, Planung und Automatisierung“ die Option Repository aus, und klicke dann auf Regelsätze.

    Screenshot: Seite „Einstellungen“ einer Organisation Auf der Randleiste ist ein Link mit der Bezeichnung „Regelsätze“ 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

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.

  1. Wähle in der oberen rechten Ecke von GitHub.com dein Profilfoto aus. Klicke dann auf Deine Organisationen.

    Screenshot des Dropdownmenüs unter dem Profilbild von @octocat. „Deine Organisationen“ ist in dunklem Orange eingerahmt.

  2. Klicke neben der Organisation auf Einstellungen.

  3. Wähle auf der linken Randleiste im Abschnitt „Code, Planung und Automatisierung“ die Option Repository aus, und klicke dann auf Regelsätze.

    Screenshot: Seite „Einstellungen“ einer Organisation Auf der Randleiste ist ein Link mit der Bezeichnung „Regelsätze“ 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

  1. Wähle in der oberen rechten Ecke von GitHub.com dein Profilfoto aus. Klicke dann auf Deine Organisationen.

    Screenshot des Dropdownmenüs unter dem Profilbild von @octocat. „Deine Organisationen“ ist in dunklem Orange eingerahmt.

  2. Klicke neben der Organisation auf Einstellungen.

  3. Wähle auf der linken Randleiste im Abschnitt „Code, Planung und Automatisierung“ die Option Repository aus, und klicke dann auf Regelsätze.

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

Importieren eines Regelsets

Sie können einen Regelsatz aus einem anderen Repository oder einer anderen Organisation importieren, indem Sie die exportierte JSON-Datei aus dem vorherigen Abschnitt verwenden. Dies kann besonders dann hilfreich sein, wenn Sie denselben Regelsatz auf mehrere Repositorys oder Organisationen anwenden möchten.

  1. Wähle in der oberen rechten Ecke von GitHub.com dein Profilfoto aus. Klicke dann auf Deine Organisationen.

    Screenshot des Dropdownmenüs unter dem Profilbild von @octocat. „Deine Organisationen“ ist in dunklem Orange eingerahmt.

  2. Klicke neben der Organisation auf Einstellungen.

  3. Wähle auf der linken Randleiste im Abschnitt „Code, Planung und Automatisierung“ die Option Repository aus, und klicke dann auf Regelsätze.

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

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 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. Wähle in der oberen rechten Ecke von GitHub.com dein Profilfoto aus. Klicke dann auf Deine Organisationen.

    Screenshot des Dropdownmenüs unter dem Profilbild von @octocat. „Deine Organisationen“ ist in dunklem Orange eingerahmt.

  2. Klicke neben der Organisation auf Einstellungen.

  3. Wählen Sie auf der linken Randleiste im Abschnitt „Code, Planung und Automatisierung“ die Option Repository und klicken Sie dann auf Regelerkenntnisse.

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

  4. Verwenden Sie oben auf der Seite „Regelerkenntnisse“ die Dropdownmenüs, um die Aktionen nach Regelsatz, Repository, 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.