Partager via

Installer l’application Azure Boards pour GitHub

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

Dans ce guide de démarrage rapide, vous installez l’application Azure Boards pour GitHub pour connecter Azure Boards à vos dépôts GitHub. Lorsque vous connectez des projets Azure Boards à des dépôts GitHub.com, vous prenez en charge la liaison entre les validations GitHub et les demandes de tirage aux éléments de travail. Vous pouvez utiliser GitHub pour le développement de logiciels tout en utilisant Azure Boards pour planifier et suivre votre travail. Après avoir installé l’application Azure Boards pour GitHub sur votre compte GitHub ou votre organisation, choisissez les référentiels GitHub auxquels vous souhaitez vous connecter à partir de votre projet.

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.

Prerequisites

Category Requirements
Permissions - Membre du groupe Administrateurs de collection de projets. Si vous avez créé le projet, vous disposez d’autorisations.
- administrateur ou propriétaire de l’organisation GitHub pour installer l’application Azure Boards.
- Lire les permissions pour le référentiel GitHub.
Appartenance au projet Membre du projet.

Important

Si votre référentiel est déjà connecté à l’aide d’un autre type d’authentification tel que OAuth, vous devez supprimer ce référentiel de votre connexion existante avant de le reconnecter à l’aide de l’application GitHub. Avant de configurer l’application GitHub, suivez les étapes décrites dans Ajouter ou supprimer des dépôts GitHub dans la suite de cet article.

Vous pouvez connecter une organisation Azure DevOps à plusieurs dépôts GitHub si vous êtes administrateur de ces derniers Vous ne devez pas connecter un dépôt GitHub à plusieurs organisations Azure DevOps.

Installer et configurer l’application Azure Boards

Votre séquence d’installation peut varier en raison de la configuration de votre compte. Si nécessaire, suivez les instructions affichées à l’écran entre les étapes suivantes.

  1. Accédez à l’application Azure Boards dans le GitHub Marketplace.

  2. Sous Plans et tarification, sous Gratuit, sélectionnez Installer.

  3. Dans Installer & Autoriser Azure Boards, choisissez les référentiels que vous souhaitez connecter à Azure Boards, puis sélectionnez Installer et Autoriser.

    Cet exemple utilise tous les référentiels :

    Capture d’écran montrant la page Installer et Autoriser avec tous les référentiels sélectionnés.

  4. Choisissez l’organisation Azure DevOps et le projet Azure Boards que vous souhaitez connecter à GitHub.com.

    Capture d’écran montrant la page Configurer votre projet Azure Boards dans laquelle vous sélectionnez une organisation et un projet.

    Vous ne pouvez connecter qu’un seul projet à la fois. Si vous souhaitez connecter d’autres projets, vous pouvez le faire ultérieurement, comme décrit dans Configurer d’autres projets ou dépôts plus loin dans cet article.

Accorder à l’organisation l’accès à Azure Boards

Si nécessaire, pour accorder à GitHub l’accès à votre organisation Azure DevOps, procédez comme suit.

  1. Sur le portail Web GitHub, ouvrez les Paramètres dans le menu de votre profil.

    Capture d’écran montrant l’option Paramètres dans votre profil.

  2. Sélectionnez Applications sous Intégrations.

  3. Sélectionnez Applications GitHub autorisées>Azure Boards.

    Capture d’écran montrant les applications GitHub autorisées avec Azure Boards mis en surbrillance.

  4. Sous Accès à l’organisation, résolvez les problèmes qui peuvent survenir. Choisissez Accorder pour accorder l’accès à toutes les organisations qui indiquent avoir une Demande d’accès en attente.

    Capture d’écran montrant l’accès des organisations, certaines ayant accès et d'autres non.

Vérifier votre stratégie d’accès à l’application tierce

Vérifiez que votre organisation GitHub autorise l’accès aux applications tierces pour l’application Azure Boards. Si l’accès tiers est restreint, l’ajout de référentiels à partir d’Azure DevOps peut afficher une liste vide ou générer une erreur.

Pour activer l’accès :

  1. Dans GitHub, ouvrez votre organisation et accédez à Paramètres > stratégie d'application OAuth.

  2. Approuvez l’application Azure Boards spécifiquement (recommandée) ou supprimez les restrictions pour toutes les applications tierces.

    Capture d’écran montrant la stratégie d’accès aux applications tierces.

Note

Vous devez être propriétaire ou administrateur de l’organisation pour modifier ce paramètre.

Utiliser la connexion

