Skip to main content

Exécution manuelle d’un workflow

Quand un workflow est configuré pour s’exécuter sur l’événement workflow_dispatch, vous pouvez l’exécuter via l’onglet Actions de GitHub, GitHub CLI, ou l’API REST.

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.

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

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

Exécution d’un workflow

  1. Dans , accédez à la page principale du dépôt. 1. Sous le nom de votre référentiel, cliquez sur Actions. Onglet Actions dans le volet de navigation du dépôt principal

  2. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez exécuter.

    Actions - Sélectionner un workflow

  3. Au-dessus de la liste des exécutions de workflows, sélectionnez Exécuter le workflow. actions – distribution de workflow

  4. Utilisez la liste déroulante Branche pour sélectionner la branche du workflow et tapez les paramètres d’entrée. Cliquez sur Exécuter le workflow. actions – exécuter manuellement un workflow

Pour en savoir plus sur GitHub CLI, consultez « À propos de 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 workflow, GitHub CLI retourne un menu interactif pour vous permettre de choisir un workflow.

gh workflow run WORKFLOW

Si votre workflow accepte les entrées, GitHub CLI vous invite à 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.

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.

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.

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.

gh run watch

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.

Remarque : Vous pouvez définir jusqu’à 10 inputs pour un événement workflow_dispatch.

Pour plus d’informations sur l’utilisation de l’API REST, consultez « Créer un événement de distribution de workflow ».