Mini-projet : Pipeline CI/CD complet

GitFlow vs trunk-based · Releases & rollback · Culture DevOps · PR → prod

Bootcode IWA-S04 — DevOps, Semaine 3, Jour 5

Objectifs de la leçon

1. Stratégies de branching

GitFlow vs trunk-based development — laquelle pour le CI/CD ?

2. Release management

Semantic versioning, changelogs, Git tags

3. Rollback strategies

Revenir en arrière doit être aussi simple qu'un clic

4. Culture DevOps

Responsabilité partagée, post-mortems blameless, monitoring

5. Concevoir un pipeline de bout en bout

PR → lint/test → build → push image → staging → prod avec approbation manuelle

Plan du cours

1

Recap de la semaine

CI (J1-J2) · Cloud (J3) · CD (J4) — aujourd'hui on assemble tout

2

GitFlow vs trunk-based

Stratégies de branching pour le CI/CD

3

Release management

Semver, changelogs, Git tags

4

Rollback + culture DevOps

Revenir en arrière, et pourquoi DevOps est une culture pas un rôle

5

Mini-projet

Pipeline complet pour Bootcode Hub — au moins 4h

GitFlow vs trunk-based

GitFlow

main ◄── release/v1.2

  ◄── develop

    ◄── feature/x

hotfix ◄── main

  • ✅ Releases planifiées, version stables parallèles
  • ✅ Adapté : mobile apps, librairies, logiciels vendus
  • ❌ Overhead, merges complexes, feedback lent

Trunk-based

main ◄── feature courte (1-2j)

  ◄── fix court

# PR → CI → merge → deploy

  • ✅ Intégration continue réelle, feedback immédiat
  • ✅ Compatible avec le déploiement continu
  • ✅ + feature flags pour cacher le travail en cours
  • ❌ Exige CI solide et discipline de tests

Recommandation : trunk-based + feature flags pour le déploiement continu. GitFlow pour des releases planifiées.

Release management : semver + tags

1.4.2

MAJOR — breaking change : l'API publique change, les clients doivent adapter leur code.

MINOR — nouvelle fonctionnalité rétrocompatible.

PATCH — bugfix rétrocompatible.

# tagger une release

git tag -a v1.4.2 -m "fix auth"

git push origin v1.4.2

# workflow déclenché par tag

on:

  push:

    tags: ['v*']

📋 Le changelog

Un CHANGELOG.md par version : qui, quoi, quand. Les tags Git permettent de revenir à n'importe quelle release exacte.

Rollback : simple ou inutile

« Le rollback doit être aussi simple qu'un clic — sinon il ne sera pas fait. »

1. Identifier

Quel SHA/tag déployer ? Le dernier connu bon — pas "un commit au hasard".

2. Exécuter

./rollback.sh abc1234 — pull l'image taggée, restart, healthcheck.

3. Vérifier

L'app répond, le healthcheck passe — puis investiguer sans pression.

❌ Sans stratégie → panique

Bug en prod + pas de rollback = déboguer en production sous pression. Le pire scénario possible.

✅ Alternative : roll forward

Parfois fixer en avançant (hotfix rapide) est mieux — mais il faut le choix, pas la contrainte.

Environments : la porte avant la prod

deploy-staging:

  needs: docker

  environment: staging

  # SSH → docker compose up — automatique

deploy-production:

  needs: deploy-staging

  environment: production

  # GitHub bloque ici : "Required reviewers"

  # → un humain clique "Approve" puis le job part

Staging = automatique

Déployé à chaque merge sur main — l'endroit où casser sans conséquence.

Production = approbation

Protection rule "Required reviewers" — livraison continue jusqu'en staging, déploiement continu en prod mais validé.

Chaque environment peut avoir ses propres secrets : VPS_HOST pour staging, PROD_HOST pour la prod.

DevOps : une culture, pas un rôle

🤝 Responsabilité partagée

« You build it, you run it » — les devs sont responsables de leur code en production, pas seulement jusqu'au merge.

🔍 Post-mortems blameless

Un incident analyse le système, pas la personne. Pourquoi le process a-t-il laissé passer ça ?

📊 Monitorer après le déploiement

Le job n'est pas fini quand le pipeline est vert — vérifier que l'app fonctionne réellement en prod.

🔁 Automatiser le toil

Ce qu'on fait 2 fois à la main, on l'automatise — la semaine entière en est la démonstration.

Pièges courants

❌ GitFlow pour déployer 3×/jour

Les branches longues + releases planifiées ralentissent tout. Overkill pour un projet web déployé en continu.

❌ Pas de stratégie de rollback

Le jour où ça casse en prod, on panique. Le rollback doit exister ET avoir été testé.

❌ Oublier l'approbation manuelle

Prod automatique sans garde = un bug mergé arrive en production en quelques minutes. Staging auto, prod validée.

❌ Deploy sans monitoring

Pipeline vert ≠ app fonctionnelle. Sans vérification post-deploy, on ne sait pas si ça marche.

Mini-projet E3.5 — ~4h

Pipeline CI/CD pour Bootcode Hub

PR / push main

  ├─ [lint] ──┐

  ├─ [test Node 18] ─┤

  └─ [test Node 20] ─┘

    (tous OK) ▼

  [build] → image Docker → push GHCR (tag SHA)

    ▼

  [deploy-staging] environment: staging → SSH → compose up

    ▼ approbation manuelle

  [deploy-production] environment: production → SSH → compose up

2 workflows

ci.yml (PRs : lint + matrix) · deploy.yml (push main : build → staging → prod)

Secrets par environment

VPS_* staging · PROD_* production — reviewers requis sur prod

Structure du repo & validation

.github/workflows/

  ├ ci.yml     # lint + tests (PRs)

  └ deploy.yml # build + deploy (main)

docker-compose.prod.yml

Dockerfile

rollback.sh

# bonus : badge CI, workflow release

# sur tags v*, notif Slack en échec

  • ✅ CI sur les PRs : lint + tests matrix Node 18/20
  • ✅ Deploy sur push main, cache npm partout
  • ✅ Image GHCR taggée SHA
  • ✅ Staging automatique après le build
  • ✅ Production = approbation manuelle
  • ✅ Healthchecks + restart policies
  • ✅ rollback.sh fonctionnel
  • ✅ Secrets dans GitHub, .env sur le serveur
  • ✅ Pipeline complet vert

À retenir !

🌿 Trunk-based pour le CD

Branches courtes + feature flags. GitFlow réservé aux releases planifiées.

🏷️ Semver + tags = releases traçables

MAJOR.MINOR.PATCH, changelog, workflow sur v*.

⏪ Rollback simple ou inutile

Un script, un SHA, un healthcheck — testé avant l'incident.

🤝 DevOps = culture

Responsabilité partagée de la prod, blameless post-mortems, monitoring après chaque deploy.

Bon courage pour le mini-projet — assemblez tout !