À 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 règles, choisir la façon dont chacun est appliqué 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
-
Sur GitHub, accédez à la page principale du référentiel.
-
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.
-
Dans la section « Code et automatisation » de la barre latérale, cliquez sur Branches.
-
Sous « Règles de protection de branche », recherchez la règle à convertir, puis cliquez sur Convertir en ensemble de règles.
-
Définissez le nom de l’ensemble de règles pour chaque ensemble de règles qui sera créé dans cette conversion.
-
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.
-
Sous « État de l’application », choisissez la façon dont le nouvel ensemble de règles est appliqué. Pour plus d’informations, consultez Choisir un état d’application.
-
Si vous avez choisi Active, vous pouvez éventuellement supprimer la règle de protection de branche d’origine dans le cadre de la conversion en sélectionnant Supprimer la règle de protection de branche une fois la migration terminée.
-
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. Un ensemble de règles Evaluate enregistre son comportement sans appliquer ses règles.
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 ».
Choix d’un état d’application
Lorsque vous convertissez une règle de protection de branche, vous choisissez un état d’application pour le nouvel ensemble de règles.
- Actif : l’ensemble de règles est appliqué dès sa création.
- Évaluer : l’ensemble de règles s’exécute sans appliquer ses règles. Vous pouvez donc examiner son comportement avant qu’il ne prenne effet.
Bien que l’option Active soit sélectionnée par défaut, considérez l’état correspondant à votre situation :
- Si vous avez créé ou migré des règles similaires avant et que vous êtes confiant dans le résultat, vous pouvez utiliser Active.
- Si c’est votre première migration, envisagez de commencer en mode Évaluer . Vous pouvez confirmer que le nouveau jeu de règles se comporte comme prévu, puis supprimer la règle de protection de branche d’origine une fois que vous avez terminé le test.
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, en particulier si vous l’avez créé en modeÉvaluer. Lorsque vous êtes prêt, cliquez sur Supprimer pour supprimer la règle de protection de branche.