recovery: recuperation commit local orphelin (master jamais pousse) - HEBERGEMENT-SITES-STATIQUES.md
This commit is contained in:
parent
6bb3c1e986
commit
afc8fb8370
|
|
@ -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`
|
||||||
Loading…
Reference in New Issue