À ce stade, votre intégration Azure Boards-GitHub est terminée. Vous pouvez ignorer les étapes suivantes ou les parcourir pour comprendre les fonctionnalités prises en charge par la connexion.

  1. Sur votre tableau, sélectionnez Nouvel élément de travail pour saisi un nouvel élément de travail nommé « Ajouter un badge au fichier README » (Problème (de base), Récit utilisateur (Agile) ou Élément de backlog de produit (Scrum), en fonction du modèle de processus utilisé par votre projet Azure Boards.

    Un élément de travail intitulé Ajouter un badge au fichier README s’affiche sur votre tableau.

  2. Ouvrez votre élément de travail, accédez à la section Développement, puis sélectionnez Ajouter un lien.

  3. Dans le type de lien, sélectionnez GitHub Pull Request.

  4. Sélectionnez le dépôt et saisissez l'ID de la requête d'extraction et un commentaire facultatif.

  5. Sélectionnez Ajouter un lien.

    Capture d’écran montrant l’action Ajouter un lien dans la user story, illustrant la sélection du référentiel et les champs vides pour l’entrée de l’ID de pull request et du commentaire facultatif.

    Les actions suivantes se produisent automatiquement en arrière-plan.

    • Ajout d’un badge au fichier README du premier dépôt de la liste des dépôts GitHub connectés.
    • Création d’une validation GitHub pour la mise à jour effectuée en ajoutant le badge au fichier README.
    • Crée une pull request GitHub pour fusionner les modifications apportées au fichier README.
    • Lie le commit GitHub et le pull request à l’élément de travail créé à l’étape 1.

  6. Sélectionnez le premier lien de pull request à partir de votre élément de travail.

    Capture d’écran montrant le formulaire de problème pour la pull request ouverte dans GitHub.

    La pull request GitHub s’ouvre dans un nouvel onglet du navigateur.

  7. Sélectionnez Merge pull request (Fusionner la demande de tirage).

    Capture d’écran montrant un exemple de pull request dans GitHub.

  8. Accédez au fichier README de votre dépôt et affichez le badge qui a été ajouté.

    Capture d’écran montrant le dépôt GitHub avec le badge ajouté.

    Pour plus d’informations, consultez Ajouter des badges d’état pour votre dépôt GitHub.

Configurer d’autres projets ou dépôts

Vous pouvez configurer d’autres référentiels Azure Boards/Azure DevOps Projects, GitHub.com ou modifier la configuration actuelle à partir de la page d’application Azure Boards. Pour plus d’informations, consultez Ajouter ou supprimer des référentiels, ou supprimer une connexion d’Azure Boards.

Ajouter ou supprimer des dépôts, ou supprimer une connexion à partir d’Azure Boards

Si vous rencontrez un problème avec une connexion, nous vous recommandons de supprimer la connexion et de recommencer avec une nouvelle connexion.

  1. Dans votre projet Azure DevOps, allez à Paramètres du projet>Connexions GitHub.

  2. Pour ajouter ou supprimer des dépôts, sélectionnez les points de suspension Autres options de la connexion et choisissez Ajouter des dépôts ou Supprimer des dépôts dans le menu.

    Capture d’écran montrant le menu Autres options de connexion GitHub.

  3. Pour supprimer tous les dépôts et la connexion, choisissez l’option Supprimer la connexion. Ensuite, choisissez Supprimer pour confirmer.

    Capture d’écran montrant la suppression de confirmation de la connexion GitHub.

Modifier l’accès au référentiel

  1. Sur le portail Web GitHub, ouvrez les Paramètres dans le menu de votre profil.

  2. Sélectionnez Intégrations>Applications. Sous Applications GitHub installées, sélectionnez Configurer.

    Capture d’écran montrant les applications GitHub installées avec Azure Boards et l’option Configurer.

    La page de configuration Azure Boards s’ouvre.

  3. Faites défiler jusqu’à la section Accès au référentiel.

  4. Choisissez l’option souhaitée, Tous les référentiels ou Référentiels sélectionnés uniquement.

    Si vous choisissez Référentiels sélectionnés uniquement, sélectionnez les référentiels que vous souhaitez inclure dans l’intégration à Azure Boards.

    Capture d’écran montrant l’accès au référentiel, où vous pouvez choisir les référentiels sélectionnés.

  5. Cliquez sur Enregistrer.

Suspendre ou désinstaller l’intégration Azure Boards

  1. À partir de l’étape 2 de la procédure précédente, faites défiler jusqu’à la section Zone de danger.

    Capture d’écran montrant la section Zone Danger, avec les options permettant de suspendre et de désinstaller.

  2. Pour suspendre l’intégration, choisissez Suspendre. Dans la fenêtre de confirmation, choisissez OK pour confirmer la suspension.

    Capture d’écran montrant la boîte de dialogue de confirmation de suspension.

    Pour annuler l’intégration, choisissez Annuler l’interruption.

  3. Pour désinstaller l’application Azure Boards, choisissez Désinstaller, puis OK dans la fenêtre contextuelle de confirmation.

    Capture d’écran montrant la boîte de dialogue de confirmation de désinstallation.

Mettre à jour les connexions entre Azure Boards et GitHub

Si vous modifiez les dépôts pris en charge par l’application Azure Boards pour GitHub, vous risquez d’être redirigé vers des connexions GitHub-Azure Boards. Une bonne pratique consiste à supprimer les référentiels dans Azure Boards qui ne peuvent plus se connecter à GitHub. Pour plus d’informations, consultez Ajouter ou supprimer des dépôts GitHub.

Si vous désinstallez l’application Azure Boards pour GitHub, le message suivant s’affiche dans Azure Boards : Paramètres du projet>Connexions GitHub. Choisissez Supprimer la connexion pour supprimer toutes les connexions GitHub précédemment établies. Pour plus d’informations, consultez Ajouter ou supprimer des dépôts GitHub.

Capture d’écran montrant l’application GitHub Azure Boards désinstallée.

Étapes suivantes

Lier les commits GitHub, les pull requests et les branches aux éléments de travail.

Contenu connexe

  • Last updated on