Connecter Azure DevOps Server à GitHub (local)

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

Prérequis

• 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.
• Connectez-vous à un projet Azure Boards ou Azure DevOps. Si vous n’avez pas encore de projet, créez-en un.
• Vous devez être membre du groupe Administrateurs de collection de projets et du groupe Contributeurs du projet. Si vous avez créé le projet, vous disposez d’autorisations.
• Vous devez être administrateur du serveur GitHub Enterprise Server auquel vous allez vous connecter.

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.

Connexion avec un nom d’utilisateur et un mot de passe

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.

Plateforme

GitHub.com

GitHub Enterprise Server

Azure DevOps Services

• Compte d’utilisateur GitHub.com
• Un jeton d’accès personnel (PAT)

• OAuth
• Jeton d’accès personnel
• Nom d’utilisateur plus mot de passe

Azure DevOps Server 2020

Non applicable

• Jeton d’accès personnel
• Nom d’utilisateur plus mot de passe

Azure DevOps Server 2019

Non applicable

• OAuth
• Jeton d’accès personnel
• Nom d’utilisateur plus mot de passe

Notes

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

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

Lorsque la connexion Azure Boards à GitHub n’a plus accès, elle affiche un état d’alerte dans l’interface utilisateur avec un X rouge. Pointez sur l’alerte ; elle indique que les informations d’identification ne sont plus valides. Pour corriger le problème, supprimez la connexion et recréez une nouvelle connexion.

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 jeton d’accès personnel a peut-être été révoqué ou les étendues d’autorisation requises ont été modifiées et sont insuffisantes.

  • L’utilisateur a peut-être perdu les autorisations d’administrateur 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.

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

Si votre organisation utilise le modèle de processus XML hébergé ou local pour personnaliser l’expérience de suivi des travaux et que vous souhaitez lier et afficher les types de liens GitHub à partir de la section Développement dans les formulaires d’éléments de travail, vous devez mettre à jour les définitions XML applicables aux types d’éléments de travail.

Par exemple, si vous souhaitez lier des récits utilisateur et des bogues aux validations et aux demandes de tirage GitHub à partir de la section Développement, vous devez mettre à jour les définitions XML pour les récits utilisateur et les bogues.

Suivez la séquence de tâches fournie dans Modèle de processus XML hébergé pour mettre à jour les définitions XML. Pour chaque type d’élément de travail, recherchez la section Group Label="Development" et ajoutez les deux lignes suivantes dans la syntaxe de code suivante pour prendre en charge les types de liens externes : Validation GitHub et Demande de tirage GitHub.

             <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

Lier les validations et les demandes de tirage (pull requests) GitHub aux éléments de travail

Articles connexes

• Qu’est-ce qu’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