Files
CoHaiSe-CLOUD/docker/README.md
T
Esiah cc397e96d8
PR — Ouverture automatique / create-pr (push) Failing after 1s
chore: initial import of CoHaiSe Cloud
Standalone files & media application: React/Vite frontend with the @cohaise/ui design system, Hono + MariaDB backend, nginx reverse proxy, Docker Compose stack, migrations 000-006, and project docs.

Adds Gitea Actions workflows for deployment, automatic pull requests, and Renovate dependency updates.
2026-10-14 15:24:06 +02:00

3.7 KiB

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), puis npm run build --workspace=frontend/shared avant --workspace=${APP_DIR} — l'ordre est obligatoire, le front importe le design system.
  • 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/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 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/<UTC>-<pid> ;
  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 :

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.