Créer son premier pipeline CI/CD avec GitHub Actions

🎯 Objectifs

À la fin de ce module, vous serez capable de :

• ✅ Comprendre les concepts CI/CD et leur importance
• ✅ Créer un workflow GitHub Actions from scratch
• ✅ Automatiser les tests sur chaque push
• ✅ Utiliser des actions du Marketplace
• ✅ Intégrer Docker dans un pipeline CI

📋 Prérequis

📖 Pourquoi CI/CD ?

Le problème sans CI/CD

Sans automatisation, chaque livraison ressemble à ça :

1. Un développeur pousse du code
2. Quelqu'un lance les tests manuellement
3. Quelqu'un build l'application manuellement
4. Quelqu'un déploie manuellement

Résultat : c'est lent, sujet aux erreurs, et personne ne veut le faire.

La solution : CI/CD

Les bénéfices

• 🚀 Feedback rapide - erreurs détectées en minutes, pas en jours
• 🛡️ Qualité du code - chaque changement est testé
• 📦 Déploiement fiable - même processus à chaque fois
• 🤝 Collaboration fluide - les PR sont validées automatiquement

🔄 Le Pipeline CI/CD

Un pipeline est une série d'étapes automatisées :

Code → Build → Test → Deploy
 ↑       ↓       ↓       ↓
Push   Compile  Vérifie  Met en
       le code  la qualité production

💡 Si une étape échoue, le pipeline s'arrête et vous êtes notifié.

🔧 Outils CI/CD

💡 Nous utilisons GitHub Actions - gratuit, intégré à GitHub, et très populaire.

🏗️ GitHub Actions - Concepts

Chaque concept s'emboîte comme des poupées russes :

Workflow (.yml)
 └── Event (push)
      └── Job (test)
           ├── Step 1 (checkout)
           ├── Step 2 (setup node)
           └── Step 3 (npm test)

🚀 Premier Workflow

Créez le fichier .github/workflows/ci.yml :

name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm ci
      - run: npm test

Explication ligne par ligne

💡 npm ci est préféré à npm install en CI - plus rapide et déterministe.

🧩 Actions du Marketplace

Les actions sont des blocs réutilisables créés par la communauté.

Actions les plus utilisées

Utilisation :

- uses: actions/setup-python@v5
  with:
    python-version: '3.12'

💡 Toujours épingler la version avec @v4 pour éviter les surprises.

⚡ Déclencher un Workflow

Événements disponibles

Filtres par branche et chemin

on:
  push:
    branches: [main, develop]
    paths:
      - 'src/**'
      - '!docs/**'

💡 Le filtre paths évite de lancer le pipeline pour des changements qui ne touchent pas le code.

🐳 Workflow avec Docker

Combinez CI et Docker pour tester dans un conteneur :

jobs:
  docker-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build image
        run: docker build -t myapp:${{ github.sha }} .
      - name: Run tests
        run: docker run myapp:${{ github.sha }} npm test

${{ github.sha }} utilise le hash du commit comme tag - chaque build est unique.

👀 Voir les Résultats

1. Allez dans l'onglet Actions de votre dépôt GitHub
2. Cliquez sur le workflow exécuté
3. Vérifiez le statut :

• ✅ Vert - tous les jobs ont réussi
• ❌ Rouge - au moins un job a échoué

1. Cliquez sur un job pour voir les logs détaillés

⚠️ Lisez toujours les logs en cas d'échec - le message d'erreur est souvent explicite.

❌ Erreurs Courantes

📌 Points Clés

• 🔄 CI = build + test automatiques à chaque push
• 📦 CD = déploiement automatique après validation
• 📝 Les workflows sont des fichiers YAML dans .github/workflows/
• 🧩 Les actions sont des blocs réutilisables du Marketplace
• 🐳 Docker s'intègre facilement dans un pipeline CI

📚 Ressources

• Documentation GitHub Actions
• Marketplace GitHub Actions
• Syntaxe des workflows
• Événements déclencheurs

🚀 Prochaines étapes

Vous avez créé vos premiers workflows CI/CD. Allez plus loin :

1. GitHub Actions : multi-jobs, artefacts et workflows réutilisables - Pipelines multi-jobs, artefacts, cache et workflows réutilisables