Partager via


Ajouter des badges d'état pour votre dépôt GitHub

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

Vous pouvez ajouter la syntaxe Markdown à un fichier du référentiel GitHub README.md afin d’afficher le statut de votre tableau dans ce référentiel. Affichez le statut en ajoutant la syntaxe de votre choix à partir des paramètres de votre tableau.

La syntaxe indiquée fonctionne que vous ayez connecté votre projet à un référentiel GitHub.com ou à votre référentiel GitHub Enterprise Server. Pour GitHub Enterprise Server, votre serveur doit être accessible au réseau Azure DevOps Services.

Prerequisites

Category Requirements
Permissions 'administrateur d’équipe pour les paramètres de l’équipe que vous souhaitez modifier ou membre du groupe Administrateurs de projet.
Intégration de à GitHub Connectez votre projet au dépôt GitHub où se trouvent les commits et pull requests que vous souhaitez lier.
Configuration de la carte Une carte que vous souhaitez configurer. Lorsque vous ajoutez une équipe, vous ajoutez un tableau pour cette équipe. Pour plus d’informations, consultez À propos des équipes et des outils Agile.
Accès au référentiel Pour ajouter le badge d’état au référentiel GitHub.com : Contributeur au référentiel.

Ajouter un badge d’état

  1. Connectez-vous à Azure Boards et ouvrez votre tableau.

  2. Choisissez l’icône d’engrenage pour configurer le tableau et définir les paramètres généraux de l’équipe.

    Capture d’écran des paramètres du tableau d’ouverture.

  3. Sélectionnez Badge de statut, puis cochez ou décochez la case Autoriser les utilisateurs anonymes à accéder au badge de statut. Lorsque cette option n’est pas cochée, les utilisateurs qui ne sont pas connectés peuvent toujours voir le badge de statut.

    Capture d’écran de la boîte de dialogue Paramètres du tableau, onglet Badge de statut.

  4. Sélectionnez le type de badge souhaité, puis cliquez sur l’icône de copie pour copier la syntaxe Markdown du badge.

    • Afficher les colonnes « En cours » uniquement ignore les première et dernière colonnes.
    • Inclure toutes les colonnes inclut les première et dernière colonnes du tableau.
    • Vous pouvez personnaliser l’ensemble des colonnes en spécifiant 2 pour les options de colonne, puis une liste séparée par des virgules des colonnes du tableau à afficher. Par exemple, ?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review, comme indiqué dans la syntaxe suivante. Pour les libellés de colonnes contenant des espaces, il est nécessaire d’encoder l’espace avec %20. Par exemple : In%20Progress.
     [![Board Status](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/_apis/work/boardbadge/6fa7b56f-d27c-4e96-957d-f9e7b0f56705?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review)](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/_boards/board/t/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/Microsoft.RequirementCategory/)
    

    Un badge similaire à celui ci-dessous s’affiche.

    Capture d’écran montrant le badge affiché.

  5. Lorsque vous avez terminé, sélectionnez Enregistrer.

    Le seul paramètre que vous pouvez configurer est Autoriser les utilisateurs anonymes à accéder au badge de statut. Le type de badge sous Paramètres permet uniquement de changer la syntaxe Markdown que vous pouvez copier à partir des valeurs Exemple Markdown et URL de l’image.

  6. Ouvrez le fichier README dans votre référentiel GitHub et collez la syntaxe que vous avez copiée pour afficher le badge.

    Vous devriez voir la même image d’aperçu que celle que vous avez sélectionnée, avec des valeurs correspondant à votre tableau.