Projet final : déploiement complet

Docker · CI/CD · Nginx HTTPS · Monitoring · Logging · Backups · Documentation

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

Objectifs de la leçon

1. Synthétiser le mois

Toutes les compétences DevOps acquises en un seul déploiement

2. Concevoir l'architecture

Le schéma complet d'un déploiement production — avant de coder

3. Appliquer la checklist

La méthodologie de mise en production, étape par étape

4. Documenter l'infra

Diagrammes et runbooks — un déploiement reproductible

5. Diagnostiquer & présenter

Résoudre les problèmes courants de déploiement et présenter devant un public technique

Plan du cours

1

Recap du mois

Les 4 couches : infra, déploiement, observabilité, sécurité

2

Architecture production complète

Le schéma d'ensemble avec tous les composants

3

Checklist de mise en production

Les étapes à ne jamais oublier

4

Documentation d'infrastructure

Pourquoi et comment documenter — diagrammes, runbooks

5

Projet final + critères

Déploiement de Bootcode Hub + présentation (15-20 min)

Le mois en 4 couches

1

Infrastructure — semaines 1 & 3

Linux, réseaux, SSH, cloud AWS : la machine sur laquelle tout repose

2

Déploiement — semaines 2, 3 & J1

Docker, CI/CD, registry, Nginx, HTTPS : le code arrive en prod

3

Observabilité — J2 & J3

Prometheus, Grafana, logs structurés : savoir ce qui se passe

4

Sécurité — J4

Hardening, firewall, backups : protéger et pouvoir restaurer

Le projet final = toutes les couches en même temps, sur un vrai serveur, avec un vrai domaine.

L'architecture cible

Internet ──HTTPS──▶ [UFW + Fail2ban]

              │

              ▼ :443 Nginx (SSL termination)

              ├─ / → fichiers statiques React

              └─ /giraffe/ → proxy_pass

                  ▼

   Docker Compose (non-root, healthchecks)

   ├─ app Node.js :3000 ── /metrics

   ├─ PostgreSQL :5432

   └─ volumes + .env serveur

   ┌───────── Observabilité ─────────┐

   │ Prometheus :9090 ← scrape app │

   │ node_exporter :9100 (CPU/RAM) │

   │ Grafana :3001 ← dashboards │

   └───────────────────────────────┘

   Cron 3h → pg_dump → /opt/backups → S3

Et en amont : GitHub Actions — push main → tests → build image → push GHCR → SSH deploy.

Le déploiement en 9 étapes

1. Préparation

Schéma d'architecture AVANT tout — 30 min

2. Sécurisation

SSH, UFW, fail2ban — 30 min

3. Docker deploy

compose.prod + healthcheck — 1h

4. Nginx + HTTPS

Reverse proxy, Certbot, headers — 30 min

5. Monitoring

Prometheus, Grafana, 4 signaux, 2 alertes — 1h

6. Logging

Winston JSON, correlation ID — 30 min

7. Backups

pg_dump, cron, test restauration — 30 min

8. Documentation

INFRASTRUCTURE.md — 30 min

9. Présentation

Démo live — 15-20 min

~6h de travail. L'ordre compte : sécuriser d'abord, exposer ensuite.

Checklist de mise en production

🔐 Sécurité

☐ SSH : clé only, no root, fail2ban

☐ UFW : 80/443/SSH seulement

☐ Conteneurs non-root

☐ npm audit : rien de high/critical

🚀 Déploiement

☐ App en HTTPS sur domaine réel

☐ SPA routing OK (try_files)

☐ /giraffe/health répond

☐ Certificat valide, renouvellement auto

👁️ Observabilité

☐ Prometheus scrape app + node

☐ Dashboard 4+ panels

☐ 2+ alertes configurées

☐ Logs JSON + correlation ID

💾 Résilience

☐ Backups cron quotidiens

☐ Restauration testée

☐ .env sur serveur, pas dans Git

☐ INFRASTRUCTURE.md complet

Cette checklist est ta grille d'évaluation — et surtout, ta procédure pour le futur.

Documenter : le déploiement reproductible

« Un déploiement sans doc est un déploiement qu'on ne pourra pas reproduire. »

INFRASTRUCTURE.md doit contenir

  • Diagramme d'architecture (composants + ports)
  • Inventaire : serveur, domaine, services, versions
  • Procédure de déploiement pas à pas
  • Procédure de rollback
  • Localisation des secrets (où, pas les valeurs)

Le runbook

  • « L'app est down » → vérifier : compose ps, logs, healthcheck
  • « Le certificat expire » → certbot renew
  • « Restaurer la DB » → commandes exactes
  • « Erreur X » → diagnostic connu + fix

Le test : quelqu'un d'autre doit pouvoir redéployer en suivant ta doc, sans te poser de question.

La démo live (15-20 min)

1️⃣

L'app

Frontend + API en prod sur le domaine

2️⃣

Grafana

Le dashboard qui bouge en temps réel

3️⃣

L'incident

Simuler un problème → diagnostiquer avec les logs

4️⃣

Backups

Le script + une restauration en live

5️⃣

La doc

INFRASTRUCTURE.md — preuve de reproductibilité

Une démo technique, pas un TED talk

Montrer le système qui fonctionne. Improviser, c'est normal — déboguer en live fait partie du show. Les présentations devant la classe préparent aux démos en entreprise.

Pièges courants

❌ Se lancer sans plan

Pas de schéma d'architecture = on oublie des composants, des ports, des configs. 30 min de papier sauvent des heures.

❌ Jamais testé de zéro

Le déploiement marche « parce qu'on l'a fait petit à petit ». Refaire une fresh install pour valider la vraie procédure.

❌ Documentation incomplète

Le prochain qui déploie doit pouvoir le faire sans aide — sinon c'est un déploiement jetable.

❌ Paniquer en présentation

C'est une démo technique : montrer, expliquer, déboguer si besoin. Pas besoin d'être un orateur.

Projet final E4.5 — ~6h

Critères d'évaluation

  • ✅ App accessible en HTTPS sur un domaine réel
  • ✅ Frontend React (SPA) + API /giraffe/health
  • ✅ Certificat SSL valide (pas d'avertissement)
  • ✅ SSH sécurisé, UFW, fail2ban actifs
  • ✅ Conteneurs non-root
  • ✅ Prometheus scrape app + node_exporter
  • ✅ Dashboard Grafana ≥ 4 métriques
  • ✅ ≥ 2 alertes Grafana
  • ✅ Logs JSON + correlation ID
  • ✅ Backups cron + restauration testée
  • ✅ INFRASTRUCTURE.md complet
  • ✅ Présentation couvrant tous les composants

Dernier jour du programme DevOps

C'est un déploiement réel qui valide tout le mois. DevOps n'est pas un rôle à part — c'est une compétence que tout développeur doit avoir.

À retenir !

📐 Le schéma avant le code

Dessiner l'architecture d'abord — composants, ports, configs. Le plan évite les oublis.

✅ La checklist est un outil

Sécurité, déploiement, observabilité, résilience — méthodique bat héroïque.

📖 Documenter = reproduire

INFRASTRUCTURE.md + runbooks : le prochain déploie sans toi.

🎤 Le DevOps est une compétence

Pas un rôle à part — présenter et diagnostiquer en live, ça s'apprend.

Bon déploiement — et félicitations pour le mois ! 🎉