Files
Gitea ActionsandEsiah 9dd1ad72e0
CD — Déploiement / deploy (push) Failing after 25s
feat: logo et favicon, confirmation modale, fil d'ariane, e-mails sombres (#4)
- logo embarque dans les e-mails (CID) et gabarit repense en mode sombre
- favicon multi-tailles + icone PNG, logo a gauche du titre (app et auth)
- modale de confirmation animee a la place de window.confirm
- bouton retour et fil d'ariane dans l'explorateur

---------

Co-authored-by: xEsiah <[email protected]>
Reviewed-on: #4
Reviewed-by: Esiah <[email protected]>
Co-authored-by: Gitea Actions <-[email protected]>
2026-10-16 11:08:47 +00:00

102 lines
3.6 KiB
Markdown

# 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`](../docs/deployment.md). En-têtes et limites
d'upload : [`../docs/security.md`](../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
```sh
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` (passé par compose).
- Stage `builder` : `npm ci` (cache npm), puis
`npm run build --workspace=${APP_DIR}` — le design system est dans le même
paquet, aucun build préalable n'est nécessaire.
- 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` | CLI `cohaise-migrate` (`dist/cli.js`) |
| `api` | `backend` | 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
```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/migrations:/migrations:ro` (lecture
seule) et lance :
```sh
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 :
```sh
docker compose build nginx && docker compose up -d nginx
```
Une simple modification sur disque ne change rien au service en cours.