Introduction
Vous en avez assez de déployer manuellement votre code ? Vous passez des heures à tester, puis re-tester avant chaque mise en production ? Vous avez peur de casser quelque chose à chaque déploiement ?
Le CI/CD est la solution !
Dans ce guide, je vais vous expliquer concrètement comment mettre en place GitLab CI/CD pour automatiser vos déploiements, même si vous n’avez jamais fait de DevOps de votre vie.
Ce que vous allez apprendre :
- Qu’est-ce que le CI/CD et pourquoi c’est essentiel
- Comment configurer votre premier pipeline GitLab
- Déployer automatiquement sur Vercel/Netlify
- Les bonnes pratiques pour éviter les erreurs
Qu’est-ce que le CI/CD ?
Les Bases
CI (Continuous Integration) = Intégration Continue
- Fusionner le code fréquemment (plusieurs fois par jour)
- Tester automatiquement chaque modification
- Détecter les bugs rapidement
CD (Continuous Deployment) = Déploiement Continu
- Déployer automatiquement en production
- Sans intervention manuelle
- Après validation des tests
Avant vs Après CI/CD
❌ Avant (Déploiement Manuel)
1. Vous codez pendant 2 semaines
2. Vous testez manuellement (30 minutes)
3. Vous vous connectez au serveur SSH
4. Vous lancez des commandes compliquées
5. Quelque chose casse
6. Vous stressez pendant 1 heure
7. Vous réparez (ou rollback)
8. Total : 2-3 heures + stress
Problèmes :
- 😰 Stress énorme
- ⏰ Temps perdu
- 🐛 Bugs en production
- 🔄 Processus non reproductible
✅ Après (CI/CD)
1. Vous codez
2. Vous poussez sur Git (git push)
3. Pipeline automatique :
├─ Installe les dépendances
├─ Lance les tests
├─ Build l'application
└─ Déploie en production
4. Site en ligne automatiquement
5. Total : 2-3 minutes + zéro stress
Avantages :
- 😎 Zéro stress
- ⚡ Déploiement en 2-3 minutes
- 🛡️ Tests automatiques
- 🔄 Reproductible à 100%
Pourquoi GitLab CI/CD ?
GitLab vs Alternatives
| Critère | GitLab CI/CD | GitHub Actions | Jenkins |
|---|---|---|---|
| Prix | 💰 Gratuit (2000 min/mois) | 💰 Gratuit (2000 min/mois) | 💰 Gratuit |
| Configuration | 🟢 Facile | 🟢 Facile | 🔴 Complexe |
| Intégration Git | ✅ Native | ✅ Native | ⚠️ Externe |
| Documentation | 📚 Excellente | 📚 Excellente | 📚 Moyenne |
| Courbe d’apprentissage | 🟢 Douce | 🟢 Douce | 🔴 Abrupte |
| Runners privés | ✅ Oui | ✅ Oui | ✅ Oui |
Mon avis : GitLab CI/CD est le meilleur choix pour débuter. Interface claire, documentation excellente, et tout est intégré.
Votre Premier Pipeline GitLab
Étape 1 : Créer le Fichier .gitlab-ci.yml
Ce fichier se place à la racine de votre projet et définit votre pipeline.
yaml
# .gitlab-ci.yml
# Pipeline simple pour un projet Node.js
stages:
- build
- test
- deploy
# Job 1 : Installation et Build
build-app:
stage: build
image: node:18-alpine
script:
- echo "📦 Installation des dépendances..."
- npm ci
- echo "🏗️ Build de l'application..."
- npm run build
artifacts:
paths:
- build/
expire_in: 1 hour
# Job 2 : Tests automatiques
test-app:
stage: test
image: node:18-alpine
script:
- npm ci
- echo "🧪 Lancement des tests..."
- npm run test
coverage: '/All files[^|]*\|[^|]*\s+([\d\.]+)/'
# Job 3 : Déploiement en production
deploy-production:
stage: deploy
image: node:18-alpine
before_script:
- npm install -g vercel
script:
- echo "🚀 Déploiement sur Vercel..."
- vercel --prod --token=$VERCEL_TOKEN --yes
environment:
name: production
url: https://mon-site.com
only:
- main # Seulement sur la branche main
Explication Ligne par Ligne
Stages (Étapes)
yaml
stages:
- build # Étape 1 : Compilation
- test # Étape 2 : Tests
- deploy # Étape 3 : Déploiement
Les jobs s’exécutent dans cet ordre.
Job de Build
yaml
build-app:
stage: build # Dans quelle étape ?
image: node:18-alpine # Image Docker à utiliser
script: # Commandes à exécuter
- npm ci # Installer dépendances
- npm run build # Compiler l'app
artifacts: # Fichiers à garder
paths:
- build/ # Dossier de build
Job de Test
yaml
test-app:
stage: test
script:
- npm run test # Lancer Jest, Mocha, etc.
coverage: '/.../' # Regex pour extraire le coverage
Job de Déploiement
yaml
deploy-production:
stage: deploy
script:
- vercel --prod # Déployer sur Vercel
only:
- main # Seulement sur branche main
Configuration des Variables Secrètes
Étape 1 : Obtenir Votre Token Vercel
- Allez sur vercel.com/account/tokens
- Cliquez sur Create Token
- Nom : « GitLab CI »
- Scope : Full Account
- Copiez le token généré (vous ne le reverrez plus !)
Étape 2 : Ajouter dans GitLab
- Dans votre projet GitLab → Settings → CI/CD
- Expandre Variables
- Cliquez Add Variable
- Configurez :
Key: VERCEL_TOKEN
Value: [votre token copié]
Type: Variable
Protected: ✅ Oui
Masked: ✅ Oui
- Add Variable
Variables Utiles
| Variable | Description | Exemple |
|---|---|---|
VERCEL_TOKEN | Token Vercel | abc123... |
NETLIFY_AUTH_TOKEN | Token Netlify | xyz789... |
SSH_PRIVATE_KEY | Clé SSH serveur | -----BEGIN... |
DATABASE_URL | URL base de données | postgres://... |
API_KEY | Clé API externe | sk_live_... |
Workflow Git Recommandé
Stratégie de Branches
main (production)
↑
└─ develop (staging)
↑
└─ feature/ma-feature (développement)
Exemple Concret
1. Créer une Feature
bash
git checkout -b feature/ajout-newsletter
# Développez votre fonctionnalité
git add .
git commit -m "Ajout formulaire newsletter"
git push origin feature/ajout-newsletter
2. Merge Request → Staging
bash
# Sur GitLab : Create Merge Request
# feature/ajout-newsletter → develop
# Pipeline CI/CD s'exécute :
├─ Build ✅
├─ Tests ✅
└─ Deploy sur staging ✅
# Testez sur staging.mon-site.com
3. Merge Request → Production
bash
# Sur GitLab : Create Merge Request
# develop → main
# Pipeline CI/CD s'exécute :
├─ Build ✅
├─ Tests ✅
└─ Deploy sur production ✅ (Manuel ou Auto)
# Site en production sur mon-site.com
Pipeline Avancé avec Optimisations
Cache pour Accélérer les Builds
yaml
# Cache node_modules entre les jobs
.node-cache:
cache:
key: ${CI_COMMIT_REF_SLUG}
paths:
- node_modules/
- .next/cache/
build-app:
extends: .node-cache # Utilise le cache
script:
- npm ci
- npm run build
Gain de temps : 50-70% plus rapide !
Jobs Parallèles
yaml
test-unit:
stage: test
script:
- npm run test:unit
test-integration:
stage: test
script:
- npm run test:integration
test-e2e:
stage: test
script:
- npm run test:e2e
Les 3 tests s’exécutent en parallèle !
Déploiement Manuel en Production
yaml
deploy-production:
stage: deploy
script:
- vercel --prod
when: manual # ← Nécessite validation manuelle
only:
- main
Sécurité : Vous validez manuellement avant la prod.
Exemples de Pipelines Complets
Pipeline Frontend React/Next.js
yaml
stages:
- install
- test
- build
- deploy
install:
stage: install
image: node:18-alpine
script:
- npm ci
artifacts:
paths:
- node_modules/
test:
stage: test
dependencies:
- install
script:
- npm run lint
- npm run test
- npm run test:e2e
build:
stage: build
dependencies:
- install
script:
- npm run build
artifacts:
paths:
- .next/
deploy:
stage: deploy
script:
- npm i -g vercel
- vercel --prod --token=$VERCEL_TOKEN
only:
- main
Pipeline Backend WordPress
yaml
stages:
- validate
- deploy
phpcs:
stage: validate
image: php:8.2-cli
script:
- composer install
- vendor/bin/phpcs --standard=WordPress wp-content/themes/
deploy-ftp:
stage: deploy
image: alpine:latest
before_script:
- apk add lftp
script:
- lftp -c "open -u $FTP_USER,$FTP_PASS $FTP_HOST; mirror -R wp-content/ /public_html/wp-content/"
only:
- main
Debugging et Troubleshooting
Pipeline Échoue : Que Faire ?
1. Lire les Logs
bash
# Dans GitLab
CI/CD → Pipelines → Cliquez sur le job qui a échoué
# Lisez les logs en rouge
2. Erreurs Courantes
| Erreur | Cause | Solution |
|---|---|---|
npm ci failed | package-lock.json manquant | Commit le package-lock.json |
Tests failed | Tests en échec | Corrigez les tests localement |
Permission denied | Pas de clé SSH | Ajoutez SSH_PRIVATE_KEY variable |
Command not found | Outil non installé | Ajoutez installation dans before_script |
3. Tester Localement
bash
# Simuler le pipeline en local avec GitLab Runner
gitlab-runner exec docker build-app
Logs et Notifications
Configurer Notifications Slack
yaml
notify-slack:
stage: deploy
script:
- 'curl -X POST -H "Content-type: application/json" --data "{\"text\":\"✅ Déploiement réussi !\"}" $SLACK_WEBHOOK'
when: on_success
Bonnes Pratiques
✅ DO
- Commiter souvent : Pushez plusieurs fois par jour
- Tests avant merge : Ne mergez jamais sans tests verts
- Variables secrètes : Utilisez les Variables GitLab
- Cache intelligemment : node_modules, composer, etc.
- Jobs parallèles : Accélérez le pipeline
- Déploiement staging : Testez avant la prod
- Rollback plan : Gardez les builds précédents
❌ DON’T
- ❌ Jamais de secrets dans le code : Utilisez les variables
- ❌ Pas de déploiement direct en prod : Passez par staging
- ❌ Ne skipper jamais les tests : Même pour « une petite modif »
- ❌ Pipeline trop long : Max 10 minutes idéalement
- ❌ Trop de jobs : Groupez les petites tâches
Métriques de Succès
KPIs à Suivre
Fréquence de Déploiement
- ❌ Avant : 1 fois/semaine
- ✅ Après : 10-20 fois/jour
Temps de Déploiement
- ❌ Avant : 2-3 heures
- ✅ Après : 2-3 minutes
Taux d’Échec
- ❌ Avant : 30-40%
- ✅ Après : <5%
Mean Time to Recovery (MTTR)
- ❌ Avant : 2-4 heures
- ✅ Après : 5-10 minutes (rollback auto)
Ressources et Outils
Documentation
Outils Utiles
- GitLab CI Lint – Valider votre YAML
- GitLab Runner – Exécuter localement
- CI/CD Pipeline Editor – Éditeur visuel
Templates Prêts à l’Emploi
- Next.js : gitlab.com/templates/nextjs
- React : gitlab.com/templates/react
- WordPress : gitlab.com/templates/wordpress
Conclusion
Le CI/CD n’est plus un luxe, c’est une nécessité en 2026. Avec GitLab CI/CD, vous pouvez :
- ⚡ Déployer en 2-3 minutes au lieu de 2-3 heures
- 🛡️ Éviter 90% des bugs en production
- 😎 Travailler sereinement sans stress
- 🚀 Livrer de la valeur 10x plus vite
Le meilleur moment pour commencer ? Aujourd’hui.
Prochaines Étapes
- 📝 Créez votre fichier
.gitlab-ci.yml - 🔑 Configurez vos variables secrètes
- 🚀 Faites votre premier
git push - 🎉 Regardez votre pipeline s’exécuter
Besoin d’aide ? Contactez-moi pour une consultation gratuite de 30 minutes où je vous aiderai à configurer votre premier pipeline GitLab CI/CD.
Partagez cet article avec vos collègues développeurs qui déploient encore manuellement ! 😅
Abonnez-vous pour recevoir mes prochains tutoriels DevOps et CI/CD.
Article écrit par David Yéboué, expert CI/CD & DevOps basé à Abidjan, Côte d’Ivoire.Partager