Understanding GitHub Actions

GitHub Actions dépasse DevOps simplement et vous permet d’exécuter des workflows lorsque d’autres événements se produisent dans votre dépôt.

Par exemple, vous pouvez exécuter un workflow pour ajouter automatiquement les étiquettes appropriées chaque fois que quelqu’un crée un problème dans votre dépôt.

GitHub fournit des machines virtuelles Linux, Windows et macOS pour exécuter vos workflows, ou vous pouvez héberger vos propres exécuteurs auto-hébergés dans votre propre centre de données ou infrastructure cloud.

Composants de GitHub Actions

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.

Vue d’ensemble du 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 le répertoire .github/workflows d’un référentiel, et un référentiel peut avoir plusieurs workflows, chacun pouvant effectuer un ensemble différent de tâches. Par exemple, vous pouvez avoir un workflow pour générer et tester des demandes de tirage, un autre workflow pour déployer votre application chaque fois qu’une version est créée, et encore un autre workflow qui ajoute une étiquette chaque fois que quelqu’un ouvre un nouveau problème.

Vous pouvez référencer un workflow dans un autre workflow.

Pour plus d’informations, consultez « Réutilisation des workflows ».

Pour plus d’informations sur les workflows, consultez « Utilisation de flux de travail ».

É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. travaux 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 entre eux. Lorsqu’un travail prend une dépendance sur un autre travail, il attend que le travail dépendant se termine avant de pouvoir s’exécuter. Par exemple, vous pouvez avoir plusieurs travaux de génération pour différentes architectures qui n’ont pas de dépendances, et un travail d’empaquetage dépendant de ces travaux.

Les travaux de génération s’exécutent en parallèle et le travail d’empaquetage s’exécutera quand ils auront fini de s’exécuter. Pour plus d’informations sur les travaux, consultez « Utilisation des travaux ». 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 plus d’informations, consultez « Création d’actions ».

Exécuteurs

Un exécuteur est un serveur qui exécute vos workflows quand ils sont déclenchés. Chaque exécuteur peut exécuter un seul travail à la fois.

GitHub fournit les exécuteurs Ubuntu Linux, Microsoft Windows et macOS pour exécuter vos workflows. Chaque exécution de workflow s’exécute sur une machine virtuelle nouvellement provisionné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 système d’exploitation différent ou d’une configuration matérielle spécifique, vous pouvez héberger vos propres exécuteurs. Pour plus d’informations sur les exécuteurs auto-hébergés, consultez « Hébergement de vos propres exécuteurs ». ## Créer un exemple de workflow

GitHub Actions utilise la syntaxe YAML pour définir le workflow. Chaque workflow est stocké en tant que fichier YAML distinct dans votre référentiel de code, dans un répertoire appelé .github/workflows.

Vous pouvez créer un exemple de workflow dans votre dépôt qui déclenche automatiquement une série de commandes chaque fois que du code est poussé (push). Dans ce workflow, GitHub Actions extrait le code envoyé, installe le framework de test bats et exécute une commande de base pour générer la version de bats : bats -v.

Dans votre dépôt, créez le répertoire .github/workflows/ pour stocker vos fichiers de workflow.

Dans le répertoire .github/workflows/, créez un nouveau fichier appelé learn-github-actions.yml et ajoutez le code suivant.

YAML

name: learn-github-actions
run-name: ${{ github.actor }} is learning GitHub Actions
on: [push]
jobs:
  check-bats-version:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

Validez ces modifications et poussez-les vers votre dépôt GitHub.

Votre nouveau fichier de workflow GitHub Actions est maintenant installé dans votre dépôt et s’exécute automatiquement chaque fois que quelqu’un pousse (push) une modification vers le dépôt. Pour afficher les détails sur l’historique d’exécution d’un workflow, consultez « Affichage de l’activité pour une exécution de workflow ».

Présentation du fichier de workflow

Pour vous aider à comprendre comment la syntaxe YAML est utilisée pour créer un fichier de workflow, cette section explique chaque ligne de l’exemple d’introduction :

