Installer l’application Azure Boards pour GitHub

  • Article

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

Installez l’application Azure Boards pour GitHub pour la connecter à 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.

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. Une fois que vous avez installé l’application Azure Boards pour GitHub sur votre compte GitHub ou une organisation, choisissez les dépôts GitHub auxquels vous souhaitez vous connecter à partir de votre projet.

Prérequis

Autorisations :

  • Vous devez être un administrateur ou propriétaire de l’organisation GitHub pour pouvoir installer l’application Azure Boards.
  • Vous devez avoir des autorisations de Lecture pour le dépôt GitHub.
  • Vous devez être membre du groupe Administrateurs de collection de projets. Si vous avez créé le projet, vous disposez déjà de ces autorisations.

Important

Si votre dépôt est déjà connecté via un autre type d’authentification comme OAuth, vous devez le retirer de votre connexion existante avant de le reconnecter via 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 Toutefois, vous ne devez pas connecter un dépôt GitHub à plusieurs organisations Azure DevOps.

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

Pour accorder à GitHub l’accès à votre organisation Azure DevOps, veuillez procéder comme suit.

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

    Capture d’écran de l’ouverture du profil, choisissez Paramètres.

  2. Sélectionnez Applications sous Intégrations.

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

    Capture d’écran de l’onglet Applications OAuth autorisées, choisissez Azure Boards.

  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 de l’accès de l’organisation avec des organisations sans accès.

Installer et configurer l’application Azure Boards

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

  2. Sélectionnez Paramétrer un plan.

    Capture d’écran de GitHub Marketplace, bouton Paramétrer un plan.

  3. Choisissez l’organisation GitHub à connecter à Azure Boards.

    Capture d’écran montrant la boîte de dialogue Installer Azure Boards.

  4. Choisissez les dépôts que vous souhaitez connecter à Azure Boards.

    Dans l’exemple suivant, nous choisissons de nous connecter à tous les dépôts.

    Capture d’écran mettant en évidence l’option Tous les dépôts.

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

    Capture d’écran de la boîte de dialogue de configuration de la connexion.

    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.

  6. Pour la connexion avec GitHub.com, veuillez autoriser votre organisation Azure Boards.

    Capture d’écran de la boîte de dialogue d’autorisation d’Azure Boards.

  7. Vérifiez les dépôts GitHub.com que vous souhaitez connecter. Sélectionnez chaque dépôt auquel vous souhaitez vous connecter. Désélectionnez tous les dépôts que vous ne souhaitez pas faire participer à l’intégration.

    Capture d’écran de la boîte de dialogue Confirmer vos dépôts GitHub.

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. Sélectionnez Demande de tirage GitHub dans le menu déroulant Type de lien.

  4. Sélectionnez le dépôt et saisissez l’ID de demande de tirage et un commentaire facultatif.

  5. Sélectionnez Ajouter un lien.

    Capture d’écran de l’action Ajouter un lien dans le récit utilisateur, montrant la sélection du dépôt et les boîtes vides pour la saisie de l’ID de demande de tirage et d'un 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éation d’une demande de tirage GitHub pour fusionner les modifications apportées au fichier README.
    • Lie la validation GitHub et la demande de tirage à l’élément de travail créé à l’étape 1.

  6. Sélectionnez le premier lien de demande de tirage à partir de votre élément de travail.

    Capture d’écran du formulaire de problème pour la demande de tirage ouverte dans GitHub.

    La demande de tirage GitHub s’ouvre dans un nouvel onglet de navigateur.

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

    Capture d’écran d’un exemple de demande de tirage dans GitHub.

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

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

    Pour en savoir plus, consultez Configurer les badges d’état à ajouter aux fichiers README de 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 Modifiez l’accès au référentiel GitHub, ou suspendez ou désinstallez l’intégration.

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 du menu de connexion GitHub Autres options.

  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 de la confirmation de suppression de la connexion GitHub.

  1. Pour ajouter ou supprimer des dépôts, ouvrez l’icône d’actions de la connexion et choisissez Ajouter des dépôts ou Supprimer des dépôts dans le menu.

    Capture d’écran de l’ajout ou de la suppression de dépôts GitHub.

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

    Capture d’écran de la boîte de dialogue de confirmation de la suppression de la connexion GitHub.

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

  1. Connectez-vous à GitHub et ouvrez les paramètres de profil de votre organisation.

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. Accédez à Applications GitHub installées>Azure Boards>Configurer.
    Capture d'écran du compte de l'organisation ouvert, des applications GitHub installées, Azure Boards, 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 de l'accès au référentiel, sélection de l’option Référentiels sélectionnés uniquement.

  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 de la configuration Azure Boards, section Zone de danger.

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

    Capture d'écran de la confirmation de la 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 de la 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 en savoir plus, consultez Ajouter/supprimer des dépôts GitHub.

Capture d'écran de l'application Azure Boards GitHub désinstallée.

Étapes suivantes

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