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

La liaison de vos éléments de travail à des objets de développement tels que des branches, des validations, des demandes de tirage et des builds est un moyen puissant de stimuler le développement et de synchroniser votre équipe. En créant des branches directement à partir d’éléments de travail, vous établissez une connexion claire entre les tâches et les modifications de code. Au fur et à mesure que le développement progresse, vous pouvez associer des demandes de tirage et des validations à ces éléments de travail, en garantissant un enregistrement complet des opérations effectuées pour effectuer un travail spécifique.

Cet article explique comment créer de nouvelles branches, ajouter des liens à des validations et gérer des demandes de tirage dans un référentiel Git hébergé sur Azure DevOps. Pour obtenir des instructions sur la liaison de validations GitHub et de demandes de tirage à des éléments de travail, consultez Lier des validations GitHub et des demandes de tirage à 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 de développement effectue le suivi de toutes les activités de développement Git qui contribuent à l’achèvement d’un élément de travail. Il fournit à votre équipe les informations nécessaires pour effectuer les étapes de développement suivantes, ce qui réduit le besoin de plusieurs actions de navigation pour accomplir des tâches courantes. En outre, elle améliore la traçabilité en affichant toutes les branches, validations, demandes de tirage et builds associées à l’élément de travail, garantissant ainsi une visibilité complète du processus de développement.

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 du contrôle développement , vous pouvez accéder rapidement aux branches, aux demandes de tirage et aux validations liées à l’élément de travail. En outre, vous pouvez lancer une demande de tirage pour une branche que vous avez créée ou liée directement à partir de l’élément de travail.

Remarque

Le contrôle de développement est disponible 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 dans Visual Studio ou d’autres clients pris en charge n’affichent pas plusieurs fonctionnalités disponibles dans le portail web.

Prérequis

  • Accès au projet : être membre du projet
  • Autorisations :
  • Niveaux d’accès : pour réorganiser un backlog ou utiliser l’outil Prévision, disposez au moins d’un accès de base . Les utilisateurs disposant d’un accès aux parties prenantes ne peuvent pas réorganiser les éléments du backlog ou utiliser l’outil Prévision. Pour plus d’informations, consultez Référence rapide sur l’accès de partie prenante.

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.

    Capture d’écran montrant le formulaire d’élément de travail de l’article utilisateur, le menu Action, ajouter une nouvelle branche.

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

    Capture d’écran montrant la 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.

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

  2. 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.

    Capture d’écran montrant Commit et push changes.

    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.

    Créez une demande de tirage (pull request) pour fusionner les modifications que vous avez apportées à une branche principale et obtenir vos modifications examinées par d’autres membres de votre équipe.

    Capture d’écran montrant le 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.

    Capture d’écran montrant la page Pull Request, Create pull request.

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

    Capture d’écran montrant la boîte de dialogue Terminer la demande de tirage, cochez squash-merge.

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

    Capture d’écran montrant la demande pull, la notification terminée.

  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.

Capture d’écran montrant la 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.

Capture d’écran montrant l’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.

Capture d’écran montrant l’icône Ajouter des liens, puis choisissez 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 .

Capture d’écran montrant la 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 affichés dans cette section s’affichent en raison des actions suivantes :

  • 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.

Capture d’écran montrant les types de liens Artifact-to-artifact.

::: moniker-end

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.