Konvertieren von Verzweigungsschutzen in Rulesets

Verwenden Sie Regelsätze, um eine klarere Sichtbarkeit und Kontrolle über Ihre Repository-Schutzmaßnahmen zu erhalten und gleichzeitig ihr vorhandenes Verhalten beizubehalten.

Wer kann dieses Feature verwenden?

People with admin access to a repository, or a custom role with the "edit repository rules" permission, can create, edit, and delete rulesets for a repository.

Regelsätze sind in öffentlichen Repositorys für Organisationen mit GitHub Free und GitHub Free sowie in öffentlichen und privaten Repositorys mit GitHub Pro, GitHub Team und GitHub Enterprise Cloud verfügbar. Siehe Pläne von GitHub.

Push-Regelsätze sind im Tarif GitHub Enterprise Cloud für interne und private Repositorien, für Forks von Repositorien, für die Push-Regelsätze aktiviert sind, sowie für Organisationen in Ihrem Unternehmen verfügbar.

In diesem Artikel

Informationen zum Konvertieren von Verzweigungsschutz in Rulesets

Mit Regelsätzen erhalten Sie eine klarere Sichtbarkeit und Kontrolle darüber, wie Schutzmaßnahmen auf ein Repository angewendet werden. Im Gegensatz zu Verzweigungsschutzregeln können mehrere Rulesets gleichzeitig auf dieselbe Verzweigung angewendet werden, und Personen mit Lesezugriff können die aktiven Rulesets anzeigen. Auf diese Weise können Entwickler die Regeln verstehen, die sie betreffen, und Prüfer können Repositoryschutze ohne Administratorzugriff überprüfen.

Um Ihre vorhandenen Schutzmaßnahmen in dieses Modell zu verschieben, konvertieren Sie jeweils eine Verzweigungsschutzregel in einem geführten Fluss. GitHub generiert ein oder mehrere Regelsätze, die das Verhalten der ursprünglichen Regel beibehalten. Sie können eine Vorschau der Regelgruppen anzeigen, auswählen, wie jedes erzwungen wird, und das Ergebnis überprüfen, bevor Sie die ursprüngliche Verzweigungsschutzregel entfernen.

Weitere Informationen zu Regelsätzen finden Sie unter Informationen zu Regelsätzen.

Konvertieren einer Verzweigungsschutzregel in ein Regelsatz

  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. Klicke im Abschnitt „Code and automation“ der Randleiste auf Branches.

  4. Suchen Sie unter "Verzweigungsschutzregeln" die Regel, die Sie konvertieren möchten, und klicken Sie dann auf "In Regelsatz konvertieren".

  5. Legen Sie den Regelsatznamen für jedes Regelset fest, das in dieser Konvertierung erstellt wird.

  6. Überprüfen Sie den Abschnitt "Neues Verhalten", um zu verstehen, was sich ändern wird, wenn Sie das Regelset oder die Regelsätze erstellen.

  7. Wählen Sie unter "Erzwingungsstatus" aus, wie das neue Regelet erzwungen wird. Weitere Informationen finden Sie unter Auswählen eines Erzwingungsstatus.

  8. Wenn Sie "Aktiv" ausgewählt haben, können Sie optional die ursprüngliche Verzweigungsschutzregel als Teil der Konvertierung entfernen, indem Sie nach Abschluss der Migration die Option "Verzweigungsschutzregel löschen" auswählen.

  9. Klicken Sie auf "Regelsatz erstellen". Wenn die Konvertierung mehr als ein Regelsatz erzeugt, enthält die Schaltfläche die Anzahl der Regelets, z. B. Create 2 rulesets.

Wenn Sie die ursprüngliche Branch-Schutzregel beibehalten, werden übereinstimmende Verzweigungen weiterhin geschützt. Ein aktives Regelet wird zusammen mit diesem erzwungen, sodass Änderungen beide erfüllen müssen. Ein Evaluate-Regelsatz zeichnet auf, wie es sich verhalten würde, ohne seine Regeln zu erzwingen.

Hinweis

Bei der Konvertierung werden alle Branch-Schutztypen mit Ausnahme der Einstellung "Unterhaltungsauflösung vor dem Zusammenführen erforderlich" behandelt. In Verzweigungsschutzen ist diese Einstellung eigenständig vorhanden. In Regelets ist die Unterhaltungsauflösung Teil der Pull-Anforderungsregel und gilt nur, wenn diese Regel aktiviert ist. Daher wird diese Einstellung während der Konvertierung nicht einem zugeordnet. Siehe Verfügbare Regeln für Regelsätze.

Auswählen eines Erzwingungsstatus

Wenn Sie eine Verzweigungsschutzregel konvertieren, wählen Sie einen Erzwingungsstatus für das neue Regelet aus.

  • Aktiv: Das Regelsatz wird erzwungen, sobald es erstellt wird.
  • Auswerten: Das Regelet wird ausgeführt, ohne seine Regeln zu erzwingen, sodass Sie überprüfen können, wie es sich verhalten würde, bevor es wirksam wird.

Obwohl "Aktiv" standardmäßig ausgewählt ist, überlegen Sie, welcher Status zu Ihrer Situation passt:

  • Wenn Sie zuvor ähnliche Regeln erstellt oder migriert haben und sich auf das Ergebnis verlassen haben, können Sie Active verwenden.
  • Wenn dies Ihre erste Migration ist, sollten Sie im Auswertungsmodus beginnen. Sie können bestätigen, dass sich das neue Regelset wie erwartet verhält, und dann die ursprüngliche Branch-Schutzregel löschen, nachdem Sie den Test abgeschlossen haben.

Löschen der ursprünglichen Verzweigungsschutzregel

Kehren Sie nach dem Konvertieren einer Regel zur Seite " Verzweigungen " zurück. Wenn Sie die Verzweigungsschutzregel während des Konvertierungsprozesses nicht löschen und das neue Regelet sie vollständig abdeckt, zeigt die aufgelistete Regel die Meldung "Diese Regel wird vollständig von Regelsätzen abgedeckt und kann sicher gelöscht werden", und anstelle der Schaltfläche "In Regelsatz konvertieren" wird eine Schaltfläche "Löschen" angezeigt.

Bevor Sie die ursprüngliche Regel löschen, wird empfohlen, zu bestätigen, dass sich das neue Regelset erwartungsregelart verhält, insbesondere, wenn Sie sie im Auswertungsmodus erstellt haben. Wenn Sie fertig sind, klicken Sie auf "Löschen ", um die Verzweigungsschutzregel zu entfernen.

Weiterführende Lektüre