Connecter Azure DevOps Server à GitHub (local)

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Prérequis

• Intégration à GitHub :
  • Pour vous connecter à des référentiels GitHub.com, vous devez installer Azure DevOps Server 2020.1.1 Patch 2. Sans ce correctif, vous pouvez uniquement vous connecter à vos dépôts GitHub Enterprise Server.
  • Installez l’application Azure Boards pour GitHub sur le compte ou les organisations GitHub.
• Connexion au projet : se connecter à un projet Azure Boards ou Azure DevOps. Si vous n’avez pas encore de projet, créez-en un.
• Autorisations :
  • Soyez membre du groupe Administrateurs de collection de projets et du groupe Contributeurs du projet. Si vous avez créé le projet, vous disposez d’autorisations.
  • Soyez administrateur de GitHub Enterprise Server auquel vous vous connectez.

Options d’authentification

Les options d’authentification suivantes sont prises en charge.

Connecter Azure DevOps Server à GitHub Enterprise Server

1. Ouvrez le portail web pour votre serveur Azure DevOps Server.

2. Choisissez le logo Azure DevOps pour ouvrir Projets, puis choisissez le projet Azure Boards que vous souhaitez configurer pour vous connecter à vos référentiels GitHub Enterprise.

Connexion avec un jeton d’accès personnel

1. Pour créer un jeton d’accès personnel, consultez Création d’un jeton d’accès personnel.

   Conseil

   Lorsque vous créez votre PAT GitHub, assurez-vous d’inclure ces portées : repo, admin:repo_hook, read:user, user:email.

2. Entrez l’URL de votre serveur GitHub Enterprise et les informations d’identification de jeton d’accès personnel reconnues par ce serveur. Sélectionnez ensuite Se connecter.

Se connecter avec les informations d’identification GitHub

1. Entrez l’URL de votre serveur GitHub Enterprise et les informations d’identification du compte d’administrateur reconnues par ce serveur. Puis choisissez Se connecter.

2. La boîte de dialogue répertorie tous les dépôts pour lesquels vous disposez de droits d’administration GitHub. Vous pouvez basculer entre Les miens et Tous pour déterminer si d’autres personnes apparaissent, puis vérifier celles que vous souhaitez ajouter. Choisissez Enregistrer quand vous avez terminé.

   

3. Pour vous connecter à un compte ou une organisation GitHub depuis Azure Boards pour la première fois, vous devez également installer l’application Azure Boards pour GitHub. Terminez l’intégration en suivant les procédures décrites dans Confirmer la connexion.

Résoudre les problèmes de connexion

L’intégration d’Azure Boards-GitHub s’appuie sur différents protocoles d’authentification pour prendre en charge la connexion. Les modifications apportées à l’étendue d’autorisation ou aux informations d’authentification d’un utilisateur peuvent entraîner la révocation des dépôts GitHub connectés à Azure Boards.

Pour obtenir une vue d’ensemble de l’intégration prise en charge par l’application Azure Boards pour GitHub, consultez Intégration d’Azure Boards-GitHub.

Options d’authentification prises en charge

Les options d’authentification suivantes sont prises en charge en fonction de la plateforme GitHub à laquelle vous souhaitez vous connecter.

Résoudre les problèmes d’accès

Tenez compte des résolutions suivantes :

• Si la connexion utilise OAuth :

  • L’accès à l’application Azure Boards a été refusé pour l’un des dépôts.

  • GitHub peut être indisponible/inaccessible. Cette indisponibilité peut être due à une panne dans le service ou à un problème d’infrastructure/de réseau local. Vous pouvez vérifier l’état du service à partir des liens suivants :

    • GitHub
    • Azure DevOps

    Supprimez et recréez la connexion au référentiel GitHub. Cette connexion recréée amène GitHub à demander une nouvelle autorisation pour Azure Boards.

• Si la connexion utilise un jeton d’accès personnel :

  • Le PAT a été révoqué ou les étendues d’autorisation requises ont été modifiées et sont insuffisantes.

  • L’utilisateur a peut-être perdu des autorisations d’administration sur le dépôt GitHub.

    Recréez le PAT et assurez-vous que la portée du jeton inclut les autorisations requises : repo, read:user, user:email, admin:repo_hook. Pour plus d’informations, consultez Bonnes pratiques pour l’utilisation des PAT.

Mettre à jour les définitions XML pour certains types d’éléments de travail

Si votre organisation personnalise le suivi des travaux à l’aide du modèle de processus XML hébergé ou local et souhaite intégrer des types de liens GitHub dans la section Développement des formulaires d’éléments de travail, vous devez mettre à jour les définitions XML pour les types d’éléments de travail correspondants.

Par exemple, pour lier des récits utilisateur et des bogues à GitHub commits et des demandes de tirage dans la section Développement des formulaires d’éléments de travail, vous devez mettre à jour les définitions XML pour ces types d’éléments de travail.

Pour modifier les définitions XML, effectuez les étapes décrites dans le modèle de processus XML hébergé. Pour chaque type d’élément de travail :

1. Recherchez la section Group Label="Development".
2. Pour prendre en charge les types de liens externes, GitHub Commit et GitHub Pull Request, ajoutez les lignes de code suivantes :

Cette intégration permet un suivi transparent des activités GitHub directement à partir de vos éléments de travail dans Azure Boards.

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  

Une fois mise à jour, la section devrait apparaître comme suit.

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>  

Étapes suivantes

Articles connexes

• En savoir plus sur Azure Boards ?
• Résoudre les problèmes d’intégration de GitHub et Azure Boards
• Créer des référentiels du serveur GitHub Enterprise