Partager via

Utiliser des portes et des approbations pour contrôler votre déploiement

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

En utilisant une combinaison d’approbations de déploiement manuel, de portes et d’intervention manuelle dans votre pipeline de mise en production, vous pouvez rapidement et facilement configurer votre déploiement pour répondre à toutes les exigences spécifiques en matière de prédéploiement pour votre flux de travail.

Dans ce tutoriel, vous allez découvrir les alertes suivantes :

  • Portes de prédéploiement
  • Intervention manuelle
  • Validation manuelle
  • Journaux de déploiement

Prerequisites

Configurer des portes

Vous pouvez utiliser des portes pour vous assurer que le pipeline de mise en production répond à des critères spécifiques avant le déploiement sans nécessiter d’intervention de l’utilisateur.

  1. Sélectionnez Versions de pipelines>, puis sélectionnez votre pipeline de mise en production. Sélectionnez Modifier pour ouvrir l’éditeur de pipeline.

    Capture d’écran montrant le bouton Modifier pour les pipelines de mise en production.

  2. Sélectionnez l’icône de prédéploiement de votre étape, puis sélectionnez le bouton bascule pour activer Gates.

    Capture d’écran montrant comment activer les portes.

  3. Spécifiez le délai avant l’évaluation des portes ajoutées. Cette fois-ci consiste à autoriser les fonctions de porte à initialiser et à se stabiliser avant de retourner les résultats.

    Capture d’écran montrant comment définir le délai pour les portes de prédéploiement.

  4. Sélectionnez Ajouter, puis sélectionnez Éléments de travail de requête.

    Capture d’écran montrant comment ajouter une tâche d’éléments de travail de requête.

  5. Sélectionnez une requête d’élément de travail existante dans le menu déroulant. Selon le nombre d’éléments de travail que vous attendez à retourner, définissez vos seuils maximum et minimum.

    Capture d’écran montrant comment configurer la tâche Éléments de travail de requête.

  6. Sélectionnez la section Options d’évaluation , puis spécifiez le délai d’expiration et l’intervalle d’échantillonnage. Les valeurs minimales que vous pouvez spécifier sont le délai d’expiration de 6 minutes et l’intervalle d’échantillonnage de 5 minutes.

    Capture d’écran montrant comment configurer les options d’évaluation pour la tâche d’éléments de travail de requête.

  7. Lorsque vous avez terminé, sélectionnez Enregistrer.

    Capture d’écran montrant comment enregistrer un pipeline de mise en production.

Configurer une intervention manuelle

En fonction du scénario, vous devrez parfois ajouter une intervention manuelle à votre pipeline de mise en production. Pour ce faire, ajoutez la tâche d’intervention manuelle à votre pipeline.

  1. Sélectionnez Lesversions>. Sélectionnez votre pipeline de mise en production, puis sélectionnez Tâches et choisissez votre étape.

    Capture d’écran montrant comment accéder aux tâches intermédiaires dans un pipeline de mise en production.

  2. Sélectionnez les points de suspension (...), puis sélectionnez Ajouter un travail sans agent.

    Capture d’écran montrant comment ajouter un travail sans agent.

  3. Faites glisser et déposez le travail sans agent en haut de votre processus de déploiement. Sélectionnez le signe (+), puis sélectionnez Ajouter la tâche d’intervention manuelle.

    Capture d’écran montrant comment ajouter la tâche d’intervention manuelle.

  4. Entrez un nom d’affichage et les instructions qui seront affichées lorsque la tâche est déclenchée. Vous pouvez également spécifier une liste d’utilisateurs à avertir et une action de délai d’expiration (rejeter ou reprendre) si aucune intervention n’a eu lieu au cours de la période d’expiration.

    Capture d’écran montrant comment configurer la tâche d’intervention manuelle.

  5. Lorsque vous avez terminé, sélectionnez Enregistrer.

Note

La tâche d’intervention manuelle ne peut être utilisée que dans un travail sans agent.

Configurer la validation manuelle

Vous pouvez utiliser la tâche de validation manuelle dans votre pipeline YAML pour suspendre et attendre l’approbation manuelle. La validation manuelle est particulièrement utile dans les cas où vous souhaitez valider des paramètres de configuration ou des packages de build avant de commencer un travail gourmand en calculs.

Le waitForValidation travail interrompt l’exécution et déclenche une invite d’interface utilisateur pour passer en revue et valider la tâche. Les adresses e-mail répertoriées dans notifyUsers la réception d’une notification pour approuver ou refuser l’exécution du pipeline.

Capture d’écran montrant l’invite de validation manuelle. 

pool: 
   vmImage: ubuntu-latest

jobs:
- job: waitForValidation
  displayName: Wait for external validation  
  pool: server    
  timeoutInMinutes: 4320 # job times out in 3 days
  steps:   
   - task: ManualValidation@0
     timeoutInMinutes: 1440 # task times out in 1 day
     inputs:
         notifyUsers: |
            someone@example.com
         instructions: 'Please validate the build configuration and resume'
         onTimeout: 'resume'

Afficher les journaux de déploiement

Les journaux de déploiement sont utiles pour déboguer les problèmes de déploiement, mais vous pouvez également les utiliser pour auditer les exécutions de votre pipeline et vérifier les approbations et comment elles ont été accordées et par qui.

  1. Sélectionnez Versions de pipelines>, puis sélectionnez votre pipeline de mise en production.

    Capture d’écran montrant une liste de définitions de mise en production.

  2. Cette vue affiche un état en direct de chaque étape de votre pipeline. La phase AQ de cet exemple est en attente d’intervention. Sélectionnez Reprendre.

    Capture d’écran montrant l’étape AQ en attente d’intervention.

  3. Entrez votre commentaire, puis sélectionnez Reprendre.

    Capture d’écran montrant comment répondre à une demande d’intervention manuelle en attente.

  4. Le déploiement de l’étape AQ a réussi et les approbations de prédéploiement sont déclenchées pour la phase de production .

    Capture d’écran montrant l’approbation de prédéploiement déclenchée pour la phase suivante.

  5. Sélectionnez Approuver, entrez votre commentaire, puis approuvez pour continuer le déploiement.

    Capture d’écran montrant comment répondre à une demande d’approbation en attente.

  6. L’état en direct indique que les portes sont traitées pour la phase de production avant la poursuite de la mise en production.

    Capture d’écran montrant les portes de traitement de production.

  7. Revenez à votre pipeline de mise en production, pointez sur votre étape, puis sélectionnez Journaux pour afficher les journaux de déploiement.

    Capture d’écran montrant comment accéder aux journaux de déploiement.

  • Last updated on