Configurez des pipelines pour prendre en charge le suivi du travail

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

Pour prendre en charge l’intégration et la traçabilité entre Azure DevOps Services avec des pipelines, vous pouvez configurer plusieurs options. Vous pouvez signaler des états de pipeline, copier la syntaxe des badges d’état et configurer la liaison automatique des éléments de travail aux builds et aux mises en production.

Fonctionnalités d’intégration de pipeline et de suivi du travail prises en charge

Plusieurs fonctionnalités offrent une prise en charge de la traçabilité de bout en bout à mesure que les récits utilisateur et les fonctionnalités passent par le cycle de développement. Comme avec Azure Repos, vous pouvez lier des éléments de travail à des objets de pipeline avec les types de liens suivants : Build, Intégré dans la build et Intégré dans mise en production. Le lien Intégré dans l’environnement de release ne peut être créé qu’en activant l’option Signaler l’état de la release à Boards dans les pipelines de release classiques.

Le tableau suivant récapitule les points d’intégration entre Azure Boards et Azure Pipelines. Les options et les étapes de configuration varient selon que vous configurez un pipeline YAML ou classique, et selon votre version d’Azure DevOps. La plupart des options sont prises en charge pour les pipelines exécutés sur un référentiel Git Azure Repos, sauf indication contraire.

Fonctionnalité

Description

Versions prises en charge

---

Lier manuellement des éléments de travail à des builds

Vous pouvez lier à partir d’un élément de travail des builds au sein du même projet ou à d’autres projets dans l’organisation. Pour plus d’informations, consultez Lier à des éléments de travail à partir d’autres objets.

Toutes les versions

---

Afficher les builds liées à partir d’un élément de travail

Vous pouvez afficher tous les builds liés à partir d’un élément de travail, qu’ils soient liés manuellement ou automatiquement, depuis l’onglet Liens. Pour plus d’informations, consultez Lier à des éléments de travail à partir d’autres objets, afficher la liste des objets liés.

Toutes les versions

---

Lier automatiquement des éléments de travail à des builds

Obligatoire pour remplir le contrôle Développement avec intégré dans les liens de build . Les éléments de travail ou commits qui font partie d’une mise en production sont calculés à partir des versions des artefacts. Par exemple, chaque build dans Azure Pipelines est associée à un ensemble d’éléments de travail et de validations. Pour plus d’informations, consultez Lier automatiquement des éléments de travail plus tard dans cet article.

YAML, Azure DevOps Server 2020 et versions ultérieures

---

Lier automatiquement des éléments de travail aux mises en production et signaler l’état de déploiement à un élément de travail (classique uniquement)

Obligatoire pour remplir le contrôle de déploiement dans le formulaire d’élément de travail avec des liens Intégrés à l’étape de mise en production . Pour plus d’informations, consultez Signaler l’état du déploiement à Boards plus tard dans cet article.

Azure DevOps Server 2020 et versions ultérieures

---

Afficher la liste des éléments de travail liés à une build ou à une mise en production

Passez en revue et ouvrez les éléments de travail inclus dans une build ou une mise en production.

YAML, Azure DevOps Server 2020 et versions ultérieures

---

Créer un élément de travail en cas d’échec (classique)

Créez automatiquement un élément de travail en cas d’échec d’une build et définissez éventuellement des valeurs pour les champs d’élément de travail. Pour plus d’informations, consultez Créer un élément de travail en cas d’échec plus tard dans cet article.

Versions 2018 et suivantes

---

Tâche de requête des éléments de travail : s’assurer que le nombre d’éléments de travail correspondants renvoyés par une requête est compris dans un seuil.

Utilisez cette tâche pour vous assurer que le nombre d’éléments correspondants retournés par une requête d’élément de travail se trouve dans les seuils configurés. Pour plus d’informations, consultez Tâche de requête des éléments de travail, contrôler les déploiements avec des portes et des approbations.

