Configurer la protection des branches

Cette page explique comment configurer la protection des branches pour les dépôts Secure Source Manager.

La protection des branches permet aux administrateurs de dépôt de définir des règles pour contrôler qui peut apporter des modifications aux branches, qui doit approuver ou examiner les modifications, et quelles conditions doivent être remplies avant qu'une modification approuvée puisse être fusionnée dans une branche.

Pour en savoir plus sur les règles de protection des branches, consultez Présentation de la protection des branches.

Avant de commencer

  1. Créez une instance Secure Source Manager.
  2. Créez un dépôt Secure Source Manager.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer des règles de protection des branches pour un dépôt Secure Source Manager, demandez à votre administrateur de vous accorder les rôles IAM suivants :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour savoir comment accorder des rôles Secure Source Manager, consultez Contrôle des accès avec IAM et Accorder aux utilisateurs l'accès à l'instance.

Créer une règle de protection de branche

Pour créer une règle de protection de branche, procédez comme suit :

  1. Dans l'interface Web Secure Source Manager, sélectionnez le dépôt que vous souhaitez protéger avec une règle de protection des branches.
  2. Sur la page du dépôt, cliquez sur Settings (Paramètres).
  3. Cliquez sur l'onglet Règle de branchement.
  4. Cliquez sur Ajouter une règle de branche.

  5. Dans le champ ID de la règle de branche, saisissez un nom pour la règle de branche.

    Les ID de règles de branche sont limités aux lettres minuscules, aux chiffres et aux traits d'union. Le premier caractère doit être une lettre, et le dernier doit être une lettre ou un chiffre. Les ID de règles de branche ne doivent pas comporter plus de 63 caractères.

  6. Dans le champ Filtre de branche, saisissez le nom de la branche à laquelle vous souhaitez appliquer la règle. Si vous souhaitez que la règle s'applique à toutes les branches, saisissez .*. La correspondance complète des expressions régulières n'est pas acceptée.

    Les filtres de règles de branche activés doivent être uniques à leur dépôt. Les utilisateurs peuvent disposer de plusieurs filtres de règles de branchement désactivés. Par exemple, vous ne pouvez pas avoir deux règles de branche activées dans un même dépôt avec le filtre de branche main.

    Lorsqu'une branche est concernée par plusieurs règles, la règle de branche avec un nom de branche spécifique comme filtre de branche remplace la règle de caractère générique. Par exemple, une règle de branchement avec le filtre de branchement main remplacera une règle de branchement avec le filtre de branchement .*. Les règles ne sont pas combinées.

  7. Dans la section Détails de la règle de protection de branche, spécifiez les exigences de votre règle de branche parmi les options suivantes :

    • Exiger une demande d'extraction avant la fusion : si cette option est activée, les commits directs vers la branche seront bloqués. Une demande d'extraction doit être ouverte avant la fusion dans la branche protégée.

    • Nombre d'examinateurs requis : indiquez le nombre d'examinateurs requis pour approuver la demande d'extraction d'extraction afin de la fusionner.

    • Nombre d'approbateurs requis : spécifiez le nombre d'approbateurs requis pour approuver la demande d'extraction et la fusionner.

      Les réviseurs et les approbateurs sont des utilisateurs disposant de rôles IAM spécifiques. Pour connaître les rôles requis pour les réviseurs et les approbateurs, consultez Présentation de la protection des branches.

    • Bloquer la fusion en cas d'approbations et d'examens obsolètes : si cette option est activée, un examen ou une approbation sont supprimés si de nouveaux commits sont envoyés à la demande d'extraction d'extraction après l'octroi de l'examen ou de l'approbation.

    • Exiger la résolution des conversations avant la fusion : si cette option est activée, tous les commentaires sur le code et les demandes de révision des modifications doivent être résolus avant la fusion.

    • Exiger un historique linéaire : si cette option est activée, les demandes de pull qui créeraient un historique Git non linéaire ne peuvent pas être fusionnées.

    • Exiger des vérifications de l'état : si cette option est activée, les vérifications de l'état de compilation sélectionnées doivent réussir avant qu'une demande d'extraction'extraction puisse être fusionnée. Vous devez configurer des déclencheurs dans votre fichier de déclencheurs avant de pouvoir les sélectionner comme vérifications d'état pour la protection des branches.

  8. Pour enregistrer la règle de branche, cliquez sur Envoyer.

L'onglet "Règles de branche" s'affiche, avec votre nouvelle règle de branche.

Modifier une règle de protection de branche

Pour modifier une règle de protection de branche :

  1. Dans l'interface Web Secure Source Manager, sélectionnez le dépôt contenant la règle de protection de branche que vous souhaitez modifier.
  2. Sur la page du dépôt, cliquez sur Settings (Paramètres).
  3. Cliquez sur l'onglet Règles de branche.
  4. Cliquez sur le nom de la règle de branchement que vous souhaitez modifier.
  5. Modifiez la règle de protection de branche.
  6. Cliquez sur Mettre à jour.

La règle de protection de branche est mise à jour.

Supprimer une règle de protection de branche

Pour supprimer une règle de protection de branche :

  1. Dans l'interface Web Secure Source Manager, sélectionnez le dépôt dont vous souhaitez supprimer la règle de branche.
  2. Sur la page du dépôt, cliquez sur Settings (Paramètres).
  3. Cliquez sur l'onglet Règle de branchement.
  4. Sur la ligne de la règle que vous souhaitez supprimer, cliquez sur l'icône Supprimer supprimer.
  5. Sur l'écran de confirmation Supprimer la règle de branchement, cliquez sur Oui.

La règle de protection de branche est supprimée.

Étapes suivantes