Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
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.
Utiliser AB#
pour lier des éléments de travail GitHub à Azure Boards
À 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
, fixes
ou 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.
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 :
Depuis votre tableau, trouvez l’élément de travail à partir duquel vous souhaitez créer une branche GitHub.
Sélectionnez
Actions d’élément de travail>Nouvelle branche GitHub.
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.
Sélectionnez Créer.
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.
Ajouter un lien d’élément de travail à une branche, un commit ou une pull request GitHub
Ouvrez l’élément de travail et accédez à l’onglet Liens .
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.
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.
Mises à jour automatiques des liens
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. |
Afficher ou ouvrir des liens à partir de la section Développement
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 .
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.