From afc8fb8370cedb4c784136176d4c23e007f61ec6 Mon Sep 17 00:00:00 2001
From: bolbol <nabil.derouiche@gmx.com>
Date: Thu, 2 Jul 2026 21:13:01 +0000
Subject: [PATCH] recovery: recuperation commit local orphelin (master jamais
 pousse) - HEBERGEMENT-SITES-STATIQUES.md

---
 common/HEBERGEMENT-SITES-STATIQUES.md | 136 ++++++++++++++++++++++++++
 1 file changed, 136 insertions(+)
 create mode 100644 common/HEBERGEMENT-SITES-STATIQUES.md

diff --git a/common/HEBERGEMENT-SITES-STATIQUES.md b/common/HEBERGEMENT-SITES-STATIQUES.md
new file mode 100644
index 0000000..60aaf43
--- /dev/null
+++ b/common/HEBERGEMENT-SITES-STATIQUES.md
@@ -0,0 +1,136 @@
+# Hébergement de sites statiques produits par Hermes
+
+**Date** : 2026-06-20  
+**Origine** : Incident panda-dashboard — site hors ligne après redémarrage Container Manager  
+**Applicable** : hermes-tt, hermes-nyora, hermes-perso
+
+---
+
+## LE PROBLÈME À NE JAMAIS REPRODUIRE
+
+Hermes-nyora avait servi panda-dashboard via `python3 -m http.server` lancé depuis son
+propre workspace. Quand Container Manager redémarre, le container Hermes redémarre et
+le process Python meurt — sans aucune relance automatique.
+
+**Un agent Hermes NE DOIT PAS héberger un site en production.**  
+Le workspace d'un agent est éphémère du point de vue de la disponibilité service.
+
+---
+
+## LA RÈGLE
+
+> Tout site statique produit par Hermes doit être déployé dans son propre container
+> Docker dédié avec `restart: always`, via un docker-compose dans `/volume1/docker/`.
+
+---
+
+## PROCÉDURE — Déployer un site statique
+
+### 1. Identifier un port libre
+
+Lire `/volume1/docker/ports-registry.md` (accessible depuis l'agent : `/opt/data/workspace/../../../ports-registry.md` — non, passer par l'outil NAS ou demander à Claude).
+
+Plages recommandées : 3040-3099, 8800-8899.
+
+### 2. Créer le docker-compose dans /volume1/docker/
+
+L'agent écrit le fichier dans son workspace, puis demande au MCP NAS de le déplacer.
+Ou bien Claude le crée directement via mcp-nas.
+
+**Template à copier :**
+
+```yaml
+# <nom-du-site> — description courte
+# Port : <PORT> — <domaine.bolbol.tn>
+
+services:
+  <nom-du-site>:
+    image: nginx:alpine
+    container_name: <nom-du-site>
+    restart: always
+    ports:
+      - "<PORT>:80"
+    volumes:
+      - /volume1/docker/hermes-platform/hermes-<instance>/data/workspace/<dossier-site>:/usr/share/nginx/html:ro
+    networks:
+      - n8n_default
+
+networks:
+  n8n_default:
+    external: true
+```
+
+### 3. Déployer via API Portainer
+
+Portainer est accessible sur `http://172.17.0.1:9000` depuis les containers Docker.
+
+```bash
+# Obtenir JWT
+JWT=$(curl -s -X POST http://172.17.0.1:9000/api/auth \
+  -H "Content-Type: application/json" \
+  -d '{"username":"bestof","password":"2L2u519wportainer"}' \
+  | grep -o '"jwt":"[^"]*"' | cut -d'"' -f4)
+
+# Créer le stack (endpointId=2 = local)
+curl -s -X POST "http://172.17.0.1:9000/api/stacks/create/standalone/string?endpointId=2" \
+  -H "Authorization: Bearer $JWT" \
+  -H "Content-Type: application/json" \
+  -d "{
+    \"name\": \"<nom-du-site>\",
+    \"stackFileContent\": $(cat /chemin/vers/docker-compose.yml | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))'),
+    \"env\": []
+  }"
+```
+
+**Vérification :**
+```bash
+JWT=<JWT_OBTENU>
+curl -s "http://172.17.0.1:9000/api/endpoints/2/docker/containers/json?filters=%7B%22label%22%3A%5B%22com.docker.compose.project%3D<nom-du-site>%22%5D%7D" \
+  -H "Authorization: Bearer $JWT" | python3 -c "
+import json,sys
+for c in json.load(sys.stdin):
+    print(c['Names'], c['State'], c['Status'])
+"
+```
+
+### 4. Configurer le Reverse Proxy DSM
+
+DSM → Panneau de configuration → Portail d'applications → Proxy inversé :
+- Source : HTTPS, `<nom>.bolbol.tn`, port 443
+- Destination : HTTP, `192.168.100.33`, port `<PORT>`
+
+### 5. Mettre à jour ports-registry.md
+
+```bash
+# Ajouter la ligne dans le tableau Services Actifs
+# Marquer le port comme OCCUPE dans Plages libres
+# Ajouter une ligne dans Historique des modifications
+```
+
+### 6. Commit Gitea
+
+```bash
+cd /volume1/docker/<nom-du-site>
+git init
+git add .
+git commit -m "deploy: <nom-du-site> nginx statique port <PORT>"
+git push http://bolbol:2L2u519wgitea@192.168.100.33:3232/bolbol/nas-runbooks.git
+```
+
+---
+
+## EXEMPLE CONCRET — panda-dashboard (2026-06-20)
+
+- **Dossier source** : `/volume1/docker/hermes-platform/hermes-nyora/data/workspace/panda-dashboard/`
+- **Port** : 3021
+- **Domaine** : panda.bolbol.tn
+- **Stack Portainer** : ID 314
+- **Compose** : `/volume1/docker/panda-dashboard/docker-compose.yml`
+
+---
+
+## RAPPEL SÉCURITÉ
+
+- Ne jamais stocker de données sensibles dans le workspace monté en lecture publique
+- Le volume est monté `:ro` (read-only) — le container nginx ne peut pas modifier les fichiers
+- Le mot de passe Portainer est dans `/volume1/docker/hermes-platform/.env`