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.
Présentation des exemples
Cet article utilise un exemple de workflow pour illustrer certaines des principales fonctionnalités CI de GitHub Actions. Quand ce workflow est déclenché, il teste votre code à l’aide d’une matrice de combinaisons de test avec npm test
.
Le diagramme suivant montre une vue générale des étapes du workflow et comment elles s’exécutent dans le travail :
Fonctionnalités utilisées dans cet exemple
L’exemple de workflow illustre les fonctionnalités suivantes de GitHub Actions.
Fonctionnalité | Implémentation |
---|---|
Exécution manuelle d’un workflow à partir de l’interface utilisateur | workflow_dispatch |
Exemple de flux de travail
Le workflow suivant a été créé par l’équipe Ingénierie de documents GitHub. Pour consulter la dernière version de ce fichier dans le référentiel github/docs
, consultez test.yml
.
Remarque : Chaque ligne de ce workflow est expliquée dans la section suivante, dans « Comprendre l’exemple ».
|
Vue d’ensemble de l’exemple
Le tableau suivant explique comment chacune de ces fonctionnalités est utilisée lors de la création d’un workflow GitHub Actions.
Code | Explication |
---|---|
|
Nom du workflow tel qu’il apparaît sous l’onglet « Actions » du dépôt GitHub. |
|
Le mot clé |
|
Ajoutez l’événement |
|
Ajoutez l’événement |
|
Ajoutez l’événement |
|
Modifie les autorisations par défaut octroyées à |
|
Crée un groupe d’accès concurrentiel pour des événements spécifiques, et utilise l’opérateur |
|
Annule tout travail ou workflow en cours d’exécution dans le même groupe d’accès concurrentiel. |
|
Regroupe tous les travaux qui s’exécutent dans le fichier de workflow. |
|
Définit un travail ayant l’ID |
|
Configure le travail pour qu’il s’exécute sur un exécuteur hébergé par GitHub ou sur un exécuteur autohébergé, selon le dépôt qui exécute le workflow. Dans cet exemple, le travail s’exécute sur un exécuteur autohébergé si le dépôt se nomme |
|
Définit le nombre maximal de minutes d’exécution du travail avant qu’il ne soit automatiquement annulé. Pour plus d’informations, consultez |
|
Cette section définit la matrice de build de vos travaux. |
|
L’affectation de la valeur |
|
Crée une matrice nommée |
|
Regroupe toutes les étapes qui vont s’exécuter dans le cadre du travail |
|
Le mot clé |
|
Si le dépôt actuel est le dépôt |
|
Si le dépôt actuel est le dépôt |
|
Si le dépôt actuel est le dépôt |
|
Cette étape exécute une commande pour extraire les objets LFS du dépôt. |
|
Cette étape utilise l’action |
|
Cette étape exécute une commande d’interpréteur de commandes qui utilise une sortie de l’étape précédente pour créer un fichier contenant la liste des fichiers changés dans la demande de tirage. |
|
Cette étape utilise l’action |
|
Cette étape exécute la commande d’interpréteur de commandes |
|
Cette étape utilise l’action |
|
Cette étape exécute le script de build. |
|
Cette étape exécute les tests à l’aide de |
Étapes suivantes
- Pour découvrir les concepts de GitHub Actions, consultez « 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. ».
- Pour un guide plus détaillé sur la création d’un workflow de base, consultez Démarrage rapide pour GitHub Actions.
- Si vous êtes à l’aise avec les bases de GitHub Actions, vous pouvez vous renseigner sur les workflows et leurs caractéristiques dans À propos des workflows.