Vous pouvez configurer un workflow GitHub Actions à déclencher quand un événement se produit dans votre dépôt, par exemple l’ouverture d’une demande de tirage (pull request) ou la création d’un problème. Votre workflow contient un ou plusieurs travaux qui peuvent s’exécuter dans un ordre séquentiel ou en parallèle. Chaque travail s’exécute au sein de son propre exécuteur de machine virtuelle, ou au sein d’un conteneur, et comporte une ou plusieurs étapes qui exécutent un script que vous définissez ou une action, qui est une extension réutilisable qui peut simplifier votre workflow.
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
Vous pouvez référencer un workflow dans un autre workflow. Pour plus d’informations, consultez « Réutiliser des workflows ».
Pour plus d’informations, consultez « Écriture de workflows ».
Événements
Un événement est une activité spécifique dans un dépôt qui déclenche l’exécution d’un workflow. Par exemple, l’activité peut provenir de GitHub quand quelqu’un crée une demande de tirage (pull request), ouvre un problème ou pousse (push) un commit vers un dépôt. Vous pouvez également déclencher une exécution de workflow selon une planification, en publiant dans une API REST ou manuellement.
Pour obtenir la liste complète des événements qui peuvent être utilisés pour déclencher des workflows, consultez Événements déclencheurs de workflows.
Jobs
Un travail est un ensemble d’**étapes **dans un workflow qui s’exécute sur le même exécuteur. Chaque étape est un script d’interpréteur de commandes qui sera exécuté ou une action qui sera exécutée. Les étapes sont exécutées dans l’ordre et dépendent les unes des autres. Comme chaque étape est exécutée sur le même exécuteur, vous pouvez partager des données d’une étape à une autre. Par exemple, vous pouvez avoir une étape qui génère votre application suivie d’une étape qui teste l’application générée.
Vous pouvez configurer les dépendances d’un travail avec d’autres travaux. Par défaut, les travaux n’ont aucune dépendance et s’exécutent en parallèle. Lorsqu’un travail prend une dépendance sur un autre travail, il attend que le travail dépendant se termine avant de s’exécuter.
Par exemple, vous pouvez configurer plusieurs travaux de build pour différentes architectures sans aucune dépendance de travail et un travail de création de package qui dépend de ces builds. Les travaux de build s’exécutent en parallèle. Une fois achevés, le travail de création de package s’exécutera.
Pour plus d’informations, consultez « Choix de ce que fait votre workflow ».
Actions
Une action est une application personnalisée pour la plateforme GitHub Actions qui effectue une tâche complexe mais fréquemment répétée. Utilisez une action pour réduire la quantité de code répétitif que vous écrivez dans vos fichiers de workflow. Une action peut tirer (pull) votre dépôt Git à partir de GitHub, configurer la chaîne d’outils appropriée pour votre environnement de build ou configurer l’authentification auprès de votre fournisseur de cloud.
Vous pouvez écrire vos propres actions ou trouver des actions à utiliser dans vos workflows dans le GitHub Marketplace.
Pour partager des actions au sein de votre entreprise sans les publier publiquement, vous pouvez les stocker dans un référentiel interne, puis configurer celui-ci pour autoriser l’accès aux workflows GitHub Actions dans d’autres référentiels appartenant à la même organisation ou à toute autre organisation de l’entreprise. Pour plus d’informations, consultez « Partage d’actions et de workflows au sein de votre entreprise ».
Pour plus d’informations sur les actions, consultez Réutilisation des automatisations.
Exécuteurs
Un exécuteur est un serveur qui exécute vos workflows quand ils sont déclenchés. Chaque exécuteur ne peut exécuter qu’un seul travail à la fois. GitHub fournit des exécuteurs Ubuntu Linux, Microsoft Windows et macOS pour exécuter vos workflows. Chaque exécution de workflow est effectuée dans une machine virtuelle nouvellement approvisionnée.
GitHub propose également des exécuteur plus grand, qui sont disponibles dans des configurations plus grandes. Pour plus d’informations, consultez « Utilisation des exécuteurs plus grands ».
Si vous avez besoin d’un autre système d’exploitation, ou si vous avez besoin d’une configuration matérielle spécifique, vous pouvez héberger vos propres exécuteurs.
Pour plus d’informations sur les exécuteurs autohébergés, consultez Gestion des exécuteurs auto-hébergés.
Étapes suivantes
Découvrez ensuite comment planifier le lancement de GitHub Actions dans votre entreprise. Consultez Planification d’un déploiement de GitHub Actions.