Workflows

Get a high-level overview of GitHub Actions workflows, including triggers, syntax, and advanced features.

Dans cet article

About workflows

Un workflow est un processus automatisé configurable qui exécutera un ou plusieurs travaux. Les workflows sont définis par un fichier YAML archivé dans votre dépôt et s’exécutent lorsqu’ils sont déclenchés par un événement dans votre dépôt, ou ils peuvent être déclenchés manuellement ou selon une planification définie.

Les workflows sont définis dans l’annuaire .github/workflows d’un dépôt. Un référentiel peut comporter plusieurs workflows, chacun d’entre eux pouvant effectuer un ensemble de tâches différentes, telles que :

  • Construire et tester les demandes de tirage
  • Déployer votre application à chaque fois qu'une version est créée
  • Ajout d'une étiquette à chaque fois qu'un nouveau numéro est ouvert

Workflow basics

A workflow must contain the following basic components:

  1. One or more events that will trigger the workflow.
  2. One or more jobs, each of which will execute on a runner machine and run a series of one or more steps.
  3. Each step can either run a script that you define or run an action, which is a reusable extension that can simplify your workflow.

For more information on these basic components, see Understanding GitHub Actions.

Diagram of an event triggering Runner 1 to run Job 1, which triggers Runner 2 to run Job 2. Each of the jobs is broken into multiple steps.

Workflow triggers

Les déclencheurs de workflow sont des événements qui entraînent l’exécution d’un workflow. Ces événements peuvent être les suivants :

  • Événements qui se produisent dans le dépôt de votre workflow
  • Événements qui se produisent en dehors de GitHub et qui déclenchent un événement repository_dispatch sur GitHub
  • Heures planifiées
  • Manuel

Par exemple, vous pouvez configurer votre workflow pour qu’il s’exécute lorsqu’un push est effectué vers la branche par défaut de votre dépôt, lorsqu’une version est créée ou lorsqu’un problème est ouvert.

Les déclencheurs de workflow sont définis avec la clé on. Pour plus d’informations, consultez « Workflow syntax for GitHub Actions ».

Les étapes suivantes se produisent pour déclencher une exécution de workflow :

  1. Un événement se produit sur votre dépôt. Une référence Git et un SHA de commit sont associés à l’événement.
  2. GitHub recherche dans le .github/workflowsrépertoire à la racine de votre référentiel les fichiers de workflow présents dans le commit SHA ou Git ref associé à l'événement.
  3. Une exécution de workflow est déclenchée pour tous les workflows qui ont des valeurs on: correspondant à l’événement de déclenchement. Certains événements nécessitent également que le fichier de workflow soit présent sur la branche par défaut du dépôt pour qu’il s’exécute.

Chaque exécution de workflow utilise la version du workflow présente dans la référence Git ou le SHA de commit associés de l’événement. Lorsqu'un workflow s'exécute, GitHub définit les GITHUB_SHAvariables d'environnement (commit SHA) et GITHUB_REF(Git ref) dans l'environnement du exécuteur. Pour plus d’informations, consultez « Stocker des informations dans des variables ».

For more information, see Déclenchement d’un workflow.

Next steps

To build your first workflow, see Creating an example workflow.