Aller au contenu principal

Release Checklist

StatutActif — v1.0 — 2026-06-27
PrioritéP0
Obligatoire V1Oui
ResponsableSylvain
Voir aussiPlaybook Release · Playbook Backup

Cette checklist doit être parcourue avant toute release impliquant une migration de base de données, un changement d'infrastructure, ou une fonctionnalité critique.

Pour les releases courantes (bug fixes, petites features), les étapes CI suffisent.

Avant le merge​

  • CI verte — tous les status checks passent sur la PR
  • Review effectuée — au moins un approbateur
  • Typecheck et lint OK — aucune erreur TypeScript ou ESLint
  • Tests PHPUnit OK — php artisan test passe en local
  • Preview validée — URL Cloudflare Pages testée sur mobile et desktop (si changement frontend)
  • Migrations vérifiées — rollback possible ? données existantes préservées ?

Avant le déploiement​

  • Sauvegarde récente — backup de moins de 2 heures disponible et intègre
  • Sauvegarde manuelle si migration destructive — déclencher un backup avant le déploiement
  • Rollback planifié — méthode de rollback identifiée (commit précédent, restauration backup)
  • Créneau choisi — déployer en période de faible activité si changement risqué

Pendant le déploiement​

  • Suivi CI — observer le workflow GitHub Actions jusqu'à la fin
  • Maintenance active — si mode maintenance activé, vérifier qu'il se désactive bien en fin de deploy

Après le déploiement​

  • Health check API — GET /api/v1/health retourne 200
  • Navigation frontend — tester les pages modifiées
  • Logs Nginx — aucune erreur 5xx dans les 5 minutes suivant le déploiement
  • Workers Supervisor — tous les workers en état RUNNING
  • Monitoring uptime — aucune alerte déclenchée
  • Test fonctionnel — valider le parcours utilisateur concerné par la release

En cas de problème​

  • Rollback immédiat — ne pas chercher à corriger en production sous pression
  • Cause identifiée — avant de redéployer, comprendre ce qui a échoué
  • Post-mortem — pour tout incident ayant impacté des utilisateurs, documenter la cause et l'action corrective

Cette checklist est volontairement courte. Si elle devient trop longue, elle ne sera plus utilisée.