Déployer en production
En production, tout passe par Docker Composeà : PostgreSQL, Redis, le backend, le frontend, et une terminaison TLS Caddy. Aucune chaîne d’outils locale n’est nécessaire.
Prérequis
Section intitulée « Prérequis »Docker avec Compose. Rien d’autre.
-
Clonez ce dépôt et créez le fichier d’environnementà :
Fenêtre de terminal cp docker/.env.example docker/.envRemplissez les valeurs — nom d’hôte public, relais SMTP, secrets. Le fichier documente chaque clé.
-
Construisez et démarrez la pileà :
Fenêtre de terminal docker compose -f docker/compose.prod.yml up -d --buildLe point d’entrée du backend applique les migrations et initialise le schéma de base à chaque démarrage. Aucune étape manuelle pour le schéma.
-
Créez le premier administrateurà :
Fenêtre de terminal docker compose -f docker/compose.prod.yml exec backend facet seed:admin ops@your-company.tldLa commande affiche un mot de passe à usage unique. Il ne s’affiche qu’une seule fois — notez-le dans un gestionnaire de mots de passe.
-
Ouvrez
https://<your-hostname>(par défautà :https://facet.localhost:3443), connectez-vous avec le mot de passe àusage unique, puis définissez un vrai mot de passe quand c’est demandé.
Cette adresse est le port de la terminaison Caddy.
HTTPS_PORTdansdocker/.envle définit (par défaut3443). Le backend écoute sur le port3000à l’intérieur du réseau Docker, et la terminaison lui relaie les requêtes. Le port3000n’est pas publié sur l’hôte.
À savoir en production
Section intitulée « À savoir en production »- Les migrations sont embarquées dans le binaire. Un binaire déployé
n’a pas besoin de l’arborescence
db/sur disque. Après la première mise en production, le répertoire des migrations n’accepte que les ajouts — ne modifiez jamais un fichier de migration appliqué. - Les timestamps sont stockés en UTC. Le schéma garde des valeurs UTC
sans fuseau horaire. L’application épingle sa session PostgreSQL sur
UTC. Un client qui se connecte avec un autre rôle (psql, outils BI) doit
définir
TimeZone=UTClui-même, sinon ses écritures se décalent du fuseau de sa session. - Redis est obligatoire. Le bus d’événements, les sessions, les codes OAuth, et les rate limits l’utilisent. PostgreSQL porte l’état durableà ; Redis est le bus de réaction.
Références
Section intitulée « Références »- Déploiement en conteneurs — images, tags, montage de la configuration, et la terminaison TLS.
- Fichiers de configuration — chaque clé que prend le fichier de configuration.
- Amorçage et tâches CLI — les commandes de l’étape 3.
- Migrations de base de données — ce que le point d’entrée exécute au démarrage.
- Guides opératoires dans le dépôtà : first-deployment.md, container-images.md.