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

Vous pouvez modifier, surveiller et supprimer les ensembles de règles existants afin de modifier la façon dont les personnes peuvent interagir avec les référentiels de votre organisation.

Qui peut utiliser cette fonctionnalité ?

Organization owners and users with the "Manage organization ref update rules and rulesets" permission can manage rulesets at the organization level.

Dans cet article

À 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.

Pour plus d’informations sur la façon dont les ensembles de règles d’organisation affectent le changement de nom de branche, consultez Autoriser les administrateurs de référentiels à renommer des branches avec des ensembles de règles d’organisation.

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 ».

Remarque

Toute personne disposant d’un accès en lecture à un dépôt peut voir les ensembles de règles actifs fonctionnant sur ce dépôt.

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. Sélectionnez une organisation en cliquant dessus.

  3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran des onglets dans le profil d’une organisation. L’onglet « Paramètres » est présenté en orange foncé.

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

    Capture d’écran de la page des paramètres d’une organisation. Dans la barre latérale, un lien intitulé « Ensembles de règles » est encadré en orange.

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

  6. 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.

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

Suppression d’un ensemble de règles

Conseil

Si vous souhaitez désactiver temporairement un ensemble de règles, mais que vous ne souhaitez pas le supprimer, vous pouvez définir l’état de l’ensemble de règles sur « Désactivé » Pour plus d’informations, consultez Modification 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. Sélectionnez une organisation en cliquant dessus.

  3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran des onglets dans le profil d’une organisation. L’onglet « Paramètres » est présenté en orange foncé.

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

    Capture d’écran de la page des paramètres d’une organisation. Dans la barre latérale, un lien intitulé « Ensembles de règles » est encadré en orange.

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

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

    Capture d’écran de la page de modification d’un ensemble de règles. Sous un bouton représenté par trois points, une option intitulée « Supprimer l’ensemble de règles » est encadrée en orange.

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. Sélectionnez une organisation en cliquant dessus.

  3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran des onglets dans le profil d’une organisation. L’onglet « Paramètres » est présenté en orange foncé.

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

    Capture d’écran de la page des paramètres d’une organisation. Dans la barre latérale, un lien intitulé « Ensembles de règles » est encadré en orange.

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

    Capture d’écran de la page des ensembles de règles d’un référentiel. Le menu déroulant « Nouvel ensemble de règles » est développé et l’option « Importer un ensemble de règles » est mise en évidence en orange.

  6. Ouvrez le fichier JSON exporté.

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