Partage via


Lier des commits, des demandes de tirage, des branches et des problèmes GitHub à des éléments de travail dans Azure Boards

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

Dans cet article, découvrez comment lier des éléments de travail à des commits GitHub, des pull requests et des branches après avoir connecté votre projet Azure Boards à un référentiel GitHub. Vous pouvez utiliser la syntaxe #mention pour les commits et les branches ou ajouter un commit GitHub, une pull request ou un lien de branche directement depuis l’élément de travail Azure Boards.

Remarque

Avec l’application Azure Boards pour GitHub, Azure Boards et Azure DevOps Services s’intègrent aux référentiels GitHub.com et GitHub Enterprise Server. Azure DevOps Server 2019 et les versions ultérieures prennent en charge l’intégration avec les référentiels GitHub Enterprise Server uniquement. L’intégration à d’autres dépôts Git n’est pas prise en charge.

Prérequis

Catégorie Exigences
Autorisations Contributeur au projet Azure Boards et au dépôt GitHub.
Connexion de projet Le projet Azure Boards est connecté au référentiel GitHub où se trouvent les validations, les requêtes de tirage et la branche que vous souhaitez relier ou à partir de laquelle vous souhaitez établir un lien. Pour plus d’informations, consultez intégration d’Azure Boards-GitHub.

Remarque

Les projets qui utilisent le modèle de processus XML hébergé nécessitent des mises à jour des types d’éléments de travail pour afficher les types de liens Développement et GitHub. Pour plus d’informations, consultez Mettre à jour les définitions XML pour sélectionner les types d’éléments de travail.

À partir d’une validation, d’une pull request ou d’un ticket GitHub, utilisez la syntaxe suivante pour créer un lien vers votre élément de travail Azure Boards. Entrez le AB#ID dans le texte d’un message de validation. Ou, pour une pull request ou un problème, saisissez le AB#ID dans le titre ou la description. L’utilisation de AB#ID dans un commentaire ne crée pas de lien sur l’élément de travail.

AB#{ID}

Par exemple, AB#125 établit un lien à l’ID d’élément de travail 125.

Vous pouvez également entrer un message de validation ou de pull request pour faire avancer l’élément de travail. Le système reconnaît {state} ou {state category}, ainsi que fix, fixes, et fixed, et l’applique à l’élément #-mention qui suit.

Lorsqu’une description de demande de tirage inclut un nom d’état valide, par exemple, Closed AB#1234, le système met à jour en conséquence l’élément de travail référencé. Si le nom d’état n’est pas reconnu directement, Azure Boards tente de le faire correspondre à une catégorie de flux de travail comme Resolved ou Completed. Si une correspondance est trouvée, l’élément de travail passe au premier état disponible défini dans cette catégorie.

Par défaut, les éléments de travail référencés avec fix, fixesou fixed passent au premier état associé à la catégorie résolue . Si aucun état de ce type n’existe dans le processus actuel, le système passe plutôt l’élément de travail à la première état de la catégorie Terminé .

Importante

Vous pouvez toujours lier des éléments de travail et cibler d’autres branches, mais les règles de transition d’état ne s’appliquent que si le pull request est fusionné dans la branche par défaut.

Pour plus d’informations, consultez Comment les états des catégories de flux de travail sont utilisés dans les backlogs et les tableaux Azure Boards.

Examinez le tableau suivant pour obtenir des exemples :

Message de validation ou de demande de tirage Action
Fixed AB#123 Lie et transfère l’élément de travail vers la catégorie d’état du flux de travail Résolu ou, si aucune n’est définie, vers la catégorie d’état du flux de travail Terminée.
Closed AB#123 Lie et transfère l’élément de travail à l’état du flux de travail fermé . Si aucune n’est définie, aucune transition n’est effectuée.
Adds a new feature, fixes AB#123. Lie et transfère l’élément de travail vers la catégorie d’état du flux de travail Résolu ou, si aucune n’est définie, vers la catégorie d’état du flux de travail Terminée.
Fixes AB#123, AB#124, and AB#126 Liens vers les éléments de travail Azure Boards 123, 124 et 126. Passe uniquement le premier élément, 123 à la catégorie d’état de flux de travail résolu ou, si aucun n’est défini, la catégorie d’état de flux de travail terminée .
Fixes AB#123, Fixes AB#124, Fixes AB#125 Liens vers les éléments de travail Azure Boards 123, 124 et 126. Effectue la transition de tous les éléments vers la catégorie d’état du flux de travail résolu ou, si aucun n’est défini, la catégorie d’état du flux de travail terminé.
Fixing multiple bugs: issue #123 and user story AB#234 Lie le problème GitHub 123 et l’élément de travail Azure Boards 234. Aucune transition n’est effectuée.

