Aller au contenu principal

Guide de Déploiement

FirstBreath est déployé sur un VPS géré par Dokploy, une alternative open-source à Vercel/Heroku.

Vue d'ensemble de l'Infrastructure​

Nous exécutons plusieurs stacks Docker Compose isolées qui communiquent via un réseau partagé.

Comment Déployer​

1. Push sur Master​

Nous utilisons le GitOps. Chaque commit poussé sur la branche main d'un repository déclenche une reconstruction dans Dokploy (via Webhook).

2. Déploiement Manuel (Interface Dokploy)​

Si le déploiement automatique échoue ou si vous devez faire un rollback manuel :

  1. Connectez-vous à https://dokploy.firstbreath.fr
  2. Allez dans Projet -> Service (ex: hub-api).
  3. Cliquez sur "Deploy".

Variables d'Environnement​

Les variables d'environnement sont gérées dans l'interface Dokploy sous l'onglet "Environment" de chaque service.

⚠️ Critique : Ne commitez jamais de fichiers .env. Vérifiez toujours les variables dans Dokploy si un service ne démarre pas en production.

Dépannage​

"Bad Gateway" (502)​

Cela signifie généralement que le conteneur plante ou redémarre.

  1. Vérifiez les logs dans Dokploy.
  2. Vérifiez que l'application écoute sur le bon port (Backend: 3333, Frontend: 3000).

"Connection Refused" entre services​

Assurez-vous que les deux services sont attachés au réseau externe monitor-net dans leur docker-compose.yml.