Lier des validations GitHub, des demandes de tirage et des problèmes à des éléments de travail

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019

Lorsque vous utilisez GitHub avec Azure Boards, il est facile de garder tout le travail connecté. Les liens peuvent être ajoutés à l’aide de la syntaxe #mention familière aux utilisateurs GitHub ou à partir de l’élément de travail Azure Boards.

Notes

Azure Boards et Azure DevOps Services prennent en charge l’intégration avec les référentiels GitHub.com et GitHub Enterprise Server.

Les serveurs Azure DevOps locaux prennent en charge l’intégration avec les référentiels GitHub Enterprise Server.

Prérequis

  • Votre projet de Azure Boards doit être connecté au référentiel GitHub dans lequel les validations et les requêtes de tirage que vous souhaitez lier existent. Pour plus d’informations, consultez Connect Azure boards to GitHub.
  • Vous devez être un contributeur pour Azure Boards.
  • Vous devez être contributeur au référentiel GitHub.
  • Si votre organisation utilise le modèle de processus XML hébergé pour personnaliser l’expérience de suivi du travail, vous devez mettre à jour les types d’éléments de travail à lier et afficher les types de liens GitHub à partir de la section développement dans le formulaire d’élément de travail. Pour plus d’informations, consultez mettre à jour les définitions XML pour les types d’éléments de travail sélectionnés.

À partir d’une validation GitHub, d’une requête de tirage ou d’un problème, utilisez la syntaxe suivante pour créer un lien vers votre élément de travail Azure Boards. Entrez la AB#ID dans le texte d’un message de validation. Ou, pour une requête de tirage ou un problème, entrez le AB#ID dans le titre ou la description (et non un commentaire).

À partir d’une requête GitHub Commit ou pull, utilisez la syntaxe suivante pour créer un lien vers votre élément de travail Azure Boards. Entrez la AB#ID dans le texte d’un message de validation ou d’une demande de tirage (pull request), entrez le AB#ID dans le titre ou la description de la demande de tirage (et non un commentaire de requête de tirage).

AB#{ID}

Par exemple, AB#125 est lié à l’ID d’élément de travail 125.

En outre, vous pouvez entrer un message de validation ou de requête de tirage pour effectuer la transition de l’élément de travail. Le système le reconnaît fix, fixes, fixed et l’applique à l’élément #-specifier qui suit. Certains exemples sont fournis comme indiqué.

Exemples :

Message de validation Action
Fixed AB#123 Lie et effectue la transition de l’élément de travail à l’état « terminé ».
Adds a new feature, fixes AB#123. Lie et effectue la transition de l’élément de travail à l’état « terminé ».
Fixes AB#123, AB#124, and AB#126 Liens vers Azure Boards les éléments de travail 123, 124 et 126. Passe uniquement le premier élément, 123 à l’état « terminé ».
Fixes AB#123, Fixes AB#124, Fixes AB#125 Liens vers Azure Boards les éléments de travail 123, 124 et 126. Fait passer tous les éléments à l’état « terminé ».
Fixing multiple bugs: issue #123 and user story AB#234 Liens vers GitHub issue 123 et Azure Boards élément de travail 234. Aucune transition.

Notes

Si vous avez connecté le même GitHub référentiel aux projets définis dans au moins deux organisations DevOps Azure, vous pouvez voir un lien AB # mentionner inattendu. Pour plus d’informations, consultez résoudre les problèmes d’intégration de GitHub & Azure Boards. Pour cette raison, nous vous recommandons de connecter un référentiel GitHub uniquement aux projets définis dans une seule organisation Azure DevOps.

Notes

La liaison à un problème GitHub nécessite Azure DevOps Server 2019 Update 1 ou une version ultérieure.

  1. Pour créer un lien vers une requête de validation ou de tirage, ouvrez l’élément de travail et choisissez Ajouter un lien sous la section développement.

    Section développement, ajouter un lien

    Pour établir un lien vers un problème, choisissez l’onglet liens , puis choisissez ajouter un lien>élément existant.

    Onglet liens, ajouter un lien au problème

  2. Dans la boîte de dialogue Ajouter un lien, sélectionnez l’un des types de liens GitHub , entrez l’URL de la validation, de la requête de tirage ou du problème, puis choisissez OK.

    Ici, nous ajoutons un lien vers une requête de tirage GitHub.

    GitHub boîte de dialogue lien de requête de tirage

    Azure Boards effectue une vérification pour vous assurer que vous avez entré un lien valide. Le dépôt GitHub lié à Linked doit être intégré au projet ou la validation échouera.

    Ici, nous ajoutons un lien vers un problème GitHub.

    Boîte de dialogue Ajouter un lien, problème GitHub

La section développement dans le formulaire d’élément de travail répertorie les liens créés pour GitHub les validations et les requêtes de tirage avec l' icône github.

La section développement affiche des liens GitHub

Choisissez le lien fourni pour ouvrir la requête de validation ou de tirage (pull request) dans GitHub.

Afficher les objets GitHub sur le tableau kanban

Avec les annotations GitHub activées dans le tableau kanban, vous pouvez ouvrir rapidement des validations GitHub liées, des demandes de tirage ou des problèmes pour obtenir plus de détails.

Le tableau kanban affiche des liens GitHub

Notes

Les annotations GitHub nécessitent Azure DevOps Server 2019 Update 1 ou une version ultérieure.

Pour plus d’informations sur l’activation des annotations, consultez personnaliser les cartes.

Essayez ce qui suit