- nginx rejoint le reseau externe shared-network pour que le tunnel Cloudflare le resolue par son nom (cohaise-cloud-nginx). - real_ip_header CF-Connecting-IP : devient l'IP reelle du client, sinon limit_req et l'audit comptent l'IP du tunnel. - X-Forwarded-Proto reprend le schema vu par Cloudflare (https) au lieu de $scheme (http) : le cookie de session repasse en Secure. - docs/deployment.md : tunnel Docker via shared-network, deploy.yml sans make check.
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. En-têtes et limites
d'upload : ../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
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), puisnpm run build --workspace=frontend/sharedavant--workspace=${APP_DIR}— l'ordre est obligatoire, le front importe le design system. - Stage
export: recopiedist/seul, sans sources ninode_modules.
Dockerfile.api (back, utilisé deux fois)
ARG APP_DIR accepte deux valeurs :
| Service | APP_DIR |
Résultat |
|---|---|---|
migrate |
backend/shared |
binaire 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
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
apiest résolu depuisproxy.conf(variablecohaise_api) : l'API est appelée en interne sur le réseau compose, jamais via le port3101publié — ce port sert au debug. client_max_body_size 5gdoit rester aligné avecusers.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é.
- copie de
dist/versreleases/<UTC>-<pid>; - bascule atomique du lien
current(ln -sfnpuismv -T) ; - 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 :
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 :
docker compose build nginx && docker compose up -d nginx
Une simple modification sur disque ne change rien au service en cours.