Partager via

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

  • Article

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

Vous pouvez ajouter la syntaxe Markdown à un fichier de dépôt README.md GitHub pour afficher l’état de votre carte dans ce dépôt. Affichez l’état en ajoutant la syntaxe que vous choisissez parmi vos paramètres de carte.

Remarque

Nécessite Azure DevOps Server 2019 Update 1 ou version ultérieure.

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

Prérequis

  • Autorisations : être administrateur d’équipe pour les paramètres de l’équipe que vous souhaitez modifier ou être membre du groupe Administrateurs de projet.
  • Intégration à GitHub : connectez votre projet au dépôt GitHub où les validations et les demandes de tirage que vous souhaitez lier à/partir existent.
  • Configuration de la carte : disposez d’un tableau 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, soyez un contributeur du référentiel.

Ajouter un badge d’état

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

  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 de l’ouverture des paramètres de carte.

  3. Choisissez Badge d’état, puis cochez ou décochez la case Autoriser les utilisateurs anonymes à accéder au badge d’état. Lorsqu’ils ne sont pas activés, les utilisateurs qui ne sont pas connectés peuvent toujours afficher le badge d’état.

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

    Capture d’écran de la boîte de dialogue Paramètres du tableau, onglet Badge d’état, Azure DevOps Server 2019.

  4. Choisissez le type de badge souhaité et choisissez 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 également personnaliser l’ensemble de colonnes en spécifiant 2 pour la colonne Options, puis une liste délimitée par des virgules pour les colonnes du tableau à afficher. Par exemple, ?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review, comme indiqué dans la syntaxe suivante. Pour les étiquettes de colonne qui incluent des espaces, vous devez 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 au suivant 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 d’état. Le type de badge sous Paramètres change uniquement la syntaxe Markdown que vous pouvez copier à partir des valeurs Markdown et URL de l’image.

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

    Vous devez voir la même image d’aperçu que celle que vous avez sélectionnée avec des valeurs qui correspondent à votre carte.