Artikelversion: Enterprise Server 2.17
Geschützte Branches und erforderliche Statuschecks konfigurieren
Sie können zum Begrenzen von Branch-Änderungen geschützte Branches aktivieren und erforderliche Statuschecks erzwingen, bevor ein Branch in einem Pull Request gemergt wird oder bevor Commits auf einem lokalen Branch per Push-Vorgang an den geschützten Remote-Branch übertragen werden können.
Jeder, der über Administratorberechtigungen für ein Repository verfügt, kann Branch-Einschränkungen aktivieren.
Geschützten Branch für ein Repository aktivieren
- Navigiere in GitHub Enterprise zur Hauptseite des Repository.
- Klicke unter Deinem Repository-Namen auf Settings (Einstellungen).
- Klicke im linken Menü auf Branches.
- Klicke neben „Branch protection rules" (Branch-Schutzregeln) auf Add rule (Regel hinzufügen.)
- Gib unter „Branch name pattern" (Branch-Namensmuster) den Branch-Namen oder das Muster ein, das Du schützen möchtest.
- Click Create.
Arten von erforderlichen Statuschecks
| Art des erforderlichen Statuschecks | Einstellung | Merge-Anforderungen | Hinweise |
|---|---|---|---|
| Streng | Das Kontrollkästchen Require branches to be up-to-date before merging (Aktualität der Branches vor dem Mergen erzwingen) ist aktiviert. | Der Branch muss vor dem Mergen auf dem Stand des Basis-Branches sein. | Dies ist das Standardverhalten für erforderliche Statuschecks. Weitere Builds können erforderlich sein, da Sie den Head-Branch auf den neuesten Stand bringen müssen, nachdem andere Mitarbeiter Pull Requests in den geschützten Basis-Branch gemergt haben. |
| Locker | Das Kontrollkästchen Require branches to be up-to-date before merging (Aktualität der Branches vor dem Mergen erzwingen) ist nicht aktiviert. | Der Branch muss vor dem Mergen nicht auf dem Stand des Basis-Branches sein. | Es sind weniger Builds erforderlich, da Sie den Head-Branch nicht auf den neuesten Stand bringen müssen, nachdem andere Mitarbeiter Pull Requests gemergt haben. Statuschecks schlagen nach dem Mergen Ihres Branches möglicherweise fehl, wenn inkompatible Änderungen am Basis-Branch vorliegen. |
| Deaktiviert | Das Kontrollkästchen Require status checks to pass before merging (Statuschecks müssen vor dem Mergen bestanden werden) ist deaktiviert. | Für den Branch gelten keine Merge-Einschränkungen. | Wenn die erforderlichen Statuschecks nicht aktiviert sind, können Mitarbeiter den Branch unabhängig von seinem Stand gegenüber dem Basis-Branch jederzeit mergen. Die Wahrscheinlich inkompatibler Änderungen erhöht sich dadurch jedoch. |
Erforderliche Statuschecks aktivieren
- Navigiere in GitHub Enterprise zur Hauptseite des Repository.
- Klicke unter Deinem Repository-Namen auf Settings (Einstellungen).
- Klicke im linken Menü auf Branches.
- Klicke neben „Branch protection rules" (Branch-Schutzregeln) auf Add rule (Regel hinzufügen.)
- Gib unter „Branch name pattern" (Branch-Namensmuster) den Branch-Namen oder das Muster ein, das Du schützen möchtest.
- Aktivieren Sie Require status checks to pass before merging (Statuschecks müssen vor dem Mergen bestanden werden).
- Wählen Sie in der Liste der verfügbaren Statuschecks die Checks aus, die als erforderlich festgelegt werden sollen.
- Wähle optional Include administrators (Administratoren einbeziehen). Dies erzwingt alle konfigurierten Einschränkungen für Repository-Administratoren.
- Deaktivieren Sie optional Require branches to be up to date before merging (Erzwingen, dass Branches vor dem Mergen aktuell sein müssen). Wenn diese Option ausgewählt ist, wird der Branch mit dem neuesten Code auf dem Basis-Branch getestet.
- Optionally, select Restrict who can push to this branch.
- Search for and select the people or teams who will have permission to push to the protected branch.
- Click Create.
Tipp: Um einen Pull-Request erfolgreich in einen Basis-Branch überzuführen, der erforderliche Statuschecks aktiviert hat, muss der Head-Branch des Pull-Requests mit dem Basis-Branch aktuell sein.