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 ; la sécurité des en-têtes, dans
../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
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 ciavec cache npm, puisnpm run build --workspace=frontend/sharedpuis--workspace=${APP_DIR}(l'ordre compte : la vitrine importe le design system). - Stage
export: recopie uniquementdist/dans/app/dist, sans les sources ninode_modules.
Publication
Le service app-build exécute sh /publish.sh avec app_data monté :
- copie de
dist/versreleases/<UTC>-<pid>; - bascule atomique du lien
current(ln -sfnpuismv -T) ; - 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
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
- Éditer
nginx/web.confou un snippet. docker compose build nginx && docker compose up -d nginx(oumake reloadsi le fichier est monté — il ne l'est pas : il est copié dans l'image, donc une reconstruction est obligatoire).