PARTIE 1 : Les bases de GitHub Actions

CHAPITRE 1 : LES BASES

_1.1 Actions GitHub
__1.1.1 Plateforme d'automatisation
__1.1.2 Cadre
_1.2 Cas d'utilisation de GitHub Actions
__1.2.1 Flux de travail de démarrage
__1.2.2 Place de marché Action
1.3 Frais d'utilisation
__1.3.1 Modèle gratuit
__1.3.2 Modèle payant
_1.4 Liste de vérification pour la migration de GitHub Actions
__1.4.1 Utilisation de GitHub
1.4.2 Action publique
1.4.3 Actions auto-initiées
1.4.4 Gestion des artefacts
__1.4.5 Gestion des actions
_1.5 Conclusion

CHAPITRE 2 Comment fonctionnent les actions

2.1 Aperçu
_2.2 Déclencheur de flux de travail
_2.3 Composants
Étape 2.3.1
__2.3.2 Coureur
__2.3.3 Emploi
__2.3.4 Flux de travail
2.4 Exécution du flux de travail
_2.5 Conclusion

CHAPITRE 3 MISE EN ŒUVRE DU TRAVAIL

3.1 Structure d'action
3.2 Interaction avec les actions
3.3 Comment utiliser les actions
3.4 Actions publiques et marché
3.5 Conclusion

CHAPITRE 4 : UTILISATION DES FLUX DE TRAVAIL

4.1 Création d'un flux de travail à partir d'un dépôt
_4.2 Validation du flux de travail
4.3 Utilisation de l'extension GitHub Actions pour VS Code
4.4 Conclusion

CHAPITRE 5 Le coureur

_5.1 GitHub Hosting Runner
__5.1.1 Logiciel de support dans l'image du coureur
5.1.2 Ajout de logiciels au Runner
_5.2 Exécuteur auto-hébergé
5.2.1 Exigences relatives à un système de course auto-hébergé
__5.2.2 Limites des coureurs auto-hébergés
5.2.3 Considérations relatives à la sécurité des runners auto-hébergés
5.2.4 Configuration d'un runner auto-hébergé
5.2.5 Utilisation d'un Runner auto-hébergé
__5.2.6 Utilisation de serveurs et d'étiquettes auto-hébergés
__5.2.7 Dépannage du Runner auto-hébergé
__5.2.8 Suppression du runner auto-hébergé
_5.3 Mise à l'échelle automatique du Runner auto-hébergé
_5.4 Juste à temps Runner
5.5 Conclusion

PARTIE 2 Composants de GitHub Actions

CHAPITRE 6 GÉRER L'ENVIRONNEMENT DE TRAVAIL

6.1 Nom du flux de travail et nom d'exécution du flux de travail
_6.2 Context
_6.3 Variables d'environnement
6.3.1 Variables d'environnement de base
_6.4 Variables secrètes et de configuration
6.5 Gestion des permissions des flux de travail
6.6 Environnement de déploiement
6.7 Conclusion

CHAPITRE 7 GESTION DES DONNÉES DANS LES FLUX DE TRAVAIL

_7.1 Utilisation des entrées/sorties dans les flux de travail
7.1.1 Définition et référencement des entrées d'un flux de travail
Vérifiez le résultat à l'étape 7.1.2
7.1.3 Vérification du résultat de la tâche
Résultat des actions capturées à l'étape __7.1.4
_7.2 Définition d'artefact
_7.3 Téléchargement et chargement d'artefacts
7.3.1 Ajouter un paramètre
_7.4 Utilisation du cache dans GitHub Actions
7.4.1 Utilisation d'actions de cache explicites
7.4.2 Surveillance du cache
__7.4.3 Activation de la mise en cache dans les paramètres
_7.5 Conclusion

CHAPITRE 8 GESTION DES FLUX DE TRAVAIL POUR LES CADRES SUPÉRIEURS

_8.1 Déclencheurs de changement avancés
8.1.1 Déclencheurs par type d'activité
8.1.2 Spécification des déclencheurs à l'aide de filtres
_8.2 Déclencheur de flux de travail sans modifications
8.3 Gestion de la concurrence
8.4 Exécution d'un flux de travail avec une matrice
8.5 Fonctions spécifiques au flux de travail
8.5.1 Fonctions conditionnelles et d'état
8.6 Conclusion