Azure DevOps Server 2020 et versions ultérieures

---

Prérequis

• Pour configurer les options d’intégration d’un pipeline de mise en production classique, vous devez disposer des autorisations nécessaires pour modifier la mise en production.
• Pour lier des éléments de travail à des validations et des demandes de tirage, vos autorisations Modifier les éléments de travail dans ce nœud doivent être définies sur Autoriser le chemin de zone affecté à l’élément de travail. Par défaut, ce jeu d’autorisations est défini sur le groupe Contributeurs.
• Pour afficher les éléments de travail, vos autorisations Afficher les éléments de travail dans ce nœud doivent être définies sur Autoriser pour le chemin d’accès à la zone affecté à l’élément de travail.

Ouvrir les paramètres de pipeline, les options de génération ou les options d’intégration

YAML

Ouvrir les paramètres du pipeline

Pour les pipelines de mise en production définis par YAML, vous configurez l’intégration via la boîte de dialogue Paramètres du pipeline .

1. Ouvrez le pipeline, choisissez Plus d’actions, puis choisissez Paramètres.

   

   La boîte de dialogue Modifier les paramètres du pipeline s’affiche. Pour plus d’informations sur le lien automatique, consultez Lier automatiquement des éléments de travail plus tard dans cet article.

   

Build classique

Propriétés de la build

Ouvrez le pipeline de build, choisissez de modifier le pipeline, puis choisissez l’onglet Options .

La page Propriétés de la build s’affiche.

Pour plus d’informations sur chaque paramètre, utilisez l’un des liens suivants :

• Format du numéro de build
• Lier automatiquement les éléments de travail
• Créer un élément de travail en cas d’échec
• Badge d’état

Mise en production classique

Options d’intégration de mise en production

Pour Pipelines de mise en production classique, ouvrez Pipelines>Mise en production, choisissez de modifier votre pipeline, puis choisissez Options, puis Intégrations.

Pour plus d’informations sur chaque paramètre, utilisez l’un des liens suivants :

• Signaler l'état du déploiement à l'hôte du référentiel
• Signaler l'état du déploiement au travail
• Signaler l'état du déploiement à Boards
• Signaler l'état du déploiement à Jira
• Activer le badge d'état du déploiement

Lier automatiquement des éléments de travail à des builds ou mises en production

En activant le lien automatique, vous pouvez suivre les builds ou les releases qui ont intégré le travail sans avoir à rechercher manuellement dans un grand ensemble de builds ou de releases. Chaque build réussie associée à l’élément de travail apparaît automatiquement dans le contrôle Développement du formulaire de l’élément de travail. Chaque build réussie associée à l’élément de travail apparaît automatiquement dans la section Développement du formulaire d’élément de travail.

YAML

1. Ouvrez les paramètres du pipeline comme décrit dans Ouvrir les paramètres du pipeline.

2. Activez Lier automatiquement le nouveau travail dans cette build.

   

   Une fois activés, les liens intégrés dans la build sont générés pour tous les éléments de travail liés à la demande de tirage sélectionnée à chaque exécution de mise en production.

Build classique

1. Ouvrez les propriétés de build du pipeline comme décrit dans Propriétés de la build.

2. Activez Lier automatiquement les éléments de travail inclus dans cette exécution. Ajoutez les branches à inclure ou à exclure.
   

   Une fois activée, intégrés dans la build sont générés pour tous les éléments de travail liés aux branches sélectionnées dans chaque exécution.

   Pour afficher une liste d’éléments de travail liés à la build, choisissez le lien associé dans la page Résumé.

   

3. Enregistrer votre pipeline.

Mise en production classique

Avant de choisir des options d’intégration, configurez les étapes de release comme décrit dans Définir votre pipeline de déploiement continu multi-étapes (CD).

1. Ouvrez Intégrations > d’options pour le pipeline de mise en production, comme décrit dans Options d’intégration de mise en production.

