Plan de Déploiement

1.1 Objet du Document

Ce document définit le plan de déploiement complet pour l'ensemble de l'écosystème REWAPP. Il couvre les procédures, environnements, stratégies et mécanismes de rollback nécessaires pour garantir des déploiements fiables, reproductibles et réversibles.

1.2 Périmètre

Le plan de déploiement couvre les cinq composantes de l'écosystème REWAPP :

• Application Mobile (iOS/Android) Angular + Ionic
• Site Vitrine Angular + Tailwind CSS
• Dashboard Admin Angular + Angular Material
• Dashboard Partenaire Angular + Ionic (PWA)
• Backend API Microservices NestJS sur Docker/CapRover

1.3 Objectifs du Déploiement

1.4 Principes Directeurs

2.1 Vue d'Ensemble des Environnements

2.2 Environnement de Développement

2.3 Environnement de Staging

2.4 Environnement de Production

2.5 Matrice des Branches et Environnements

3.1 Prérequis Infrastructure

3.2 Prérequis Applicatifs

3.3 Prérequis Intégrations Tierces

3.4 Prérequis Équipe

4.1 Stratégie Blue-Green

REWAPP utilise une stratégie Blue-Green Deployment pour garantir un déploiement sans interruption de service.

4.2 Fenêtres de Déploiement

4.3 Canary Deployment (Optionnel - Phase 2)

Pour les fonctionnalités à risque élevé, un déploiement Canary progressif peut être utilisé :

4.4 Feature Flags

REWAPP utilise des Feature Flags pour activer/désactiver des fonctionnalités sans redéploiement :

• Stockage : CapRover Environment Variables
• Mise à jour : temps réel (cache 60 secondes)
• Granularité : global, par environnement, par utilisateur

5.1 Déploiement Backend API (Microservices NestJS)

Workflow CI/CD :

Commandes de Déploiement :

# Déploiement staging (automatique via GitHub Actions)
git checkout main
git merge develop
git push origin main

# Déploiement production (manuel)
git tag -a v1.2.3 -m "Release 1.2.3 - Description"
git push origin v1.2.3
# Puis approbation dans GitHub Actions

5.2 Déploiement Site Vitrine (Angular)

5.3 Déploiement Dashboards (Angular SPA)

Workflow identique pour Dashboard Admin et Dashboard Partenaire :

5.4 Déploiement Application Mobile (Angular + Ionic / Capacitor)

5.5 Déploiement Base de Données (Migrations)

6.1 Critères de Déclenchement Rollback

6.2 Rollback Backend API

Procédure Automatique (recommandée) :

CapRover détecte automatiquement un échec si :

• Health check /api/health échoue 3 fois consécutives
• Métriques CloudWatch dépassent les seuils critiques

Action automatique : Basculement immédiat vers environnement BLUE (version précédente). Notification Slack et PagerDuty. Logging de l'incident.

Procédure Manuelle :

# 1. Identifier la version précédente
aws ecs describe-services --cluster rewapp-prod --services api-service

# 2. Rollback vers task definition précédente
aws ecs update-service --cluster rewapp-prod --service api-service   --task-definition rewapp-api:PREVIOUS_VERSION

# 3. Vérifier le rollback
aws ecs wait services-stable --cluster rewapp-prod --services api-service

6.3 Rollback Frontend (Site Vitrine, Dashboards)

# 1. Identifier la version précédente dans S3
aws s3 ls s3://rewapp-vitrine-prod/ --recursive

# 2. Restaurer depuis le backup ou rebuild
# Option A : Restaurer depuis version précédente
aws s3 sync s3://rewapp-vitrine-prod-backup/ s3://rewapp-vitrine-prod/

# Option B : Rebuild de la version précédente
git checkout vX.Y.Z-1
npm run build
aws s3 sync ./out s3://rewapp-vitrine-prod/

# 3. Invalider le cache Nginx
aws cloudfront create-invalidation --distribution-id XXXX --paths "/*"

6.4 Rollback Application Mobile

Options disponibles :

• Publication d'une nouvelle version corrigée (délai review)
• Utilisation de CodePush pour mise à jour OTA (JavaScript uniquement)
• Feature flag pour désactiver la fonctionnalité problématique

6.5 Rollback Base de Données

# 1. Identifier le backup le plus récent
aws rds describe-db-snapshots --db-instance-identifier rewapp-prod

# 2. Option A : Restaurer depuis snapshot (downtime ~30min)
aws rds restore-db-instance-from-db-snapshot   --db-instance-identifier rewapp-prod-restored   --db-snapshot-identifier rds:rewapp-prod-YYYY-MM-DD

# 3. Option B : Exécuter migration inverse (si disponible)
npx prisma migrate resolve --rolled-back MIGRATION_NAME

7.1 Checklist Pré-Déploiement

7.2 Checklist Post-Déploiement

8.1 Classification des Incidents

8.2 Procédure de Gestion d'Incident

8.3 Contacts d'Escalade

9.1 Canaux de Communication

9.2 Templates de Communication

9.3 Status Page

URL : status.rewapp.fr

Composants surveillés :

10.1 Récapitulatif

Ce plan de déploiement établit un cadre rigoureux pour garantir des déploiements fiables et réversibles pour l'ensemble de l'écosystème REWAPP. Les points clés sont :

• Stratégie Blue-Green : Zero downtime garanti
• Automatisation CI/CD : Réduction des erreurs humaines
• Rollback rapide : < 5 minutes pour le backend
• Monitoring proactif : Détection précoce des anomalies
• Communication structurée : Transparence avec les parties prenantes

10.2 Indicateurs de Succès

10.3 Évolutions Futures

• Canary Deployment : Déploiement progressif par pourcentage de trafic
• GitOps : ArgoCD pour synchronisation déclarative Kubernetes
• Chaos Engineering : Tests de résilience automatisés
• Déploiement Multi-Région : Préparation expansion européenne