Déployer des artefacts de demande de tirage avec des pipelines de mise en production classiques

  • Article

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

Les demandes de tirage fournissent un moyen efficace d’examiner les révisions du code avant qu’il ne soit fusionné dans le codebase. Toutefois, ces modifications peuvent introduire des problèmes qui peuvent être difficiles à trouver sans générer et déployer votre application dans un environnement spécifique. Les déclencheurs de demande de tirage vous permettent de configurer un ensemble de critères qui doivent être remplis avant de déployer votre code. Dans cet article, vous allez apprendre à configurer des déclencheurs de demande de tirage avec Azure Repos et GitHub pour déployer votre artefact de build.

Prérequis

Déploiement de demande de tirage (pull request)

Avec les déclencheurs de demande de tirage, chaque fois que vous déclenchez une nouvelle demande de tirage pour la branche désignée, une mise en production est déclenchée automatiquement pour démarrer le déploiement dans les environnements désignés. L’état de déploiement s’affiche ensuite sur la page de demande de tirage. Les déclencheurs de demande de tirage peuvent vous aider à maintenir une meilleure qualité du code, à publier avec plus de confiance et à détecter les problèmes dès le début du cycle de développement.

La configuration des déploiements de demande de tirage est un processus en deux étapes. Nous devons d’abord configurer un déclencheur de demande de tirage, puis configurer des stratégies de branche (Azure Repos) ou vérifications d'état (GitHub) pour nos pipelines de mise en production.

Créer un déclencheur de demande de tirage (pull request)

Un déclencheur de demande de tirage crée une mise en production chaque fois qu’un artefact de build est disponible.

  1. Accédez à votre projet Azure DevOps, sélectionnez Pipelines>Mises en production, puis sélectionnez votre pipeline de mise en production.

  2. Sélectionnez l’icône déclencheur de déploiement continu dans la section Artefacts .

    Capture d’écran montrant comment accéder aux paramètres du déclencheur de déploiement continu.

  3. Sélectionnez le bouton bascule pour activer le déclencheur de demande de tirage.

    Capture d’écran montrant comment activer les déclencheurs de demande de tirage.

  4. Sélectionnez votre branche cible dans le menu déroulant.

    Capture d’écran montrant comment sélectionner la branche Azure.

  5. Pour déployer votre application à une étape spécifique, vous devez explicitement opter pour cette étape. La section Étapes montre les étapes qui sont activées pour les déploiements de demande de tirage.

    Capture d’écran montrant la liste des étapes qui sont activées pour les déploiements de demandes de tirage.

    Pour choisir une étape de déploiement de demande de tirage, sélectionnez l’icône Conditions de prédéploiement pour votre étape spécifique, puis sélectionnez Déclencheurs>après la mise en production. Enfin, sélectionnez le bouton bascule déploiement de demande de tirage pour l’activer.

    Capture d’écran montrant comment activer le déploiement de demande de tirage pour une étape spécifique.

Important

L’activation des déploiements de demandes de tirage automatique pour les phases de production n’est pas recommandée.

Configurer des stratégies de branche pour Azure Repos

Vous pouvez utiliser des stratégies de branche pour implémenter une liste de critères qui doivent être remplis pour qu’une demande de tirage soit fusionnée.

  1. Accédez à votre projet, puis sélectionnez Repos>Branches pour accéder à la liste des branches de votre référentiel.

    Capture d’écran montrant comment accéder aux branches dans Azure Repos.

  2. Sélectionnez le menu contextuel de votre branche appropriée, ...puis sélectionnez Stratégies de branche.

    Capture d’écran montrant comment accéder aux stratégies de branche pour une branche spécifique.

  3. Sélectionnez Ajouter une stratégie d’état, puis sélectionnez un état à vérifier dans le menu déroulant. Sélectionnez l’état correspondant à votre définition de mise en production, puis sélectionnez Enregistrer.

    Capture d’écran montrant comment ajouter une stratégie d’état.

    Notes

    La définition de mise en production doit avoir été exécutée au moins une fois avec le déclencheur de demande de tirage activé pour obtenir la liste des états. Pour plus d’informations, consultez Configurer une stratégie de branche pour un service externe .

  4. Avec l’ajout de la nouvelle stratégie d’état, les utilisateurs ne pourront pas fusionner les modifications apportées à la branche cible sans qu’un état « réussi » soit publié dans la demande de tirage.

    Capture d’écran montrant une liste de stratégies d’état et la stratégie de déploiement de demande de tirage activée.

  5. Vous pouvez afficher les états de vos stratégies à partir de la page Vue d’ensemble de la demande de tirage. En fonction de vos paramètres de stratégie, vous pouvez afficher les états de publication sous les sections Obligatoire, Facultatif ou État. L’état de la version est mis à jour à chaque fois que le pipeline est déclenché.

    Capture d’écran montrant l’état des stratégies de demande de tirage.

Configurer les vérifications d'état pour les dépôts GitHub

L’activation de vérifications d'état pour un référentiel GitHub permet à un administrateur de choisir les critères à remplir avant qu’une demande de tirage soit fusionnée dans la branche cible.

Notes

Les vérifications d'état ne sont publiées sur votre demande de tirage qu’une fois que votre pipeline de mise en production a été exécuté au moins une fois avec la condition de déploiement de la demande de tirage activée. Pour plus d’informations, consultez Règles de protection de branche .

Capture d’écran montrant comment activer des vérifications d’état.

Vous pouvez afficher vos vérifications d'état dans votre demande de tirage sous l’onglet Conversation.

Capture d’écran montrant les vérifications d’état de demande de tirage.