# Exécution manuelle d’un workflow

Lorsqu’un flux de travail est configuré pour s’exécuter sur l’événement workflow_dispatch , vous pouvez exécuter le flux de travail à l’aide de l’onglet Actions sur GitHub, GitHub CLIou de l’API REST.

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

## Configuration d’un workflow à exécuter manuellement

Pour exécuter un workflow manuellement, ce dernier doit être configuré pour s’exécuter sur l’événement `workflow_dispatch`.

Pour déclencher l’événement `workflow_dispatch`, votre workflow doit se trouver dans la branche par défaut. Pour plus d’informations sur la configuration de l’événement `workflow_dispatch`, consultez [Événements qui déclenchent des flux de travail](/fr/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).

L’accès en écriture au dépôt est requis pour effectuer ces étapes.

## Exécution d’un workflow

<div class="ghd-tool webui">

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 nom du workflow que vous souhaitez exécuter.

   ![Capture d’écran de la page « Actions ». Dans la barre latérale gauche, un nom de workflow est mis en évidence avec un encadré en orange foncé.](/assets/images/help/repository/actions-select-workflow-2022.png)

4. Au-dessus de la liste des exécutions de workflows, cliquez sur le bouton **Exécuter le workflow**.

   > \[!NOTE]
   > Pour que le bouton **Exécuter le workflow** soit visible, votre fichier de workflow doit utiliser le déclencheur d’événements `workflow_dispatch`. Seuls les fichiers de workflow qui utilisent le déclencheur d’événements `workflow_dispatch` peuvent exécuter le workflow manuellement à l’aide du bouton **Exécuter le workflow**. Pour plus d’informations sur la configuration de l’événement `workflow_dispatch`, consultez [Événements qui déclenchent des flux de travail](/fr/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).

   ![Capture d’écran d’une page de workflow. Au-dessus de la liste des exécutions de workflow, un bouton intitulé « Exécuter le workflow » est indiqué en orange foncé.](/assets/images/help/actions/actions-workflow-dispatch.png)

5. Sélectionnez le menu déroulant **Branche** et cliquez sur une branche sur laquelle exécuter le workflow.

6. Si le workflow nécessite une entrée, renseignez les champs.

7. Cliquez sur **Exécuter le workflow**.

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> Pour plus d’informations sur GitHub CLI, consultez [À propos de l’interface CLI GitHub](/fr/enterprise-server@3.22/github-cli/github-cli/about-github-cli).

Pour exécuter un workflow, utilisez la sous-commande `workflow run`. Remplacez le paramètre `workflow` par le nom, l’ID ou le nom de fichier du workflow que vous souhaitez exécuter. Par exemple, `"Link Checker"`, `1234567` ou `"link-check-test.yml"`. Si vous ne spécifiez pas de flux de travail, GitHub CLI retourne un menu interactif pour choisir un flux de travail.

```shell
gh workflow run WORKFLOW
```

Si votre flux de travail accepte les entrées, GitHub CLI vous invitez à les entrer. Vous pouvez également utiliser `-f` ou `-F` pour ajouter une entrée au format `key=value`. Utilisez `-F` pour lire à partir d’un fichier.

```shell
gh workflow run greet.yml -f name=mona -f greeting=hello -F data=@myfile.txt
```

Vous pouvez également transmettre des entrées au format JSON à l’aide d’une entrée standard.

```shell
echo '{"name":"mona", "greeting":"hello"}' | gh workflow run greet.yml --json
```

Pour exécuter un workflow sur une branche autre que la branche par défaut du dépôt, utilisez l’indicateur `--ref`.

```shell
gh workflow run WORKFLOW --ref BRANCH
```

Pour afficher la progression de l’exécution du workflow, utilisez la sous-commande `run watch` et sélectionnez l’exécution dans la liste interactive.

```shell
gh run watch
```

</div>

## Exécution d’un workflow à l’aide de l’API REST

Lorsque vous utilisez l’API REST, vous configurez `inputs` et `ref` comme paramètres du corps de la demande. Si les entrées sont omises, les valeurs par défaut définies dans le fichier de workflow sont utilisées.

> \[!NOTE]
> Vous pouvez définir jusqu’à 10 `inputs` pour un `workflow_dispatch` événement.

Pour plus d’informations sur l’utilisation de l’API REST, consultez [Points de terminaison d’API REST pour les workflows](/fr/enterprise-server@3.22/rest/actions/workflows#create-a-workflow-dispatch-event).