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 ?

Les Bases

CI (Continuous Integration) = Intégration Continue

CD (Continuous Deployment) = Déploiement Continu

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 :

✅ 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 :


Pourquoi GitLab CI/CD ?

GitLab vs Alternatives

CritèreGitLab CI/CDGitHub ActionsJenkins
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

  1. Allez sur vercel.com/account/tokens
  2. Cliquez sur Create Token
  3. Nom : « GitLab CI »
  4. Scope : Full Account
  5. Copiez le token généré (vous ne le reverrez plus !)

Étape 2 : Ajouter dans GitLab

  1. Dans votre projet GitLab → Settings → CI/CD
  2. Expandre Variables
  3. Cliquez Add Variable
  4. Configurez :
   Key: VERCEL_TOKEN
   Value: [votre token copié]
   Type: Variable
   Protected: ✅ Oui
   Masked: ✅ Oui
  1. Add Variable

Variables Utiles

VariableDescriptionExemple
VERCEL_TOKENToken Vercelabc123...
NETLIFY_AUTH_TOKENToken Netlifyxyz789...
SSH_PRIVATE_KEYClé SSH serveur-----BEGIN...
DATABASE_URLURL base de donnéespostgres://...
API_KEYClé API externesk_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

ErreurCauseSolution
npm ci failedpackage-lock.json manquantCommit le package-lock.json
Tests failedTests en échecCorrigez les tests localement
Permission deniedPas de clé SSHAjoutez SSH_PRIVATE_KEY variable
Command not foundOutil 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

  1. Commiter souvent : Pushez plusieurs fois par jour
  2. Tests avant merge : Ne mergez jamais sans tests verts
  3. Variables secrètes : Utilisez les Variables GitLab
  4. Cache intelligemment : node_modules, composer, etc.
  5. Jobs parallèles : Accélérez le pipeline
  6. Déploiement staging : Testez avant la prod
  7. Rollback plan : Gardez les builds précédents

❌ DON’T

  1. ❌ Jamais de secrets dans le code : Utilisez les variables
  2. ❌ Pas de déploiement direct en prod : Passez par staging
  3. ❌ Ne skipper jamais les tests : Même pour « une petite modif »
  4. ❌ Pipeline trop long : Max 10 minutes idéalement
  5. ❌ Trop de jobs : Groupez les petites tâches

Métriques de Succès

KPIs à Suivre

Fréquence de Déploiement

Temps de Déploiement

Taux d’Échec

Mean Time to Recovery (MTTR)


Ressources et Outils

Documentation

Outils Utiles

Templates Prêts à l’Emploi


Conclusion

Le CI/CD n’est plus un luxe, c’est une nécessité en 2026. Avec GitLab CI/CD, vous pouvez :

Le meilleur moment pour commencer ? Aujourd’hui.


Prochaines Étapes

  1. 📝 Créez votre fichier .gitlab-ci.yml
  2. 🔑 Configurez vos variables secrètes
  3. 🚀 Faites votre premier git push
  4. 🎉 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

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *