Configurer une stratégie de branche pour un service externe

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Conseil / Astuce

Vous pouvez utiliser l’IA pour faciliter les tâches Azure DevOps. Consultez Activer l'assistance IA avec Azure DevOps MCP Server pour commencer.

Les stratégies de branche sont une fonctionnalité puissante pour garantir la qualité optimale du code dans votre dépôt en établissant des exigences pour tous les pull requests. Les services externes peuvent utiliser l’API d’état de la demande de tirage pour publier un état détaillé sur vos demandes de tirage. La stratégie de branche pour les services externes permet aux services tiers de participer au flux de travail de demande de tirage et d’établir des exigences de stratégie. Cet article vous guide tout au long du processus de configuration d’une stratégie de branche pour un service qui publie l’état de la demande de tirage. Pour en savoir plus sur l’état des demandes de tirage, consultez Personnaliser et étendre les flux de travail de demande de tirage avec l’état des demandes de tirage.

Prerequisites

Catégorie	Spécifications
Accès au projet	Membre d’un projet.
Permissions	- Afficher le code dans des projets privés : accès au moins Basique. - Clonez ou contribuez au code dans des projets privés : membre du groupe de sécurité Contributeurs ou autorisations correspondantes dans le projet. - Définir des autorisations de branche ou de référentiel : Gérer les autorisations pour la branche ou le référentiel. - Définissez des stratégies de branche, des contrôles d’état ou modifiez la branche par défaut : autorisation Modifier les stratégies pour le référentiel ou la branche, ou appartenance au groupe de sécurité Administrateurs du projet. - Importez un référentiel : membre du groupe de sécurité Administrateurs de projet ou de l’autorisation Créer un référentiel au niveau du projet Git réglée sur Autoriser. Pour plus d’informations, consultez Définir des autorisations de dépôt Git.
Services	Dépôts activés.
Outils	Optional. Utilisez az repos : Azure DevOps CLI.

Configurer la stratégie de branche

1. Accédez aux branches de code> et recherchez la branche sur laquelle vous souhaitez configurer la stratégie (généralement main ou develop). Dans le menu contextuel, sélectionnez l’option Stratégies de branche .

   

2. Faites défiler vers le bas pour rechercher les vérifications d’état. Sélectionnez le + bouton.

   

3. Sélectionnez le service pour lequel vous souhaitez créer une stratégie dans la liste. Si l’état a été publié précédemment, vous pouvez le sélectionner dans la liste ; s’il s’agit d’une nouvelle stratégie, vous pouvez taper le nom de la stratégie.

   

   • L’exigence de stratégie détermine si cette stratégie est facultative ou requise pour effectuer des pull requests dans la branche.
   • L’identité autorisée est utilisée pour garantir que seul l’état de l’identité spécifiée soit pris en compte dans la réalisation de la politique.
   • Les conditions de réinitialisation sont utilisées pour déterminer quand un état publié n’est plus valide. Si l’état publié est spécifique au code le plus récent (par exemple, une build), vérifiez l’état de réinitialisation chaque fois qu’il existe de nouvelles modifications pour réinitialiser l’état lorsque la branche source change.
   • Si vous le souhaitez, définissez un filtre Path. En savoir plus sur les filtres de chemin dans les stratégies de branche.
   • L’applicabilité de la stratégie détermine si cette stratégie s’applique dès qu’une demande de tirage est créée ou si la stratégie s’applique uniquement une fois que le premier état est publié dans la demande de tirage.
   • Le nom d’affichage par défaut vous permet de spécifier un nom d’affichage facultatif pour votre stratégie.

Créer une nouvelle pull request

1. Créez une pull request dans la branche où la politique est définie. Pour plus d’informations, consultez Créer une pull request.

2. Après avoir créé la demande de tirage, la nouvelle stratégie apparaît dans la section Stratégies de la vue détails de la demande de tirage. Initialement, la politique apparaîtra comme non définie tant que le service externe n’a pas affiché le statut.

   

   Lorsque le service a affiché le statut, la politique est mise à jour en conséquence. La saisie semi-automatique sera bloquée jusqu’à ce que la stratégie approuve la demande de tirage.

   

   Lorsque les critères de stratégie sont remplis et que le service affiche un état succeeded, la demande de tirage sera approuvée et l’achèvement sera débloqué.

   

Résumé

Dans cet article, vous avez appris à configurer une stratégie de branche pour un service externe.