Partager via


Piloter le développement Git à partir d’un élément de travail dans Azure Boards

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

L’une des façons dont votre équipe peut piloter son développement et rester synchronisée est de lier vos éléments de travail aux objets créés pendant le développement, comme les branches, les validations, les demandes de tirage et les builds. Vous pouvez commencer cette liaison en créant une branche à partir d’un ou plusieurs éléments de travail. Plus tard, vous pouvez créer des demandes de tirage, ouvrir rapidement des validations et conserver un enregistrement des opérations de développement effectuées pour effectuer un travail spécifique.

Cet article vous montre comment effectuer les tâches suivantes :

  • Comment créer une branche ou une demande de tirage à partir d’un élément de travail
  • Terminer une demande de tirage
  • Effectuer une fusion squash
  • Créer une branche pour plusieurs éléments de travail
  • Lier un élément de travail à des objets de développement et de build existants

Cet article traite de la création de nouvelles branches, de l’ajout de liens vers des validations et de l’ajout de demandes de tirage à un dépôt Git hébergé sur Azure DevOps. Pour créer un lien vers des validations et des demandes de tirage GitHub, consultez Lier des validations et des demandes de tirage GitHub à des éléments de travail.

Conseil

Vous pouvez configurer la liaison automatique et d’autres paramètres qui lient des éléments de travail à des validations Git, des demandes de tirage, des builds, etc. Pour plus d’informations, consultez les ressources suivantes :

Contrôle de développement

Le contrôle Développement enregistre tous les processus de développement Git qui prennent en charge l’achèvement de l’élément de travail. Ce contrôle peut afficher les informations de votre équipe nécessaires pour passer à l’étape de développement suivante et réduire les étapes de navigation pour accomplir les tâches de développement courantes. Il prend également en charge la traçabilité, offrant une visibilité sur toutes les branches, les validations, les demandes de tirage et les builds liées à l’élément de travail.

Capture d’écran du formulaire d’élément de travail, contrôle de développement.

Capture d’écran du formulaire d’élément de travail, contrôle de développement, Azure DevOps Server 2019.

À partir de là, vous pouvez accéder rapidement aux branches, aux demandes de tirage et aux commits qui sont liés à l’élément de travail. Par ailleurs, vous pouvez démarrer une demande de tirage pour une branche que vous avez créée ou liée à partir de l’élément de travail.

N’oubliez pas que le contrôle Développement apparaît uniquement dans le formulaire d’élément de travail du portail web. L’expérience de suivi des éléments de travail et les formulaires qui s’affichent dans Visual Studio ou dans d’autres clients pris en charge n’affichent pas plusieurs des fonctionnalités disponibles à partir du portail web.

Prérequis

  • Connectez-vous à un projet. Si vous n’avez pas encore de projet, créez-en un.
  • Vous devez être ajouté à un projet en tant que membre du groupe de sécurité Contributeurs ou Administrateurs de projet. Pour être ajouté, ajoutez des utilisateurs à un projet ou à une équipe.
  • Pour afficher ou modifier des éléments de travail, vous devez régler vos autorisations Afficher les éléments de travail dans ce nœud. et Modifier les éléments de travail dans ce nœud sur Autoriser. Cette autorisation est définie par défaut pour le groupe Contributeurs. Pour plus d'informations, consultez Définir les autorisations et l'accès pour le suivi du travail.
  • Connectez-vous à un projet. Si vous n’avez pas encore de projet, créez-en un.
  • Vous devez être ajouté à un projet en tant que membre du groupe de sécurité Contributeurs ou Administrateurs de projet. Pour être ajouté, ajoutez des utilisateurs à un projet ou à une équipe.
  • Pour afficher ou modifier des éléments de travail, vous devez régler vos autorisations Afficher les éléments de travail dans ce nœud. et Modifier les éléments de travail dans ce nœud sur Autoriser. Cette autorisation est définie par défaut pour le groupe Contributeurs. Pour plus d'informations, consultez Définir les autorisations et l'accès pour le suivi du travail.

Processus de workflow

