Skip to main content

Conversion de protections de branche en ensembles de règles

Utilisez des ensembles de règles pour obtenir une visibilité et un contrôle plus clairs sur vos protections de référentiel tout en préservant leur comportement existant.

Qui peut utiliser cette fonctionnalité ?

People with admin access to a repository, or a custom role with the "edit repository rules" permission, can create, edit, and delete rulesets for a repository.

Les ensembles de règles sont disponibles dans les référentiels publics avec GitHub Free et GitHub Free pour les organisations, ainsi que dans les référentiels publics et privés avec GitHub Pro, GitHub Teamet GitHub Enterprise Cloud. Consultez « plans de GitHub ».

Les jeux de règles de poussée sont disponibles avec l’offre GitHub Team dans les référentiels internes et privés, ainsi que dans les forks de référentiels pour lesquels des jeux de règles de poussée sont activés.

À propos de la conversion de protections de branche en ensembles de règles

Les ensembles de règles vous donnent une visibilité et un contrôle plus clairs sur la façon dont les protections s’appliquent à un référentiel. Contrairement aux règles de protection des branches, plusieurs ensembles de règles peuvent s’appliquer à la même branche en même temps, et les personnes disposant d’un accès en lecture peuvent afficher les ensembles de règles actifs. Cela permet aux développeurs de comprendre les règles qui les affectent et de permettre aux auditeurs d’examiner les protections des référentiels sans accès administrateur.

Pour déplacer vos protections existantes vers ce modèle, convertissez une règle de protection de branche à la fois dans un flux guidé. GitHub génère un ou plusieurs ensembles de règles qui conservent le comportement de la règle d’origine. Vous pouvez afficher un aperçu des ensembles de et vérifier le résultat avant de supprimer la règle de protection de branche d’origine.

Pour plus d’informations sur les ensembles de règles, consultez À propos des ensembles de règles.

Conversion d’une règle de protection de branche en ensemble de règles

  1. Sur GitHub, accédez à la page principale du référentiel.

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

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Branches.

  4. Sous « Règles de protection de branche », recherchez la règle à convertir, puis cliquez sur Convertir en ensemble de règles.

  5. Définissez le nom de l’ensemble de règles pour chaque ensemble de règles qui sera créé dans cette conversion.

  6. Passez en revue la section « Nouveau comportement » pour comprendre ce qui changera lorsque vous créez l’ensemble de règles ou les ensembles de règles.

  7. Si vous le souhaitez, pour supprimer la règle de protection de branche d’origine dans le cadre de la conversion, sélectionnez Supprimer la règle de protection de branche une fois la migration terminée.

  8. Cliquez sur Créer un ensemble de règles. Si la conversion produit plusieurs ensembles de règles, le bouton inclut le nombre d’ensembles de règles, par exemple , Créer 2 ensembles de règles.

Si vous conservez la règle de protection de branche d’origine, elle continue de protéger les branches correspondantes. Un ensemble de règles actif est appliqué en même temps que lui, de sorte que les modifications doivent satisfaire les deux.

Remarque

La conversion couvre tous les types de protection de branche à l’exception du paramètre « Exiger la résolution de conversation avant de fusionner ». Dans les protections de branche, ce paramètre existe lui-même. Dans les ensembles de règles, la résolution de conversation fait partie de la règle de demande de tirage et s’applique uniquement lorsque cette règle est activée. Par conséquent, ce paramètre ne mappe pas un à un lors de la conversion. Consultez « Règles disponibles pour les ensembles de règles ».

Le nouveau jeu de règles a un état Actif , ce qui signifie qu’il est appliqué dès qu’il est créé.

Suppression de la règle de protection de branche d’origine

Après avoir converti une règle, revenez à la page paramètres branches . Si vous n’avez pas choisi de supprimer la règle de protection de branche pendant le processus de conversion et que le nouveau jeu de règles l’couvre entièrement, la règle répertoriée affiche le message « Cette règle est entièrement couverte par les ensembles de règles et peut être supprimée en toute sécurité », et un bouton Supprimer apparaît à la place du bouton Convertir en ensemble de règles .

Avant de supprimer la règle d’origine, nous vous recommandons de confirmer que le nouveau jeu de règles se comporte comme prévuÉvaluer. Lorsque vous êtes prêt, cliquez sur Supprimer pour supprimer la règle de protection de branche.

Lectures complémentaires