2. Cochez la case Signaler l’état du déploiement à Boards. Mappez le type de déploiement à chaque étape, ou laissez Non mappé. Sélectionnez cette option si vous souhaitez créer des liens vers tous les éléments de travail qui représentent les modifications associées à la source, lorsqu’une mise en production est terminée. Cette option doit être activée pour que le contrôle de déploiement du formulaire d'élément de travail fonctionne.

   

   Pour afficher une liste d’éléments de travail liés à la mise en production, choisissez Mise en production (ancienne vue) dans Autres commandes, puis choisissez l’onglet Éléments de travail .

   

3. Enregistrer votre pipeline.

Vérifier l’intégration

Pour vérifier que l’intégration fonctionne, procédez comme suit :

1. Liez un ou plusieurs éléments de travail à une validation ou une demande de tirage dans le référentiel Git Azure Repos référentiel. Pour plus d’informations, consultez l’article suivant :

   • Diriger le développement Git à partir d’un élément de travail
   • Lier des éléments de travail à partir d’autres objets

2. Exécutez le pipeline.

3. Ouvrez l’un des éléments de travail liés et affichez le contrôle Déploiement. Comme illustré dans l’image suivante, le contrôle Déploiement affiche les informations de release pour deux étapes de release, les éléments de travail qui sont liés à un commit Git ou à une pull request pour un pipeline de release configuré pour s’intégrer à Azure Boards.

Quels sont les éléments de travail inclus dans la liaison automatique ?

Lors du développement de votre logiciel, vous pouvez lier des éléments de travail lorsque vous créez une branche, une validation ou une demande de tirage. Vous pouvez également lancer une branche, une validation ou une demande de tirage à partir d’un élément de travail, en liant automatiquement ces objets, comme décrit dans Diriger le développement Git à partir d’un élément de travail. Par exemple, ici, nous créons une branche à partir du récit utilisateur Annuler le formulaire de commande.

Lorsque vous liez automatiquement des éléments de travail aux builds, les calculs suivants sont effectués :

• Pour une première build :

  • Identifiez tous les éléments de travail liés à la branche, aux validations et aux demandes de tirage associés à la build.

• Pour les builds suivantes :

  • Identifiez tous les éléments de travail associés à la validation actuelle (C1) en cours de génération.
  • Identifiez tous les éléments de travail associés à la validation (C2) de la dernière build réussie de la même branche source.
  • Identifiez tous les éléments de travail associés aux validations entre C1 et C2 dans l’arborescence de validation.

Créer un élément de travail en cas d’échec (classique)

Si un pipeline de build échoue, vous pouvez créer automatiquement un élément de travail pour suivre la résolution du problème. Vous pouvez spécifier le type d’élément de travail et définir des options pour l’affecter automatiquement au demandeur ou à d’autres champs. Le demandeur correspond à la personne qui a déclenché la build.

Conseil

L’option Créer un élément de travail en cas d’échec est uniquement prise en charge pour les pipelines classiques. Pour ce faire avec un pipeline YAML, vous pouvez utiliser une extension de lmarketplace telle que Échec de la création d’un bogue lors de la mise en production ou vous pouvez l’implémenter vous-même à l’aide d’Azure CLI ou d’appels d’API REST.

1. Ouvrez les options de génération de pipeline comme décrit dans Propriétés de la build.

2. Activez Créer un élément de travail en cas d’échec et choisissez le type d’élément de travail à créer. Cochez éventuellement la case Affecter au demandeur pour définir le champ Affecter à et ajouter des champs à définir dans l’élément de travail à créer.

   Par exemple, nous choisissons ici le type d’élément de travail Bogue et spécifions les champs Priorité et Balises et leurs valeurs.

   

3. Enregistrer votre pipeline.

