Configurez des pipelines pour prendre en charge le suivi du travail

  • Article

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. Notez que le lien Intégré dans l’environnement de mise en production ne peut être créé qu’en activant l’option Signaler l’état de mise en production dans les pipelines de mise en production classiques.

Image conceptuelle des types de liens qui lient des éléments de travail à des objets Azure Pipelines.

Le tableau suivant récapitule les points d’intégration entre Azure Boards et Azure Pipelines. Les options et les étapes de configuration diffèrent selon que vous configurez un pipeline YAML ou Classic et 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 toutes les builds liées à partir d’un élément de travail, qu’elles soient manuelles ou automatiquement liées, à partir de 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 loin dans cet article.

YAML, Azure DevOps Server 2020 et versions ultérieures
Classic, TFS 2017.2 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 de déploiement aux Boards plus loin 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
Classic, TFS 2017.2 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 loin dans cet article.

TFS 2018 et versions ultérieures

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

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.

    Ouvrir les paramètres du pipeline.

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

    Boîte de dialogue Paramètres du pipeline YAML.

Ce paramètre n’est pas disponible pour Azure DevOps Server versions 2019 ou antérieures.

En activant la liaison automatique, vous pouvez suivre les builds ou mises en production qui ont incorporé du travail sans avoir à rechercher manuellement dans un grand ensemble de builds ou de mises en production. 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. 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.

En activant la liaison automatique, vous pouvez suivre les builds qui ont incorporé du travail sans avoir à rechercher manuellement dans un grand ensemble de builds. 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.

  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.

    Capture d’écran de la boîte de dialogue Paramètres du pipeline, lier automatiquement des éléments de 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.

Cette fonctionnalité n’est pas prise en charge pour les pipelines YAML dans Azure DevOps Server 2019.

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.

Boîte de dialogue Créer une branche à partir d’un formulaire d’élément de travail.

Lors de la liaison automatique d’éléments de travail à des 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.

    Capture d’écran de Créer un élément de travail en cas d’échec dans les options de build.

  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 par le biais d’un processus hérité, Azure DevOps attribue un nom de référence basé sur le nom de champ convivial préfixé par Custom. Par exemple, vous ajoutez un champ nommé DevOps Triage, dont 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

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

    Capture d’écran des options du menu Plus d’actions du pipeline YAML.

  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.

    Capture d’écran du badge d’état du pipeline YAML.

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

Lorsque vous codez dans un référentiel Git Azure Repos, vous pouvez configurer votre pipeline de mise en production pour afficher un badge sur les pages 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.

Capture d’écran des options d’intégration pour les pipelines classiques, rapportant l’état de déploiement à l’hébergeur du dépôt.

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 une validation est déployée sur plusieurs pipelines de mise en production, avec plusieurs étapes, chacune a une entrée dans le badge avec l’état 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 le cloud JIRA Software et ajoutez l’organisation pour créer une connexion.

Capture d’écran des options d’intégration pour les pipelines classiques, rapportant l’état de déploiement à Jira.

Pour prendre en charge l’intégration au suivi des problèmes Jira, installez l’intégration d’Azure Pipelines à 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. Consultez notre documentation pour en savoir plus sur la configuration de l’intégration. Pour en savoir plus sur l’installation et la configuration, consultez Intégrer avec le suivi des problèmes Jira.