# docker/ — images de la vitrine Contient **tout ce qui touche à l'image** : build du front, image nginx, configuration et script de publication. Ce dépôt ne construit qu'une seule app (la vitrine) mais trois images, d'où ce dossier dédié plutôt que des `Dockerfile` à la racine. Le fonctionnement du service (compose, ports, healthchecks) est décrit dans [`../docs/deployment.md`](../docs/deployment.md) ; la sécurité des en-têtes, dans [`../docs/security.md`](../docs/security.md). ## Fichiers | Fichier | Image / rôle | Utilisé par compose ? | | --- | --- | --- | | `Dockerfile` | `nginx:1.27-alpine` + `nginx/web.conf` — le serveur | oui → service `nginx` | | `Dockerfile.app` | build Vite dans `node:22-alpine`, export `dist/` | oui → service `app-build` | | `Dockerfile.api` | build de `backend/shared` + API | **non** (reliquat du monorepo) | | `nginx/web.conf` | serveur : racine `current`, `/healthz`, gzip, caches | copié dans l'image | | `nginx/snippets/security-headers.conf` | `nosniff`, `X-Frame-Options`, `Referrer-Policy` | inclus partout | | `nginx/snippets/cache-immutable.conf` | `public, immutable` (assets) | `location /assets/` | | `nginx/snippets/cache-no-cache.conf` | `no-cache` (`index.html`) | `location /` | | `publish.sh` | publication atomique dans le volume | monté dans `app-build` | `Dockerfile.api` n'est référencé nulle part : `npm run build` le rend obsolète pour la vitrine. Il n'est conservé que parce que `backend/shared` appartient toujours au workspace. ## Images ```sh docker compose build # les deux images docker compose build app-build # seulement le build du front ``` ### `Dockerfile` (nginx) Supprime le `default.conf` par défaut, copie `web.conf` et les snippets, `EXPOSE 80`. Rien d'autre : pas de module ajouté, pas d'utilisateur dédié. ### `Dockerfile.app` (front) - `ARG APP_DIR` (`frontend/web`, passé par compose). - Stage `builder` : `npm ci` avec cache npm, puis `npm run build --workspace=frontend/shared` **puis** `--workspace=${APP_DIR}` (l'ordre compte : la vitrine importe le design system). - Stage `export` : recopie uniquement `dist/` dans `/app/dist`, sans les sources ni `node_modules`. ### Publication Le service `app-build` exécute `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 autres que la courante, **après 5 minutes**. Pendant la copie, nginx sert encore l'ancienne version. Aucun reload nécessaire. ## Aperçu de la conf nginx ```nginx root /usr/share/nginx/html/current; location = /healthz { return 200 "ok\n"; access_log off; } location /assets/ { include snippets/cache-immutable.conf; expires 1y; try_files $uri =404; } location / { include snippets/cache-no-cache.conf; try_files $uri $uri/ @spa; } location @spa { try_files /index.html =404; } ``` Les en-têtes de sécurité sont inclus **au niveau serveur et dans chaque location** : les réponses d'erreur et de santé sont couvertes aussi. ## Modifier la configuration 1. Éditer `nginx/web.conf` ou un snippet. 2. `docker compose build nginx && docker compose up -d nginx` (ou `make reload` si le fichier est monté — il ne l'est pas : il est copié dans l'image, donc une reconstruction est obligatoire).