PARTIE 3 Sécurité et surveillance

CHAPITRE 9 ACTION ET SÉCURITÉ

9.1 Sécurité via les paramètres
__9.1.1 Gestion de l'exécution du flux de travail dans les demandes d'extraction
__9.1.2 Octroi des autorisations de flux de travail
Fichier 9.1.3 CODEOWNERS
__9.1.4 Balises protégées
__9.1.5 Branches protégées
__9.1.6 Règles du dépôt
9.2 Sécurité dès la conception
__9.2.1 Variables secrètes
__9.2.2 Protection des variables secrètes
__9.2.3 Jeton
9.2.4 Gestion des entrées non fiables
9.2.5 Sécurité des dépendances
9.3 Sécurité par la surveillance
__9.3.1 Analyse
__9.3.2 Traitement sécurisé des demandes d'extraction
__9.3.3 Vulnérabilité dans le flux de travail au sein des demandes d'extraction
9.3.4 Vulnérabilités dans le code source des demandes de fusion
__9.3.5 Ajouter un script de validation de requête d'extraction
__9.3.6 Traitement sécurisé des demandes d'extraction
_9.4 Conclusion

CHAPITRE 10 SURVEILLANCE, ENREGISTREMENT ET DÉBOGAGE

_10.1 Améliorations de la visibilité
10.1.1 Comprendre l'État à un niveau élevé
__10.1.2 Badges d'état pour les flux de travail
_10.2 Opérations d'état antérieures à la version
__10.2.1 Associer la version du flux de travail à l'exécution
10.2.2 Réexécution d'une tâche dans un flux de travail
_10.3 Débogage du flux de travail
__10.3.1 Journalisation de débogage étape par étape
__10.3.2 Débogage de l'environnement d'exécution
__10.3.3 Activer le débogage
_10.4 Extensions et personnalisation de la journalisation
__10.4.1 Ajoutez votre propre message au journal
__10.4.2 Personnalisation supplémentaire des journaux
__10.4.3 Résumé de la tâche personnalisée
_10.5 Conclusion

PARTIE 4 : Sujets avancés

CHAPITRE 11 ACTIONS PERSONNALISÉES

_11.1 Anatomie de la structure de l'action
_11.2 Types d'actions
__11.2.1 Actions composées
__11.2.2 Actions du conteneur Docker
__11.2.3 Actions JavaScript
_11.3 Finalisation de la création de l'action
_11.4 Publication d'actions sur la Marketplace GitHub
__11.4.1 Mises à jour des actions sur la Place de marché
11.4.2 Suppression d'actions de la Place de marché
_11.5 Boîte à outils d'action
__11.5.1 Utilisation des commandes de flux de travail dans la boîte à outils
_11.6 Action locale
_11.7 Conclusion

CHAPITRE 12 FLUX DE TRAVAIL AVANCÉ

_12.1 Mon flux de travail de démarrage
__12.1.1 Zone de flux de travail de démarrage
__12.1.2 Fichier de flux de travail de démarrage
__12.1.3 Ajout de pièces auxiliaires
__12.1.4 Utilisation du nouveau flux de travail de démarrage
_12.2 Flux de travail réutilisables
__12.2.1 Variables d'entrée et variables secrètes
__12.2.2 Sortie
__12.2.3 Limitations
_12.3 Flux de travail requis
__12.3.1 Contraintes
__12.3.2 Exemple
__12.3.3 Exécution
_12.4 Conclusion

CHAPITRE 13 TECHNIQUES AVANCÉES DE FLUX DE TRAVAIL

_13.1 Utiliser GitHub dans votre flux de travail
__13.1.1 Utilisation de l'interface de ligne de commande GitHub
__13.1.2 Script
__13.1.3 Appels à l'API GitHub
_13.2 Création automatique de tâches à l'aide de matrices
13.2.1 Matrice unidimensionnelle
13.2.2 Matrice multidimensionnelle
__13.2.3 Inclure des valeurs supplémentaires
__13.2.4 Valeurs exclues
__13.2.5 Gestion des cas de défaillance
__13.2.6 Définition de la concurrence maximale des tâches
_13.3 Utilisation des conteneurs dans les flux de travail
13.3.1 Utilisation des conteneurs comme environnements d'exécution de tâches
13.3.2 Utilisation de conteneurs au niveau de l'escalier
__13.3.3 Exécution d'un conteneur en tant que service dans une tâche
_13.4 Conclusion

