Add Coolify deployment documentation

This commit is contained in:
odentas 2025-12-27 14:20:41 +01:00
parent ccc0f34b03
commit b96ff2198a

123
COOLIFY_DEPLOYMENT.md Normal file
View file

@ -0,0 +1,123 @@
# Déploiement sur Coolify
## 🔧 Configuration
### Repository Git
- **Forgejo**: https://git.odnt.fr/renaud/espace-paie-odentas
- **Branche**: main
- **GitHub (backup)**: https://github.com/odentas/Nouvel-Espace-Paie
### Dockerfile
Le projet utilise un Dockerfile multi-stage optimisé pour Next.js en mode standalone.
## 📋 Variables d'environnement requises
### Supabase
```
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=
```
### AWS
```
AWS_REGION=eu-west-3
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_S3_BUCKET_NAME=
AWS_CLOUDFRONT_DOMAIN=
```
### Email (SES)
```
AWS_SES_FROM_EMAIL=
AWS_SES_FROM_NAME=
```
### DocuSeal
```
DOCUSEAL_API_KEY=
DOCUSEAL_BASE_URL=
NEXT_PUBLIC_DOCUSEAL_WEBHOOK_URL=
```
### PDFMonkey
```
PDFMONKEY_PRIVATE_KEY=
NEXT_PUBLIC_PDFMONKEY_TEMPLATE_ID=
```
### PostHog Analytics
```
NEXT_PUBLIC_POSTHOG_KEY=
NEXT_PUBLIC_POSTHOG_HOST=https://eu.i.posthog.com
```
### Lambda Functions
```
LAMBDA_SIGNATURE_SALARIE_URL=
LAMBDA_ODENTAS_PADES_SIGN_URL=
LAMBDA_TSA_STAMP_URL=
LAMBDA_PDF_CONVERTER_URL=
```
### Autres
```
NODE_ENV=production
NEXT_TELEMETRY_DISABLED=1
JWT_SECRET=
ENCRYPTION_KEY=
```
## 🚀 Configuration dans Coolify
1. **Créer un nouveau projet** dans Coolify
2. **Source**: Git Repository
3. **Repository URL**: `https://git.odnt.fr/renaud/espace-paie-odentas.git`
4. **Branche**: `main`
5. **Build Type**: Dockerfile
6. **Port**: 3000
### Build Settings
- **Dockerfile Path**: `/Dockerfile` (racine du projet)
- **Build Pack**: Dockerfile
- **Health Check Path**: `/api/health` (à créer si nécessaire)
### Déploiement
Le Dockerfile utilise le mode `standalone` de Next.js :
- Build optimisé avec cache des dépendances
- Image finale minimale basée sur Alpine
- Utilisateur non-root pour la sécurité
- Port 3000 exposé
## 🔄 Mise à jour du code
Pour déployer une nouvelle version :
```bash
# Depuis le répertoire du projet
git add .
git commit -m "Description des changements"
git push forgejo main # Push vers Forgejo
git push origin main # Backup vers GitHub
```
Coolify détectera automatiquement le changement et redéployera l'application.
## ✅ Vérifications post-déploiement
1. Vérifier que toutes les variables d'environnement sont configurées
2. Tester l'accès à l'application
3. Vérifier les logs dans Coolify
4. Tester les fonctionnalités critiques :
- Authentification
- Génération de contrats
- Signature électronique
- Upload de documents
## 📝 Notes
- **Next.js Version**: 14.2.5
- **Node Version**: 18 (Alpine)
- **Output Mode**: standalone
- **Architecture**: Multi-stage Docker build