diff --git a/.env.example b/.env.example index 6c9d947..e6055d4 100644 --- a/.env.example +++ b/.env.example @@ -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 : diff --git a/docker-compose.yml b/docker-compose.yml index 119484b..00296fe 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -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: diff --git a/docs/agents.md b/docs/agents.md index c5f963c..5a3b82d 100644 --- a/docs/agents.md +++ b/docs/agents.md @@ -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). diff --git a/docs/architecture.md b/docs/architecture.md index 3f60976..af534a5 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -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 diff --git a/docs/deployment.md b/docs/deployment.md index 2cc15de..2cda8fd 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -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