# Ajout d’un badge d’état de flux de travail

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

> \[!NOTE]
> Les exécuteurs hébergés sur GitHub Enterprise Server ne sont pas pris en charge sur GitHub.

> \[!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.

![Capture d’écran d’un badge d’état de workflow. De droite à gauche, le logo GitHub, le nom du flux de travail (« Version de démonstration GitHub Actions ») et l’état (« Passé ») sont affichés.](/assets/images/help/repository/actions-workflow-status-badge.png)

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 d’écriture et de mise en forme de base](/fr/enterprise-server@3.22/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images) ».

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

1. Sur GitHub, accédez à la page principale du référentiel.
2. Sous le nom de votre référentiel, cliquez sur **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-play" aria-label="play" role="img"><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"></path></svg> Actions**.

   ![Capture d’écran des onglets du référentiel « github/docs ». L’onglet « Actions » est mis en surbrillance avec un encadré orange.](/assets/images/help/repository/actions-tab-global-nav-update.png)
3. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher.

   ![Capture d'écran de la barre latérale gauche de l'onglet « Actions », avec un workflow « CodeQL » indiqué en orange foncé.](/assets/images/help/actions/superlinter-workflow-sidebar.png)
4. Sur le côté droit de la page, à côté du champ « Filtrer les exécutions du flux de travail », cliquez sur <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Show workflow options" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg> pour afficher un menu déroulant, puis cliquez sur **Créer un badge de statut**.
5. 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.
6. Vous pouvez également sélectionner l’événement qui déclenchera le flux de travail.
7. Cliquez sur **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copy" aria-label="copy" role="img"><path d="M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z"></path><path d="M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z"></path></svg> Copier le Markdown du badge d’état**.
8. 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 :

```text
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 d’écriture et de mise en forme de base](/fr/enterprise-server@3.22/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images) ».

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

```markdown
![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`.

```markdown
![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.

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