Envisagez de créer une branche lorsqu’il n’existe aucun artefact de code lié. S’il existe une branche, mais aucune demande de tirage, envisagez de créer une demande de tirage. Voici une séquence de workflow classique lors de l’utilisation d’un dépôt Git.

  1. Commencez à travailler sur l’élément de travail en créant une branche. Vous pouvez ajouter une nouvelle branche Git à partir de la section Développement...

    Capture d’écran du contrôle de développement, lien Créer une branche.

    ... ou à partir du menu Actions du formulaire.

    Formulaire d’élément de travail de récit utilisateur, menu Action, ajouter une nouvelle branche.

    Nommez la branche et sélectionnez le dépôt.

    Boîte de dialogue Créer une branche

    Quand vous créez des branches, elles sont automatiquement liées à l’élément de travail.

    Remarque

    Vous ne pouvez créer une branche qu’une fois que vous avez ajouté des fichiers à la branche primaire, que nous vous recommandons d’étiqueter main ou autre étiquette distinctive. Le système ajoute automatiquement un fichier README au dépôt initial créé avec chaque nouveau projet.

  2. Le système s’ouvre sur le dépôt et la branche que vous avez créée.

    Vous pouvez modifier un fichier dans le portail web.

    Ou, si vous avez beaucoup de modifications de fichiers ou que vous devez ajouter des fichiers, utilisez Visual Studio ou un autre IDE pris en charge. Ajoutez une nouvelle branche locale à partir de la branche que vous avez créée. Pour plus d’informations, consultez Mettre à jour le code avec la récupération et le tirage, Télécharger les changements avec la récupération. (Même si n’importe quel processus d’édition et de commit du code fonctionne, nous travaillons mieux avec une édition de Visual Studio.)

  3. Ajoutez ou modifiez des fichiers dans la branche que vous avez créée.

    À partir de Visual Studio ou d’un autre IDE pris en charge, validez et envoyez les modifications de votre branche locale vers le dépôt.

    Valider et envoyer (push) les changements

    Si c’est la première fois que vous poussez des changements à partir d’une nouvelle branche, commencez par publiez la branche. Pour plus d’informations, consultez Partager du code avec Push.

  4. Créez une demande de tirage à partir du formulaire d’élément de travail.

    Vous créez une demande de tirage pour fusionner les modifications que vous avez apportées à une branche primaire et faire examiner vos modifications par d’autres membres de votre équipe.

    Capture d’écran du contrôle de développement, créer un lien de demande de tirage.

  5. Votre vue bascule vers la page Code, Demandes de tirage. Terminez la création de la demande de tirage comme indiqué.

    Affichage de code, page Demande de tirage.

    Notes

    Une fois que vous avez créé une demande de tirage, vous ne pouvez pas créer une nouvelle demande de tirage pour la même branche tant que vous n’avez pas terminé la demande de tirage précédente.

    Page Demande de tirage, Créer une demande de tirage.

    Cochez la case pour Effectuer un squash des changements en cas de fusion, puis terminez la fusion.

    Boîte de dialogue Terminer la demande de tirage, cochez Effectuer un squash lors de la fusion

  6. Une fois l’opération terminée, vous devriez voir un écran similaire à celui qui suit.

    Demande de tirage, notification d’achèvement

  7. Ouvrez le formulaire d’élément de travail ou actualisez le formulaire, développez la section Développement (choisissez Agrandir le développement ), et vous voyez les liens qui ont été ajoutés pour prendre en charge les opérations que vous avez effectuées.

    Capture d’écran de la section Work item form (Formulaire d’élément de travail), Development (Développement), liens ajoutés.

Créer une branche pour plusieurs éléments de travail

Vous pouvez également ajouter une nouvelle branche à partir de l’élément de travail répertorié dans le backlog ou la carte sans avoir à ouvrir l’élément de travail. À l’aide de la sélection multiple, vous pouvez sélectionner plusieurs éléments de travail et créer une branche où ils sont tous liés à la branche.

Par exemple, ici, nous sélectionnons les cinq premiers éléments à lier à une nouvelle branche.

Capture d’écran de la sélection de plusieurs éléments dans le backlog, lien Créer une branche.

Nous spécifions aussi le nom de la branche.

Boîte de dialogue Créer une branche

Tous les éléments répertoriés sous la section Développement apparaissent également sous l’onglet Liens. Toutes les actions de développement démarrées à partir de la section Développement sont également enregistrées sous l’onglet Historique.

Onglet Liens, liens de développement

Pour lier un élément de travail à un objet existant, choisissez l’icône Ajouter des liens, puis choisissez le type de lien.

Sélectionnez l’icône Ajouter des liens, puis le type de lien.

Si vous souhaitez supprimer un lien, vous pouvez le faire à partir de la section Développement en le mettant en surbrillance en premier, puis choisissez Supprimer le lien .

Section Développement, supprimer un lien

Vous pouvez également le sélectionner sous l’onglet Liens et choisir Actions pour le lien, puis choisir l’option Supprimer le lien.

Éléments de travail associés dans la build

Avec les commits Git, tous les éléments de travail qui ont été liés à un commit sont listés sous Éléments de travail associés dans la page récapitulative de la génération.

Éléments de travail liés répertoriés sous Éléments de travail associés dans la page récapitulative de build.

Les liens indiqués dans cette section s’affichent en raison de ces actions :

  • Création d’une branche, d’une validation ou d’une demande de tirage à partir de l’élément de travail
  • Spécification de l’ID d’élément de travail lors d’une validation, d’une demande de tirage ou d’une autre opération Git ou TFVC prise en charge
  • Liaison spécifique de l’élément de travail à partir de la section Développement ou de l’onglet Liens vers une branche de code source, une build ou une autre opération Git ou TFVC prise en charge.

Le pointage sur n’importe quelle entrée répertoriée sous la section Développement active le lien hypertexte vers l’objet associé.

Les types de liens que vous pouvez ajouter dans la section développement sont Branche, Build, Ensemble de modifications, validation, Trouvé dans la build, Intégré dans la build, Demande de tirage et Élément avec version.

Types de lien artefact à artefact

Pour plus d’informations sur le contrôle de liens ou pour personnaliser le contrôle de liens de développement, consultez les éléments LinksControlOptions, contrôle des liens de développement.