espace-paie-odentas/COOLIFY_DEPLOYMENT.md

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 :

# 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