PR — Ouverture automatique / create-pr (push) Failing after 1s
Standalone files & media application: React/Vite frontend with the @cohaise/ui design system, Hono + MariaDB backend, nginx reverse proxy, Docker Compose stack, migrations 000-006, and project docs. Adds Gitea Actions workflows for deployment, automatic pull requests, and Renovate dependency updates.
103 lines
3.7 KiB
Markdown
103 lines
3.7 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/cloud` (passé par compose).
|
|
- Stage `builder` : `npm ci` (cache npm), puis
|
|
`npm run build --workspace=frontend/shared` **avant**
|
|
`--workspace=${APP_DIR}` — l'ordre est obligatoire, le front importe le
|
|
design system.
|
|
- 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/shared` | binaire `cohaise-migrate` (`dist/cli.js`) |
|
|
| `api` | `backend/cloud` | 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/cloud/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.
|