# docker/ — images du Cloud Tout ce qui touche aux images : build du front, image nginx, image API, configuration et publication. Ce dépôt en fabrique **quatre** (nginx, front, API, CLI de migration), d'où ce dossier dédié plutôt que des `Dockerfile` à la racine. Fonctionnement du service (ordre `db → migrate → api`, ports, healthchecks) : [`../docs/deployment.md`](../docs/deployment.md). En-têtes et limites d'upload : [`../docs/security.md`](../docs/security.md). ## Fichiers | Fichier | Rôle | Consommé par | | --- | --- | --- | | `Dockerfile` | `nginx:1.27-alpine` + `nginx/cloud.conf` | service `nginx` | | `Dockerfile.app` | build Vite (`node:22-alpine`), export `dist/` | service `app-build` | | `Dockerfile.api` | build d'un paquet backend, `npm prune --omit=dev` | services `migrate` **et** `api` | | `nginx/cloud.conf` | serveur : `/healthz`, proxy `/api/`, caches, SPA | copié dans l'image | | `nginx/snippets/` | en-têtes de sécurité, règles de cache | inclus par `cloud.conf` | | `publish.sh` | publication atomique dans `app_data` | monté dans `app-build` | ## Images ```sh docker compose build # toutes docker compose build api # seulement l'API ``` ### `Dockerfile` (nginx) Supprime le `default.conf` par défaut, copie `cloud.conf` et les snippets, `EXPOSE 80`. Aucun module ajouté. ### `Dockerfile.app` (front) - `ARG APP_DIR` → `frontend/cloud` (passé par compose). - Stage `builder` : `npm ci` (cache npm), puis `npm run build --workspace=${APP_DIR}` — le design system est dans le même paquet, aucun build préalable n'est nécessaire. - Stage `export` : recopie `dist/` seul, sans sources ni `node_modules`. ### `Dockerfile.api` (back, utilisé deux fois) `ARG APP_DIR` accepte deux valeurs : | Service | `APP_DIR` | Résultat | | --- | --- | --- | | `migrate` | `backend/cloud` | CLI `cohaise-migrate` (`dist/cli.js`) | | `api` | `backend/cloud` | serveur Hono (`dist/index.js`) | Même image, deux cibles : le conteneur `migrate` sert, joue les migrations puis s'arrête ; `api` tourne en continu (`restart: unless-stopped`). ## Le proxy nginx ```nginx location /healthz { … } location /api/ { proxy_pass $cohaise_api$request_uri; client_max_body_size 5g; … } location /assets/ { immutable 1 an } location / { no-cache, fallback SPA → @spa } ``` - L'upstream `api` est résolu depuis `proxy.conf` (variable `cohaise_api`) : l'API est appelée **en interne** sur le réseau compose, jamais via le port `3101` publié — ce port sert au debug. - `client_max_body_size 5g` doit rester **aligné** avec `users.max_file_bytes` (défaut 5 Go) : nginx rejette avant que l'API ne renvoie son erreur métier. ## Publication du front Service `app-build` : `command: sh /publish.sh` avec `app_data` monté. 1. copie de `dist/` vers `releases/-` ; 2. bascule atomique du lien `current` (`ln -sfn` puis `mv -T`) ; 3. purge des releases plus vieilles que 5 minutes. Pendant la copie, nginx sert l'ancienne version : aucun reload, aucune coupure. ## Migrations Le service `migrate` monte `./backend/cloud/migrations:/migrations:ro` (lecture seule) et lance : ```sh node dist/cli.js --dir /migrations # défaut, à chaque démarrage node dist/cli.js --dir /migrations --dry-run # simulation node dist/cli.js --dir /migrations --check # 1 s'il en reste ``` Codes de sortie : `0` OK · `1` erreur ou dérive de checksum · `2` configuration. ## Modifier la configuration `nginx/cloud.conf` et les snippets sont **copiés** dans l'image, pas montés : ```sh docker compose build nginx && docker compose up -d nginx ``` Une simple modification sur disque ne change rien au service en cours.