Hinweis
-Repositoryrichtlinien befinden sich derzeit in der öffentliche Vorschau. Änderungen sind vorbehalten. Du kannst bis zu 75 Richtlinien und Regelsätze pro Organisation und bis zu 75 Richtlinien und Regelsätze insgesamt pro Unternehmen haben.
Du kannst eine Repositoryrichtlinie erstellen, um wichtige Ereignisse im Lebenszyklus deiner Repositorys zu steuern, z. B. wer Repositorys erstellen oder löschen kann. Eine Repositoryrichtlinie ist eine Sammlung von Einschränkungen, mit denen du flexibel steuern kannst, für welche Benutzer diese gelten und welche die Zielrepositorys sind.
In einer Repositoryrichtlinie kannst du Folgendes einschränken:
- Welche Sichtbarkeitsoptionen für neue Repositorys und Sichtbarkeitsänderungen zulässig sind
- Wer Repositorys erstellen kann
- Wer Repositorys löschen kann
- Wer Repositorys aus einer Organisation heraus **übertragen ** kann
- Wie Personen Repositorys benennen können
Examples
Du kannst eine Repositoryrichtlinie unter anderem für folgende Aufgaben verwenden:
- Sicherstellen, dass alle neuen Repositorys einer bestimmten Benennungskonvention folgen, beispielsweise
kebab-case - Verhindern des Löschens von Repositorys außer durch Organisationsadministratoren
- Zulassen, dass öffentliche Repositorys nur in der „Open Source“-Organisation in deinem Unternehmen erstellt werden
- Verhindern, dass öffentliche Repositorys in private Repositorys geändert werden, um potenziellen Verlust von Metadaten zu vermeiden
Erstellen einer Repositoryrichtlinie
- Navigieren Sie zu Ihrem Unternehmen. Beispielsweise auf der Seite Unternehmen in GitHub.com.
- Klicke oben auf der Seite auf Policies.
- Klicke unter „Policies“ auf Repository.
- Klicken Sie auf Neue Richtlinie.
- Konfiguriere deine neue Richtlinie, und klicke dann auf Create. Hilfe findest du in den folgenden Unterabschnitten.
Richtlinienname
Verwende ein beschreibendes Element, um den Zweck der Richtlinie darzustellen. Organisationsbesitzer können die Richtlinie anzeigen. Daher sorgt eine gute Benennung für mehr Klarheit. Beispiel: Prevent public repos on production.
Durchsetzungsstatus
Wenn die Richtlinie nicht erzwungen werden soll, wenn sie erstellt wird, lege diese auf „Disabled“ fest. Andernfalls wird „Active“ festgelegt.
Zulassungsliste
Wähle aus, welche Rollen die Einschränkungen in dieser Richtlinie umgehen können.
Ziele
Wähle aus, für welche Organisationen und Repositorys die Richtlinie gilt.
Zielorganisationen
Wähle alle Organisationen aus, wähle einige vorhandene Organisationen aus, oder lege anhand des Namens eine dynamische Liste fest. Wenn du Enterprise Managed Users verwendest, kannst du auch alle Repositorys auswählen, die sich im Besitz von Benutzern deines Unternehmens befinden.
Wenn du eine dynamische Liste festlegst, fügst du mithilfe der fnmatch-Syntax ein oder mehrere Benennungsmuster hinzu. Beispielsweise würde die Zeichenfolge *open-source mit allen Organisationen übereinstimmen, deren Namen mit open-source enden. Weitere Informationen zur Syntax findest du unter Erstellen von Regelsätzen für ein Repository.
Ziel-Repositories
Wähle aus, welche aktuellen und zukünftigen Repositorys in den ausgewählten Organisationen ausgewählt werden sollen. Du kannst alle Repositorys auswählen oder nach einer benutzerdefinierten Eigenschaft eine dynamische Liste festlegen.
Politik
Wähle aus, welche Einschränkungen enthalten sein sollen. Wenn die Richtlinie aktiv ist, gelten die Einschränkungen für alle Zielrepositorys, können jedoch von Benutzern oder Teams auf der Zulassungsliste umgangen werden.
Wenn du die Richtlinie „Restrict names“ auswählst, musst du reguläre Ausdrücke verwenden, um ein Muster festzulegen, mit dem Repositorynamen entweder übereinstimmen oder nicht übereinstimmen müssen. Ein Muster zum Erzwingen der Benennung kebab-case würde z. B. wie folgt aussehen: ^([a-z][a-z0-9]*)(-[a-z0-9]+)*$.
- Muster unterstützen die RE2-Syntax. Weitere Informationen findest du im Syntaxleitfaden von Google.
- Klicke auf Test pattern, und gib dann ein Muster und einen Testwert ein, um deine Ausdrücke zu überprüfen.
Delegieren der Umgehung von Richtlinien
Hinweis
Die delegierte Umgehung der Repositoryrichtlinie befindet sich in öffentliche Vorschau. Änderungen sind vorbehalten.
Mit der delegierten Umgehung für Repositoryrichtlinien kannst du steuern, wer Repositoryrichtlinien für Repositorylöschungen und Sichtbarkeitsänderungen umgehen kann.
Mit der delegierten Umgehung müssen Repositoryadministratoren eine Anforderung übermitteln, um die Sichtbarkeit des Repositorys zu ändern oder das Repository zu löschen. Die Anforderung wird an eine bestimmte Gruppe von Prüfern gesendet, die die Anforderung zum Umgehen der Repositoryrichtlinien genehmigen oder verweigern.
Wenn die Anforderung zum Umgehen von Repositoryrichtlinien genehmigt wird, wird die Anforderungsänderung sofort abgeschlossen. Wenn die Anforderung abgelehnt wird, wird die angeforderte Änderung nicht vorgenommen, kann aber erneut angefordert werden.
Um die delegierte Umgehung zu konfigurieren, erstellen Unternehmensbesitzer oder Organisationsbesitzer zuerst eine „Umgehungsliste“. Die Umgehungsliste umfasst bestimmte Rollen und Teams, z. B. Team- oder Repositoryadministratoren, die Anforderungen zum Umgehen der Repositoryrichtlinien überwachen.
Nächste Schritte
Erstellen Sie Regelsätze, um wichtige Filialen in den Repositorys Ihres Unternehmens konsistent zu steuern. Weitere Informationen findest du unter Schützen von Filialen in Ihrem Unternehmen mit Regelsätzen.