CHAPITRE 14 Migration vers GitHub Actions

_14.1 Préparation
__14.1.1 Code source
14.1.2 Automatisation
14.1.3 Infrastructure
__14.1.4 Utilisateur
_14.2 Pipeline Azure
_14.3 CircleCI
_14.4 GitLab CI/CD
_14.5 Jenkins
_14.6 Travis CI
_14.7 Importateur d'actions GitHub
__14.7.1 Authentification
Plan __14.7.2
__14.7.3 Étapes de construction – Questions connexes
__14.7.4 Liste de tâches manuelles
Manifeste de fichier __14.7.5
Prédiction du 14.7.6
14.7.7 Réalisation d'un essai à blanc
__14.7.8 Transformateur sur mesure pour importateur
__14.7.9 Migration réelle
_14.8 Conclusion
Recherche

Le point de départ de l'automatisation de projet,
Actions GitHub

GitHub Actions est une plateforme d'intégration continue et de livraison continue (CI/CD) qui vous permet d'automatiser vos pipelines de construction, de test et de déploiement.
Les développeurs qui utilisent GitHub de manière intensive peuvent mettre en œuvre l'automatisation à l'aide de GitHub Actions sans utiliser d'autres applications.
Ce livre aborde tous les sujets, des méthodes d'automatisation de base à la sécurité en passant par les sujets avancés.

Partie 1.
Principes de base de GitHub Actions

Nous présentons la définition et le fonctionnement de base de GitHub Actions, les éléments clés du framework et le flux global.
Il pose des bases solides que même les lecteurs novices en matière de GitHub Actions peuvent utiliser sans difficulté.


Partie 2.
Composants de GitHub Actions

Approfondissez vos connaissances sur Actions en découvrant les différents composants nécessaires pour configurer, partager et stocker des données, déclencher et contrôler l'exécution des flux de travail dans GitHub Actions.

Partie 3.
Sécurité et surveillance

Nous examinons la sécurité requise pour l'utilisation de GitHub Actions selon trois perspectives : configuration, conception et surveillance.
Nous allons examiner de plus près le système de surveillance lui-même, en expliquant les différentes options utilisées pour la journalisation et les techniques employées pour déboguer les problèmes.


Partie 4.
Sujets avancés

Cet article aborde divers sujets que vous pourriez vouloir connaître lors de l'utilisation de GitHub Actions, notamment la création d'actions personnalisées, la création de workflows de base et réutilisables, l'utilisation de l'interface de ligne de commande et de l'API GitHub, ainsi que l'utilisation de stratégies matricielles et de conteneurs dans vos workflows.
De plus, le dernier chapitre explique comment migrer d'autres outils d'automatisation vers GitHub Actions.

Public cible

● Si vous débutez sur GitHub et souhaitez savoir comment fonctionne l'automatisation
● Toute personne souhaitant obtenir de l'aide pour implémenter le code et la syntaxe qui constituent concrètement un flux de travail avec GitHub Actions
● Ceux qui souhaitent comprendre et évaluer l'introduction de GitHub Actions pour l'intégration continue/la livraison continue et l'automatisation.
● Ceux qui souhaitent migrer leur solution CI/CD actuelle vers GitHub Actions

Ce que vous apprenez

● Écriture d'actions personnalisées à l'aide de Docker, JavaScript et du shell
● Comment dépanner et résoudre les problèmes qui surviennent dans le flux de travail
● Comment implémenter des workflows en toute sécurité avec GitHub Actions
Comment migrer d'autres plateformes CI/CD vers GitHub Actions ?

Note de l'auteur

Les actions GitHub sont difficiles à définir ou à catégoriser en dehors de GitHub lui-même.
Il serait plus exact de dire qu'il s'agit d'une extension logique du modèle GitHub.
Ce livre n'est pas un guide des principes de GitHub, mais il tente d'expliquer comment les actions GitHub fonctionnent ensemble dans l'ensemble de l'écosystème GitHub d'une manière facile à comprendre, quel que soit votre niveau d'expérience en matière d'automatisation avec GitHub.

Brent Lasseter