Gérer les actions autorisées pour une branche à l'aide de règles de branche

Lorsque vous créez une branche, certaines actions sont autorisées pour cette branche en fonction des autorisations associées à ce rôle. Vous pouvez modifier les actions autorisées pour une branche spécifique en configurant les règles de branche. Les règles de branche sont basées sur le rôle de l'utilisateur dans votre projet. Vous pouvez choisir de limiter certaines actions prédéfinies, telles que le transfert de validations vers une branche, aux utilisateurs ayant un rôle particulier dans un projet. Cela peut vous aider à protéger des branches spécifiques d'un projet en limitant les rôles autorisés à effectuer certaines actions. Par exemple, si vous configurez une règle de branche pour autoriser uniquement les utilisateurs ayant le rôle d'administrateur de projet à fusionner ou à transférer vers cette branche, les utilisateurs ayant d'autres rôles dans le projet ne pourront pas modifier le code de cette branche.

Vous devez examiner attentivement toutes les implications de la création d'une règle pour une branche. Par exemple, si vous choisissez de limiter les push vers une branche aux utilisateurs ayant le rôle d'administrateur de projet, les utilisateurs ayant le rôle de contributeur ne seront pas en mesure de créer ou de modifier des flux de travail dans cette branche, car le flux de travail YAML est stocké dans cette branche et ces utilisateurs ne peuvent pas valider et appliquer des modifications auYAML. Il est recommandé de tester les règles de branche une fois que vous les avez créées afin de vous assurer qu'elles n'ont aucun impact que vous n'aviez prévu. Vous pouvez également utiliser les règles de branche conjointement avec les règles d'approbation pour les pull requests. Pour plus d’informations, consultez Gestion des exigences relatives à la fusion d'une pull request avec les règles d'approbation.

Note

Vous devez avoir le rôle d'administrateur de projet pour gérer les règles de branche pour les référentiels sources dans les CodeCatalyst projets. Vous ne pouvez pas créer de règles de branche pour les référentiels liés.

Vous ne pouvez créer que des règles de branche plus restrictives que les autorisations par défaut pour le rôle. Vous ne pouvez pas créer de règles de branche plus permissives que ne le permet le rôle d'un utilisateur dans le projet. Par exemple, vous ne pouvez pas créer de règle de branche qui autorise les utilisateurs dotés du rôle de réviseur à accéder à la branche.

Les règles de branche appliquées à la branche par défaut de votre dépôt source se comporteront légèrement différemment des règles de branche appliquées aux autres branches. Toute règle appliquée à la branche par défaut sera automatiquement appliquée à toute branche que vous spécifiez comme branche par défaut. La branche précédemment définie comme branche par défaut conservera les règles qui lui sont appliquées, sauf qu'elle ne sera plus protégée contre la suppression. Cette protection ne s'applique qu'à la branche par défaut actuelle.

Les règles de branche ont deux états, Standard et Personnalisé. Standard indique que les actions autorisées sur une branche sont celles qui correspondent aux autorisations associées au rôle que l'utilisateur a CodeCatalyst pour les actions de branche. Pour en savoir plus sur les rôles dotés de quelles autorisations, consultezOctroi d'accès avec des rôles d'utilisateur. Personnalisé indique qu'une ou plusieurs actions de branche comportent des actions associées à une liste spécifique de rôles autorisés à effectuer cette action, différente des autorisations par défaut accordées par le rôle d'un utilisateur dans le projet.

Note

Si vous créez une règle de branche pour restreindre une ou plusieurs actions pour une branche, l'action Supprimer la branche est automatiquement définie pour autoriser uniquement les utilisateurs ayant le rôle d'administrateur de projet à supprimer cette branche.

Le tableau suivant répertorie les actions et les paramètres par défaut des rôles autorisés à effectuer ces actions sur une branche.

Actions et rôles des succursales
Action sur les branches	Rôles autorisés à effectuer cette action lorsqu'aucune règle de branche n'est appliquée
Fusionner avec la branche (cela inclut la fusion d'une pull request avec la branche)	Administrateur de projet, contributeur
Appuyez sur la branche	Administrateur de projet, contributeur
Supprimer la branche	Administrateur de projet, contributeur
Supprimer la branche (branche par défaut)	Non autorisée

Vous ne pouvez pas supprimer les règles de branche, mais vous pouvez les mettre à jour pour autoriser les actions de tous les rôles qui seraient autorisés à effectuer cette action sur une branche, ce qui supprime effectivement la règle.

Note

Vous devez avoir le rôle d'administrateur de projet pour configurer les règles de branche pour les référentiels sources dans les CodeCatalyst projets. Cela ne s'applique pas aux référentiels liés. Les référentiels liés ne prennent pas en charge les règles de branche dans CodeCatalyst.

Pour afficher et modifier les règles de branche d'un référentiel

1. Accédez au projet dans lequel se trouve votre référentiel.

2. Choisissez le nom du référentiel dans la liste des référentiels sources du projet. Dans le volet de navigation, vous pouvez également choisir Code, puis Référentiels sources.

   Choisissez le référentiel dans lequel vous souhaitez consulter les règles de branche.

3. Sur la page d'aperçu du référentiel, choisissez Branches.

4. Dans la colonne Règles de branche, consultez l'état des règles pour chaque branche du référentiel. Standard indique que les règles d'action des branches sont les règles par défaut pour toutes les branches créées dans un référentiel source et qu'elles correspondent aux autorisations accordées à ces rôles dans un projet. Personnalisé indique qu'une ou plusieurs actions de branche sont soumises à des règles qui limitent une ou plusieurs actions autorisées pour cette branche à un ensemble de rôles différent.

   Pour consulter les détails des règles de branche d'une branche, choisissez le mot Standard ou Personnalisé à côté de la branche que vous souhaitez consulter.

5. Pour créer ou modifier une règle de branche, choisissez Gérer les paramètres. Sur la page des paramètres du référentiel source, dans Règles de branche, choisissez Modifier.

6. Dans Branche, choisissez le nom de la branche pour laquelle vous souhaitez configurer une règle dans la liste déroulante. Pour chacun des types d'action autorisés, choisissez les rôles que vous souhaitez autoriser à effectuer cette action dans la liste déroulante, puis choisissez Enregistrer.