Files
Esiah 858d862fed
deploy / deploy (push) Canceled after 0s
feat: init repo
2026-11-10 19:56:03 +01:00

79 lines
3.3 KiB
Markdown

# 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/<UTC>-<pid>` ;
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).