79 lines
3.3 KiB
Markdown
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).
|