Skip to main content

Adding a workflow status badge

Vous pouvez afficher un badge d’état dans votre dépôt pour indiquer l’état de vos workflows.

Remarque : 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.

Remarque : 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. Vous pouvez également 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.

Capture d’écran d’un badge d’état de workflow. Le côté gauche contient le logo octocat et « GitHub Actions Demo », le nom du workflow. La moitié droite est en vert avec le texte « passing ».

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

![example workflow](https://github.com/github/docs/actions/workflows/main.yml/badge.svg)

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.

![example branch parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?branch=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.

![example event parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?event=push)