Remarque

Si vous avez connecté le même référentiel GitHub à des projets définis dans au moins deux organisations Azure DevOps, vous pouvez voir un lien de mention AB# inattendue. Pour plus d’informations, consultez Résoudre les problèmes de connexion. Pour cette raison, nous vous recommandons de connecter un dépôt GitHub uniquement aux projets définis dans une même organisation Azure DevOps.

Lorsque vous ajoutez un lien à un élément de travail avec AB#, ces liens apparaissent dans la section Développement du pull request.

Capture d’écran des liens AB# dans la section Développement d'une requête de tirage sur GitHub.

Créer une branche GitHub à partir d’un élément de travail

Pour créer une branche GitHub directement à partir d’un élément de travail, suivez ces étapes :

  1. Depuis votre tableau, trouvez l’élément de travail à partir duquel vous souhaitez créer une branche GitHub.

  2. Sélectionnez Actions d’élément de travail>Nouvelle branche GitHub.

    Capture d’écran de l’élément de travail avec l'option Plus d'actions sélectionnée et l'option Nouvelle branche GitHub mise en surbrillance.

  3. Dans la boîte de dialogue Créer une branche GitHub , entrez le nom de la branche, puis sélectionnez le référentiel GitHub et la branche de base.

  4. Sélectionnez Créer.

    Capture d’écran de la boîte de dialogue Créer une branche GitHub.

    Azure Boards crée la branche dans le référentiel GitHub spécifié et la lie à l’élément de travail. Pour plus d’informations, consultez intégration d’Azure Boards-GitHub.

  1. Ouvrez l’élément de travail et accédez à l’onglet Liens .

    Capture d’écran du formulaire d’élément de travail, 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 , sélectionnez un dépôt GitHub, entrez l’URL de la branche GitHub, validez ou pull request, puis sélectionnez Ajouter un lien.

    Dans l’exemple suivant, nous ajoutons un lien à une pull request GitHub.

    Capture d’écran du formulaire d’élément de travail, onglet Liens, boîte de dialogue Ajouter un lien, type de lien pull request GitHub sélectionné.

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

Remarque

Il y a un délai lors de la complétion des liens AB# si vous utilisez Azure DevOps Server et GitHub Enterprise Server. Nous avons une conception « push-and-pull » pour, toutes les heures, tirer des événements GitHub les modifications incrémentielles sur Commit, PR et Problème.

Plusieurs événements mettent automatiquement à jour les liens sur le formulaire d’élément de travail. Vous n’avez donc pas besoin de les créer manuellement. Voici quelques-uns des éléments suivants :

Événement GitHub Action
Lien vers la branche Lorsqu’une pull request est créée à partir d’une branche, elle est automatiquement liée à l’élément de travail.
Commit de fusion Une fois la pull request fusionnée, le commit fusionné résultant est automatiquement lié à l’élément de travail.
Supprimer une branche Si la branche est supprimée (généralement après la fusion), son lien est automatiquement supprimé de l’élément de travail.

La section Développement du formulaire d’élément de travail répertorie les liens créés vers les validations et les pull requests GitHub, indiqués par l’icône GitHub .

Capture d’écran du formulaire d’élément de travail, section Développement montrant les liens GitHub.

Choisissez le lien fourni pour ouvrir le commit ou la pull request dans GitHub.

Afficher les objets GitHub sur un tableau

Lorsque les annotations GitHub sont activées sur le tableau, vous pouvez ouvrir rapidement des validations, des demandes de tirage ou des problèmes GitHub liés pour plus de détails. Pour plus d’informations, consultez Personnaliser les cartes.

Capture d’écran du tableau montrant les liens GitHub sur les cartes d’élément de travail.

Étapes suivantes