Note
Les exécuteurs hébergés sur GitHub ne sont pas pris en charge sur GitHub Enterprise Server. Vous pouvez voir plus d’informations sur le support futur planifié dans la GitHub public roadmap.
Note
Les badges de workflow dans un dépôt privé ne sont pas accessibles en externe. Vous ne pouvez donc pas les incorporer ni les lier à partir d’un site externe.
Un badge d’état indique si un workflow est en train d’échouer ou de réussir. En règle générale, vous ajoutez un badge d’état dans le fichier README.md de votre dépôt, mais vous pouvez l’ajouter dans n’importe quelle page web de votre choix. Par défaut, les badges affichent l’état de votre branche par défaut. Si aucun flux de travail n’est exécuté sur votre branche par défaut, ils affichent l’état de l’exécution la plus récente sur toutes les branches. Vous pouvez afficher l’état d’une exécution de workflow pour une branche ou un événement spécifique en utilisant les paramètres de requête branch et event dans l’URL.
Pour ajouter un badge d’état de workflow à votre fichier README.md, recherchez d’abord l’URL du badge d’état que vous souhaitez afficher. Vous pouvez ensuite utiliser Markdown pour afficher le badge en tant qu’image dans votre fichier README.md. Pour plus d’informations sur le balisage d’image dans Markdown, consultez « Syntaxe de base pour l’écriture et la mise en forme ».
Utilisation de l’interface utilisateur
Vous pouvez créer un badge de statut de flux de travail directement dans l’interface utilisateur à l’aide du nom du fichier de flux de travail, du paramètre de branche et du paramètre d’événement.
-
Sur GitHub, accédez à la page principale du référentiel.
-
Sous le nom de votre dépôt, cliquez sur Actions.
-
Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher.
-
Sur le côté droit de la page, à côté du champ « Filtrer les exécutions du flux de travail », cliquez sur pour afficher un menu déroulant, puis cliquez sur Créer un badge de statut.
-
Vous pouvez également sélectionner une branche si vous souhaitez afficher le badge de statut pour une branche différente de la branche par défaut.
-
Vous pouvez également sélectionner l’événement qui déclenchera le flux de travail.
-
Cliquez sur Copier le badge de statut Markdown.
-
Copiez le Markdown dans votre fichier
README.md.
Utilisation du nom de fichier de workflow
Vous pouvez générer l’URL d’un badge d’état de workflow à l’aide du nom du fichier de workflow :
HOSTNAME/OWNER/REPOSITORY/actions/workflows/WORKFLOW-FILE/badge.svg
Pour afficher le badge d’état du workflow dans votre fichier README.md, utilisez le balisage Markdown afin d’incorporer des images. Pour plus d’informations sur le balisage d’image dans Markdown, consultez « Syntaxe de base pour l’écriture et la mise en forme ».
Ajoutez par exemple la balise Markdown suivante à votre fichier README.md pour ajouter un badge d’état pour un workflow avec le chemin de fichier .github/workflows/main.yml. Le OWNER du dépôt est l’organisation github et le nom du REPOSITORY est docs.
Utilisation du paramètre branch
Pour afficher l’état d’exécution du workflow pour une branche spécifique, ajoutez ?branch=BRANCH-NAME à la fin de l’URL du badge d’état.
Ajoutez par exemple la balise Markdown suivante à votre fichier README.md pour afficher un badge d’état pour une branche nommée feature-1.
Utilisation du paramètre event
Pour afficher l’état des exécutions de workflow déclenchées par l’événement push, ajoutez ?event=push à la fin de l’URL du badge d’état.
Ajoutez par exemple le balisage Markdown suivant à votre fichier README.md pour afficher un badge avec l’état des exécutions de workflow déclenchées par l’événement push, qui affiche l’état de la build pour l’état actuel de cette branche.