`name: learn-github-actions`	Facultatif - Nom du workflow tel qu’il apparaît sous l’onglet Actions du référentiel GitHub.
`run-name: ${{ github.actor }} is learning GitHub Actions`	Facultatif : nom des exécutions de workflow générées à partir du workflow, qui s’affiche dans la liste des exécutions de workflow sous l’onglet « Actions » de votre référentiel. Cet exemple utilise une expression avec le contexte `github` pour afficher le nom d’utilisateur de l’acteur qui a déclenché l’exécution du workflow. Pour plus d’informations, consultez « Workflow syntax for GitHub Actions ».
`on: [push]`	Spécifie le déclencheur de ce workflow. Cet exemple utilise l’événement `push`, de sorte qu’une exécution de workflow est déclenchée chaque fois que quelqu’un pousse (push) une modification vers le référentiel ou fusionne une demande de tirage (pull request). Elle est déclenchée par un push vers chaque branche. Pour obtenir des exemples de syntaxe qui s’exécutent uniquement sur des push vers des branches, des chemins ou des étiquettes spécifiques, consultez « Syntaxe de workflow pour GitHub Actions ».
`jobs:`	Regroupe tous les travaux qui s’exécutent dans le workflow `learn-github-actions`.
`check-bats-version:`	Définit un travail nommé `check-bats-version`. Les clés enfants définissent les propriétés du travail.
`runs-on: ubuntu-latest`	Configure le travail à exécuter sur la dernière version d’un exécuteur Ubuntu Linux. Cela signifie que le travail s’exécutera sur une nouvelle machine virtuelle hébergée par GitHub. Pour obtenir des exemples de syntaxe utilisant d’autres exécuteurs, consultez « Syntaxe de workflow pour GitHub Actions ».
`steps:`	Regroupe toutes les étapes qui s’exécutent dans le travail `check-bats-version`. Chaque élément imbriqué sous cette section est une action ou un script d’interpréteur de commandes distinct.
`- uses: actions/checkout@v3`	Le mot clé `uses` spécifie que cette étape exécute la version `v3` de l’action `actions/checkout`. Il s’agit d’une action qui extrait votre dépôt sur l’exécuteur, ce qui vous permet d’exécuter des scripts ou d’autres actions sur votre code (telles que des outils de génération et de test). Vous devez utiliser l’action d’extraction chaque fois que votre workflow s’exécutera sur le code du dépôt.
`- uses: actions/setup-node@v3 with: node-version: '14'`	Cette étape utilise l’action `actions/setup-node@v3` pour installer la version spécifiée de Node.js (cet exemple utilise v14). Cela place les deux commandes `node` et `npm` dans votre `PATH`.
`- run: npm install -g bats`	Le mot clé `run` indique au travail d’exécuter une commande sur l’exécuteur. Dans ce cas, vous utilisez `npm` pour installer le package de test logiciel `bats`.
`- run: bats -v`	Enfin, vous allez exécuter la commande `bats` avec un paramètre qui génère la version logicielle.

Visualisation du fichier de workflow

Dans ce diagramme, vous pouvez voir le fichier de workflow que vous venez de créer et comment les composants GitHub Actions sont organisés dans une hiérarchie. Chaque étape exécute une action ou un script d’interpréteur de commandes unique. Les étapes 1 et 2 exécutent des actions, tandis que les étapes 3 et 4 exécutent des scripts d’interpréteur de commandes. Pour trouver d’autres actions prédéfinies pour vos workflows, consultez « Recherche et personnalisation d’actions ».

Vue d’ensemble du workflow

Affichage de l’activité pour une exécution de workflow

Lorsque votre workflow est déclenché, une exécution de workflow est créée et exécute le workflow. Une fois l’exécution de votre workflow démarrée, vous pouvez voir un graphe de visualisation de la progression de l’exécution, ainsi que l’activité de chaque étape sur GitHub.

Dans GitHub.com, accédez à la page principale du dépôt.
Sous le nom de votre dépôt, cliquez sur Actions.
Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher.
Sous « Exécutions de workflow », cliquez sur le nom de l’exécution que vous souhaitez afficher.
Sous Travaux ou dans le graphe de visualisation, cliquez sur le travail que vous souhaitez afficher.
Affichez les résultats de chaque étape.

Étapes suivantes GitHub Actions peut vous aider à automatiser presque tous les aspects de vos processus de développement d’applications. Vous êtes prêt à commencer ? Voici quelques ressources utiles pour effectuer vos étapes suivantes avec GitHub Actions :

Pour obtenir des workflows d’intégration continue (CI) permettant de générer et tester votre code, consultez « Automatisation des builds et des tests ».
Pour générer et publier des packages, consultez « Publication de packages ».
Pour le déploiement de projets, consultez « Déploiement ».
Pour automatiser les tâches et les processus sur GitHub, consultez « Gestion des problèmes et demandes de tirage ».
Pour obtenir des exemples illustrant les fonctionnalités plus complexes de GitHub Actions, dont beaucoup des cas d’usage ci-dessus, consultez « Exemples ». Vous pouvez voir des exemples détaillés qui expliquent comment tester votre code sur un exécuteur, accéder à l’interface CLI GitHub et utiliser des fonctionnalités avancées telles que les matrices de test et de concurrence.

Contacter le support

Si vous avez besoin d’aide concernant la configuration d’un workflow, notamment la syntaxe, les exécuteurs hébergés GitHub ou les actions de génération, recherchez les sujets existants ou démarrez-en un nouveau dans la catégorie GitHub Community GitHub Actions et GitHub Packages.

Si vous voulez émettre des commentaires ou demander des fonctionnalités GitHub Actions, partagez-les dans les Discussions de la communauté GitHub pour GitHub Actions.

Contactez le le support GitHub pour tous les cas suivants, que votre utilisation ou votre utilisation prévue s’inscrivent ou non dans les catégories des limites d’utilisation :

Si vous pensez que votre compte a été limité de manière incorrecte
Si vous rencontrez une erreur inattendue lors de l’exécution de l’une de vos actions
Si vous êtes dans une situation où le comportement existant n’est pas conforme au comportement attendu, qui n’est pas toujours décrit