chore: store database and media on host bind mounts
CD — Déploiement / deploy (push) Failing after 1s

Move MariaDB and media data out of /var/lib/docker onto the host disk via CLOUD_DB_DIR and CLOUD_MEDIA_DIR (default ../db, ../media). Only the frontend build output remains a named volume.
This commit is contained in:
2026-10-16 10:47:12 +02:00
parent 37e0b542ae
commit a22f18d860
5 changed files with 29 additions and 10 deletions
+7 -1
View File
@@ -1,4 +1,4 @@
# CoHaiSe Cloud — modele de configuration.non
# CoHaiSe Cloud — modele de configuration
# --- Pont HTTP -----------------------------------------------------------
# Port ouvert par nginx sur la machine hote.
@@ -12,6 +12,12 @@ CLOUD_DB_PASSWORD=
# Mot de passe root du conteneur, utilise uniquement par la sauvegarde.
CLOUD_DB_ROOT_PASSWORD=
# --- Emplacement des donnees (volumes) ----------------------------------
# Dossiers HOTES qui recoivent les donnees persistantes. Chemins relatifs au
# dossier du depot (defaut : freres du clone, hors du disque systeme).
CLOUD_DB_DIR=../db
CLOUD_MEDIA_DIR=../media
# --- Session (obligatoire pour toute API) -------------------------------
# Secret de chiffrement des sessions. Obligatoire, 32 caracteres minimum.
# Generation :
+7 -4
View File
@@ -85,7 +85,8 @@ services:
timeout: 5s
retries: 5
volumes:
- db_data:/var/lib/mysql
# Donnees MariaDB : dossier hote (gros disque), pas le volume Docker.
- ${CLOUD_DB_DIR:-../db}:/var/lib/mysql
<<: *restart
migrate:
@@ -152,7 +153,8 @@ services:
ports:
- "127.0.0.1:${COHAISE_API_PORT:-3101}:8080"
volumes:
- media_data:/data/media
# Fichiers medias : dossier hote (gros disque), pas le volume Docker.
- ${CLOUD_MEDIA_DIR:-../media}:/data/media
healthcheck:
test: ["CMD", "wget", "-qO-", "http://127.0.0.1:8080/healthz"]
interval: 15s
@@ -162,6 +164,7 @@ services:
<<: *restart
volumes:
# Seul volume Docker restant : la sortie de build du front (petite, ephemere).
# La base et les medias sont des bind mounts vers l'hote (CLOUD_DB_DIR,
# CLOUD_MEDIA_DIR) afin de vivre sur le gros disque et non dans /var/lib/docker.
app_data:
db_data:
media_data:
+3 -2
View File
@@ -25,8 +25,9 @@ CI). L'exécuter avant de déclarer un travail fini.
1. **Ne pas lire `.env`** : secrets de production. Écrire un `SESSION_SECRET`
manquant est autorisé ; le diffuser, non.
2. **Ne pas committer ni pousser** sans demande explicite.
3. **Pas de `down -v`, pas de suppression de volume** : `db_data` porte les
données, `media_data` les fichiers.
3. **Pas de `down -v`, pas de suppression de volume** : la base et les médias
sont des bind mounts hôte (`$CLOUD_DB_DIR`, `$CLOUD_MEDIA_DIR`) — ne pas
effacer ces dossiers.
4. **Ne jamais modifier une migration déjà appliquée** : nouveau fichier numéroté
seulement. Le checksum bloquerait le démarrage.
5. **API admin** : les routes `/api/cloud/admin/*` existent (UI Administration).
+2 -1
View File
@@ -44,7 +44,8 @@ app-build (publish.sh, terminé avant nginx)
- `migrate` monte `./backend/cloud/migrations:/migrations:ro`.
- `api` refuse de démarrer si une migration appliquée a été modifiée (dérive de
checksum). `onReady` purge les sessions et la corbeille expirées.
- volumes : `app_data` (HTML), `db_data` (MariaDB), `media_data`.
- stockage : `app_data` (volume Docker, HTML), `$CLOUD_DB_DIR` (MariaDB) et
`$CLOUD_MEDIA_DIR` (fichiers) en bind mounts hôte.
## API et front
+10 -2
View File
@@ -23,6 +23,8 @@ pose problème (`backend/shared/src/config.ts`).
| `COHAISE_DB_PORT` | port MariaDB | `3407` |
| `CLOUD_DATABASE` / `CLOUD_DB_USER` / `CLOUD_DB_PASSWORD` | base applicative | — |
| `CLOUD_DB_ROOT_PASSWORD` | root, réservé aux sauvegardes | — |
| `CLOUD_DB_DIR` | dossier hôte des données MariaDB | `../db` |
| `CLOUD_MEDIA_DIR` | dossier hôte des médias | `../media` |
| `CLOUD_DB_CONNECTION_LIMIT` | taille du pool | `8` |
| `SESSION_SECRET` | **obligatoire**, ≥ 32 car. | — |
| `SESSION_TTL_HOURS` | durée de session | `336` |
@@ -53,15 +55,21 @@ Variables fixes posées par compose : `PORT=8080`, `DB_HOST=db`,
| Service | Port | Santé | Rôle |
| --- | --- | --- | --- |
| `db` | `3407` | `healthcheck.sh --connect --innodb_initialized` | MariaDB, volume `db_data` |
| `db` | `3407` | `healthcheck.sh --connect --innodb_initialized` | MariaDB, bind mount `$CLOUD_DB_DIR` |
| `migrate` | — | — | joue les migrations manquantes, puis s'arrête |
| `api` | `3101` | `GET :8080/healthz` (start 20 s) | Hono, volume `media_data` |
| `api` | `3101` | `GET :8080/healthz` (start 20 s) | Hono, bind mount `$CLOUD_MEDIA_DIR` |
| `nginx` | `8083` | `GET /healthz` | sert le front, proxy `/api/` |
| `app-build` | — | — | build + publication atomique, `restart: "no"` |
Ordre garanti par `depends_on` : `migrate` attend `db` healthy, `api` attend
`db` healthy **et** `migrate` terminé avec succès.
> **Données** : la base et les médias sont des **bind mounts** vers l'hôte
> (`../db` et `../media` par défaut, réglables par `CLOUD_DB_DIR` /
> `CLOUD_MEDIA_DIR`). Ils vivent donc hors de `/var/lib/docker`, sur le gros
> disque. Seul `app_data` (sortie de build du front) reste un volume Docker.
> Un `docker compose down -v` ne supprime donc **pas** la base ni les médias.
> **Images** : la configuration nginx (CSP/HSTS, `limit_req`, snippets) est
> **copiée dans l'image**. Toute modification de `docker/nginx/` exige de
> reconstruire le service `nginx`. L'API embarque `sharp` (binaires précompilés