Pour connaître le nom de référence d’un champ, recherchez-le à partir de l’index du champ Élément de travail. Pour les champs personnalisés que vous ajoutez via un processus hérité, Azure DevOps attribue un nom de référence basé sur le nom convivial du champ, préfixé par Custom. Par exemple, vous ajoutez un champ nommé DevOps Triage. Le nom de référence est Custom.DevOpsTriage. Aucun espace n’est autorisé dans le nom de référence.

Obtenir ou activer un badge d’état

YAML

1. Ouvrez le pipeline Plus d’actions et choisissez Badge d’état.

   

2. Choisissez la branche et l’étendue qui vous intéressent, puis choisissez Copier dans le Presse-papiers pour copier l’image ou la syntaxe Markdown.

   

Build classique

1. Ouvrez les propriétés de build du pipeline comme décrit dans Propriétés de la build.

2. Choisissez Copier dans le Presse-papiers pour copier l’image ou la syntaxe Markdown.

   

3. Enregistrer votre pipeline.

Mise en production classique

Sélectionnez cette option si vous souhaitez afficher le dernier résultat d’un déploiement d’étape sur un site web externe.

1. Cochez la case Activer le badge d’état de déploiement. Ensuite, sélectionnez les étapes pour lesquelles vous souhaitez afficher le résultat. Par défaut, toutes les étapes définies pour la mise en production sont sélectionnées.

   

2. Choisissez Copier dans le Presse-papiers pour copier l’image ou la syntaxe Markdown.

   

3. Enregistrer votre pipeline.

Signaler l’état du déploiement à l’hôte du référentiel(Classique)

Lorsque votre code est stocké dans un référentiel Git d’Azure Repos, vous pouvez configurer votre pipeline de release pour afficher un badge sur les pages d’Azure Repos. Le badge indique où la validation spécifique a été déployée et si le déploiement passe ou échoue. Cette option améliore la traçabilité de la validation du code pour les déploiements.

L’état du déploiement s’affiche dans les sections suivantes d’Azure Repos :

• Fichiers : indique l’état du dernier déploiement pour la branche sélectionnée.
• Commits : indique l’état du déploiement de chaque validation (cela nécessite l’activation du déclencheur d’intégration continue (CD) pour votre version).
• Branches : indique l’état du dernier déploiement pour chaque branche.

Si un commit est déployé dans plusieurs pipelines de release, avec plusieurs étapes, chacun a une entrée dans le badge avec un statut affiché pour chaque étape. Par défaut, quand vous créez un pipeline de mise en production, l’état du déploiement est publié pour toutes les étapes. Toutefois, vous pouvez choisir de manière sélective les étapes pour lesquelles l’état du déploiement doit être affiché dans le badge d’état (par exemple, n’afficher que les étapes de production). Les membres de votre équipe peuvent sélectionner le badge d’état pour afficher l’état de déploiement le plus récent pour chacune des étapes sélectionnées des pipelines de mise en production.

Signaler l’état du déploiement à Jira (Classique)

Incluez les problèmes Jira dans les éléments de travail et créez des liens vers tous les problèmes lors de la saisie semi-automatique. Installez l’application Azure Pipelines pour Jira dans Jira Software Cloud et ajoutez une organisation pour créer une connexion.

Pour prendre en charge l’intégration avec le suivi des problèmes Jira, installez Azure DevOps pour Jira et connectez vos organisations Azure DevOps à votre instance Jira Software. Vous pouvez connecter plusieurs organisations à une seule instance et obtenir des données pour toutes vos équipes et projets associés. Pour plus d’informations, consultez Connecter Azure DevOps à Jira.

Articles connexes

• Définir un pipeline de déploiement continu multi-étapes (CD)
• Lier des éléments de travail à d’autres objets
• Consulter la vue d’ensemble des pipelines de release (Classique)
• Récupérer tous les éléments de travail associés à un pipeline de release en utilisant l’API Azure DevOps
• Piloter le développement Git à partir d’un élément de travail
• Lier des éléments de travail à d’autres objets
• Assurer la traçabilité de bout en bout
• Consulter la référence des types de lien