Partager via


Lier des commits, des demandes de tirage 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, apprenez à lier des éléments de travail à des commits et des pull requests GitHub après avoir connecté votre projet Azure Boards à un référentiel GitHub. Vous pouvez utiliser la syntaxe #mention ou ajouter un lien de commit ou de pull request GitHub directement à partir de 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

  • Connexion du projet :

    • Assurez-vous que votre projet Azure Boards est connecté au référentiel GitHub où se trouvent les commits et les pull requests que vous souhaitez lier. Pour plus d’informations, consultez Intégration Azure Boards-GitHub.
  • Autorisations :

    • Soyez Contributeur à la fois du projet Azure Boards et du référentiel 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 certains types d’éléments de travail.

À partir d’une validation, d’une demande de tirage ou d’un problème 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 demande ou un problème de tirage , 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.

Remarque

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

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 demande de tirage pour effectuer la transition de l’élément de travail. Le système reconnaît fix, fixes et fixed, et l’applique à l’élément #-mention qui suit. Les éléments de travail mentionnés passent au premier État associé à l’état de catégorie de workflow Résolu. Si aucun État n’est associé à Résolu, l’élément de travail passe à l’État associé à l’état de catégorie de flux de travail Terminé. Pour plus d’informations, consultez Utilisation des états de catégorie de workflow dans les backlogs et 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 fait transitionner l’élément de travail vers la catégorie d’état de workflow Résolu ou, si aucun n’est défini, la catégorie d’état de workflow Terminé.
Adds a new feature, fixes AB#123. Lie et fait transitionner l’élément de travail vers la catégorie d’état de workflow Résolu ou, si aucun n’est défini, la catégorie d’état de workflow Terminé.
Fixes AB#123, AB#124, and AB#126 Lie les éléments de travail Azure Boards 123, 124 et 126. Fait transitionner uniquement le premier élément, 123, vers la catégorie d’état de workflow Résolu ou, si aucun n’est défini, la catégorie d’état de workflow Terminé.
Fixes AB#123, Fixes AB#124, Fixes AB#125 Lie les éléments de travail Azure Boards 123, 124 et 126. Fait transitionner tous les éléments vers la catégorie d’état de workflow Résolu ou, si aucun n’est défini, la catégorie d’état de workflow 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.

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 de l’élément de travail>Nouvelle branche GitHub.

    Capture d’écran des actions supplémentaires de l’élément de travail avec l’option Nouvelle branche GitHub sélectionnée et mise en évidence.

  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 Azure Boards-GitHub.

Remarque

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

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

    Capture d’écran du formulaire É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, saisissez l’URL de la branche, du commit ou de la demande de tirage GitHub, puis sélectionnez Ajouter un lien.

    Dans l’exemple suivant, nous ajoutons un lien à une demande de tirage GitHub.

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

    Azure Boards effectue une vérification pour vous assurer que vous avez entré un lien valide. Le référentiel GitHub lié doit être connecté au projet Azure Boards ; sinon, 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.

La section Développement du formulaire d’élément de travail répertorie les liens créés vers les validations et les demandes de tirage GitHub avec 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 la validation ou la demande de tirage 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 des cartes.

Capture d’écran du tableau qui montre les liens GitHub sur les cartes d’éléments de travail.

Étapes suivantes