Verwaltung der Verwendung von Repositorys in Ihrem Unternehmen

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

Beispiele

Du kannst eine Repositoryrichtlinie unter anderem für folgende Aufgaben verwenden:

• Sicherstellen, dass alle neuen Repositorys einer bestimmten Benennungskonvention folgen, beispielsweisekebab-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

Wie wähle ich Zielrepositorys aus?

Zunächst wählst du Organisationen in deinem Unternehmen aus. Du kannst alle Organisationen auswählen, aus einer Liste auswählen oder eine dynamische Regel mithilfe der fnmatch-Syntax erstellen. Wenn Sie Enterprise Managed Users verwenden, können Sie auch auswählen, alle Repositorys zu prüfen, die von Benutzern in Ihrem Unternehmen verwaltet werden.

Anschließend wählst du Repositorys in den ausgewählten Organisationen aus. Es wird empfohlen, Repositoryrichtlinien zusammen mit benutzerdefinierten Repositoryeigenschaften zu nutzen. Durch das Hinzufügen von benutzerdefinierten Eigenschaften zu Repositorys können Sie diese Repositorys flexibel in einer Richtlinie ansprechen.

Du kannst beispielsweise eine Eigenschaft hinzufügen, um Repositorys zu markieren, die Produktionsdaten oder andere vertrauliche Informationen enthalten, und dann verhindern, dass diese Repositorys öffentlich gemacht werden können.

Interagieren mit anderen Richtlinien

Einige der verfügbaren Einschränkungen sind Duplikate von Richtlinien, die du möglicherweise auf der Seite „Member privileges“ in den Organisations- oder Unternehmenseinstellungen festgelegt hast.

Durch das Erstellen einer Repositoryrichtlinie werden deine vorhandenen Richtlinien für Mitgliederberechtigungen nicht außer Kraft gesetzt. Diese Richtlinien sind additiv, sodass die restriktivste Version einer Richtlinie gilt. Dies gilt sowohl für Mitgliedsberechtigungsrichtlinien als auch für andere Repositoryrichtlinien, die Personen auf Unternehmens- oder Organisationsebene erstellt haben.

Im Vergleich zu Mitgliedsberechtigungsrichtlinien haben Repositoryrichtlinien mehrere Vorteile:

• Sie bieten flexiblere Auswahlmöglichkeiten für Zielorganisationen und -repositorys.
• Mit ihnen kannst du es bestimmten Akteuren ermöglichen, die Richtlinien zu umgehen.
• Sie sind für Organisationsbesitzer sichtbar, wodurch transparenter wird, was erlaubt ist.
• Sie ermöglichen es Ihnen, Repositorys im Besitz von Enterprise Managed Users.

Erstellen einer Repositoryrichtlinie

1. Navigieren Sie zu Ihrem Unternehmen. Beispielsweise auf der Seite Unternehmen in GitHub.com.
2. Klicken Sie oben auf der Seite auf "Richtlinien".
3. Klicke unter „Policies“ auf Repository.
4. Klicken Sie auf Neue Richtlinie.
5. 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.

Vollzugsstatus

Wenn die Richtlinie nicht erzwungen werden soll, wenn sie erstellt wird, lege diese auf „Disabled“ fest. Andernfalls wird „Active“ festgelegt.

Positivliste

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 Sie Enterprise Managed Users verwenden, können Sie auch auswählen, alle Repositorys zu prüfen, die von Benutzern in Ihrem Unternehmen verwaltet werden.

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-Repositorys

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.

Richtlinien

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

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.