Partager via

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

  • Pour installer l’application Azure Boards, vous devez être administrateur ou propriétaire de l’organisation GitHub.
  • Pour vous connecter au projet Azure Boards, vous devez disposer d’autorisations de Lecture pour le dépôt GitHub. De plus, vous devez être membre du groupe Project Collection Administrators. Si vous avez créé le projet, vous disposez d’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

Procédez comme suit pour accorder l’accès à l’organisation.

  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 OAuth 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, configurer un bouton de 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 montrant tous les référentiels sélectionnés.

  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 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. Autorisez votre organisation Azure Boards à se connecter à GitHub.com.

    Capture d’écran de la boîte de dialogue d’autorisation 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 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 et sélectionnez demande de tirage sous Ajouter un lien.

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

  4. Sélectionnez Ajouter un lien.

    Capture d’écran de l’action Ajouter un lien dans l’article utilisateur, montrant la sélection du référentiel et les zones vides pour l’entrée de l’ID de demande de tirage et le commentaire facultatif.

    Les actions suivantes se produisent 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.

  5. 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.

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

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

  7. 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 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. Pour ajouter ou supprimer des dépôts, choisissez Plus d’options pour 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.

  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 suppression de confirmation 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 au portail web de votre organisation GitHub et ouvrez Paramètres du compte.

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

  2. Choisissez Applications GitHub installées, puis Configurer en regard de Azure Boards.
    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. Choisissez Enregistrer quand vous avez terminé.

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