Gestion des ensembles de règles pour les dépôts de votre organisation

À propos de la gestion des ensembles de règles d’une organisation

Après avoir créé un ensemble de règles au niveau de l'organisation, vous pouvez apporter des modifications à l'ensemble de règles afin de modifier la façon dont les personnes peuvent interagir avec les référentiels ciblés. Par exemple, vous pouvez ajouter des règles pour mieux protéger les branches ou les balises dans ces référentiels, ou vous pouvez basculer votre ensemble de règles du mode « Evaluate » au mode « Active » après avoir testé ses effets sur l'expérience des contributeurs pour vos référentiels. Les ensembles de règles d'organisation qui s'appliquent aux branches d'un référentiel ne permettront plus à l'administrateur du référentiel de renommer les branches du référentiel ciblé ni de remplacer la branche par défaut par une autre branche. Les administrateurs de référentiel peuvent créer et supprimer des branches tant qu'ils disposent des autorisations appropriées.

Le contournement délégué pour les ensembles de règles de Push vous permet de contrôler qui peut contourner la protection push et les push bloqués qui doivent être autorisés.

Avec le contournement délégué, les contributeurs d'un dépôt doivent demander des "privilèges de contournement" lorsqu'ils déposent des livraisons dont le contenu est restreint. La demande est envoyée à un groupe désigné de réviseurs, qui approuvent ou refusent la demande pour contourner des règles de Push.

Si la demande de contournement des règles de diffusion est approuvée, le contributeur peut diffuser la livraison contenant le contenu restreint. Si la demande est refusée, le contributeur doit supprimer le contenu du (ou des) commit(s) contenant le contenu restreint avant de l'envoyer à nouveau.

Pour configurer le contournement délégué, les propriétaires d’organisations ou les administrateurs de référentiels créent d’abord une « liste de contournement ». La liste de contournement comprend des rôles et des équipes spécifiques, tels que les administrateurs d'équipes ou de référentiels, qui supervisent les demandes de contournement de la protection push. Pour plus d’informations, consultez « Gestion des ensembles de règles pour les dépôts de votre organisation » et « À propos des ensembles de règles ».

Vous pouvez utiliser les API REST et GraphQL pour gérer les ensembles de règles. Pour plus d’informations, consultez « Points de terminaison d’API REST pour les règles » et « Mutations ».

Modification d’un ensemble de règles

Vous pouvez modifier un ensemble de règles pour en changer certaines parties, telles que le nom, les autorisations de contournement ou les règles. Vous pouvez également modifier un ensemble de règles pour changer son état, par exemple si vous souhaitez activer ou désactiver temporairement un ensemble de règles.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. En regard de l’organisation, cliquez sur Paramètres.

3. Dans la barre latérale gauche, dans la section « Code, planification et automatisation », cliquez sur Repository, puis cliquez sur Jeux de règles.

   

4. Dans la page « Ensembles de règles », cliquez sur le nom de l’ensemble de règles que vous souhaitez modifier.

5. Modifiez l’ensemble de règles si nécessaire. Pour plus d’informations sur les règles disponibles, consultez Règles disponibles pour les ensembles de règles.

6. En bas de la page, cliquez sur Save changes.

Suppression d’un ensemble de règles

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. En regard de l’organisation, cliquez sur Paramètres.

3. Dans la barre latérale gauche, dans la section « Code, planification et automatisation », cliquez sur Repository, puis cliquez sur Jeux de règles.

   

4. Cliquez sur le nom de l’ensemble de règles que vous voulez supprimer.

5. À droite du nom du jeu de règles, sélectionnez , puis cliquez sur Supprimer un jeu de règles.

   

Utilisation de l'historique des ensembles de règles

L’historique des ensembles de règles répertorie les événements déclenchés par les modifications qui affectent vos ensembles de règles au cours des 180 derniers jours.

Vous pouvez afficher toutes les modifications apportées à un ensemble de règles et revenir à une itération spécifique. Vous pouvez également télécharger un fichier JSON contenant la configuration de l’ensemble de règles à une itération spécifique. La liste de contournement d’un ensemble de règles est exclue du fichier JSON exporté.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. En regard de l’organisation, cliquez sur Paramètres.

3. Dans la barre latérale gauche, dans la section « Code, planification et automatisation », cliquez sur Repository, puis cliquez sur Jeux de règles.

   

4. Pour afficher l’historique des modifications de l’ensemble de règles, sélectionnez à droite du nom de l’ensemble de règles, puis cliquez sur Historique.

   

5. À droite de l’itération spécifique, sélectionnez , puis cliquez sur Comparer les modifications, Restaurer ou Télécharger.

   

Importation d'un ensemble de règles

Vous pouvez importer un ensemble de règles depuis un autre référentiel ou une autre organisation en utilisant le fichier JSON exporté de la section précédente. Cela peut être utile si vous souhaitez appliquer le même ensemble de règles à plusieurs référentiels ou organisations.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. En regard de l’organisation, cliquez sur Paramètres.

3. Dans la barre latérale gauche, dans la section « Code, planification et automatisation », cliquez sur Repository, puis cliquez sur Jeux de règles.

   

4. Sélectionnez la liste déroulante Nouvel ensemble de règles, puis cliquez sur Importer un ensemble de règles.

   

5. Ouvrez le fichier JSON exporté.

6. Passez en revue l’ensemble de règles importé, puis cliquez sur Créer.