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:
- One or more events that will trigger the workflow.
- One or more jobs, each of which will execute on a runner machine and run a series of one or more steps.
- 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.
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 :
- 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.
- GitHub recherche dans le
.github/workflows
ré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. - 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_SHA
variables 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.