Définition de stratégies pour les référentiels dans votre entreprise

Pour contrôler les événements clés du cycle de vie de vos référentiels, tels que les personnes autorisées à créer ou à supprimer des référentiels, vous pouvez créer une stratégie de référentiel. Une stratégie de référentiel est un ensemble de restrictions qui vous permet de contrôler de manière flexible quels utilisateurs sont concernés et quels référentiels sont ciblés.

Dans une stratégie de référentiel, vous pouvez restreindre :

• Quelles visibilités sont autorisées pour les nouveaux référentiels et les modifications de visibilité.
• Qui peut créer des référentiels.
• Qui peut supprimer des référentiels.
• Qui peut transférer des référentiels hors d’une organisation.
• Comment les personnes peuvent nommer les référentiels.

Examples

Vous pouvez utiliser une stratégie de référentiel pour effectuer des opérations telles que :

• S’assurer que tous les nouveaux référentiels utilisent une certaine convention de nommage, telle que kebab-case.
• Empêcher les suppressions de référentiels, sauf par les administrateurs de l’organisation.
• Autoriser la création de référentiels publics uniquement dans l’organisation « open source » de votre entreprise.
• Empêcher que les référentiels publics ne soient transformés en référentiels privés afin d’éviter la perte potentielle de métadonnées.

Création d’une stratégie de référentiel

1. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
2. En haut de la page, cliquez sur Stratégies.
3. Dans « Stratégies », cliquez sur Référentiel.
4. Cliquez sur Nouvelle stratégie.
5. Configurez votre nouvelle stratégie, puis cliquez sur Créer. Pour obtenir de l’aide, consultez les sous-sections suivantes.

Nom de stratégie

Attribuez un nom qui décrit l’objectif de la stratégie. Les propriétaires de l’organisation peuvent voir la stratégie, par conséquent des noms explicites apportent de la clarté. Par exemple : Prevent public repos on production.

État de mise en œuvre

Si vous ne souhaitez pas que la stratégie soit appliquée lors de sa création, sélectionnez « Désactivée ». Dans le cas contraire, sélectionnez « Active ».

Liste d’autorisation

Choisissez les rôles qui peuvent contourner les restrictions de cette stratégie.

Targets

Sélectionnez les organisations et les référentiels auxquels la stratégie s’applique.

Organisations cibles

Sélectionnez toutes les organisations, choisissez une sélection d’organisations existantes ou définissez une liste dynamique par nom. Si vous utilisez Enterprise Managed Users, vous pouvez également choisir de cibler tous les référentiels appartenant aux utilisateurs de votre entreprise.

Si vous définissez une liste dynamique, vous ajouterez un ou plusieurs modèles de nommage en utilisant la syntaxe fnmatch. Par exemple, la chaîne *open-source correspond aux organisations dont le nom se termine par open-source. Pour plus d’informations sur la syntaxe, consultez Création d'ensembles de règles pour un dépôt.

Référentiels cibles

Choisissez quels référentiels (actuels ou futurs) cibler dans les organisations sélectionnées. Vous pouvez sélectionner tous les référentiels ou définir une liste dynamique par propriété personnalisée.

Policies

Choisissez les restrictions à inclure. Lorsque la stratégie est active, les restrictions s’appliquent à tous les référentiels ciblés, mais peuvent être contournées par les utilisateurs ou les équipes figurant sur la liste d’autorisation.

Si vous choisissez la stratégie « Restreindre les noms », vous devez utiliser la syntaxe expression régulière pour définir un modèle auquel les noms de référentiels doivent ou ne doivent pas correspondre. Par exemple, un modèle permettant d’appliquer le nommage kebab-case ressemblerait à ^([a-z][a-z0-9]*)(-[a-z0-9]+)*$.

• Les modèles prennent en charge la syntaxe RE2. Consultez le guide de syntaxe de Google.
• Pour valider vos expressions, cliquez sur Tester le modèle, puis entrez un modèle et une valeur de test.

Déléguer le contournement des stratégies

Le contournement délégué des stratégies de dépôt vous permet de contrôler qui peut contourner les stratégies de dépôt pour les suppressions et les modifications de visibilité du dépôt.

Avec le contournement délégué, les administrateurs du dépôt doivent soumettre une demande pour modifier la visibilité du dépôt ou le supprimer. La demande est envoyée à un groupe désigné de réviseurs, qui approuvent ou rejettent la demande visant à contourner les stratégies du dépôt.

Si la demande de contournement des stratégies du dépôt est approuvée, la modification demandée est immédiatement effectuée. Si la demande est rejetée, la modification demandée n’est pas effectuée, mais peut faire l’objet d’une nouvelle demande.

Pour configurer le contournement délégué, les propriétaires d’entreprise ou d’organisation doivent d’abord créer une « liste de contournement ». La liste de contournement comprend des rôles et des équipes spécifiques, tels que les administrateurs d’équipe ou de dépôt, qui supervisent les demandes de contournement des stratégies de dépôt.

Étapes suivantes

Créez des ensembles de règles pour régir de manière cohérente les branches importantes dans les référentiels de votre entreprise. Consultez Protection des branches dans votre entreprise à l'aide d'ensembles de règles.