docs(ansible): README par rôle (19) + gaps IaC découverts à l'audit

Audit complet des rôles vs état réel du cluster. Chaque rôle a maintenant
un README.md : but, variables (défauts + surcharges host_vars/vault),
handlers, vérifications, caveats.

Gaps découverts et documentés :
- minio : rôle VIDE (tasks/main.yml sans aucune tâche), service inactif —
  placeholder à implémenter ou retirer (ports 9000/9001 ouverts pour rien)
- llama_server : ne gère que l'instance GPU :1234 — les services CPU
  llama-server-system :1236 et llama-server-monitor :1237 sont créés à la
  main sur gpu-01, non reproductibles par make apply-gpu (+ un
  llama-server-dev.service non documenté présent sur l'hôte)
- hermes_auto_improve : defaults port/repo/branch/log non consommés
  (valeurs en dur dans les scripts), défaut branch obsolète
- lm_studio : README de dépréciation, candidat suppression

Tables admin/ops/ansible.md, README.md et CLAUDE.md corrigées en conséquence.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Alkatrazz 2026-06-10 15:21:24 +02:00
parent 40fd7f0868
commit 0aa4c3650d
22 changed files with 538 additions and 6 deletions

View file

@ -7,7 +7,8 @@ Le venv est dans `.venv/`, le `Makefile` fournit les raccourcis.
## Playbooks et rôles
Deux playbooks, un par machine (le `site.yml` les enchaîne) :
Deux playbooks, un par machine (le `site.yml` les enchaîne).
Chaque rôle a un `README.md` détaillé dans `ansible/roles/<nom>/` (variables, caveats, gaps).
### `playbooks/storage-01.yml` — hosts `gateway` (15 rôles)
@ -20,7 +21,7 @@ Deux playbooks, un par machine (le `site.yml` les enchaîne) :
| `nfs_server` | `nfs_server` | Exports NFS (modèles LLM, volumes k8s) |
| `qdrant` | `qdrant` | Base vectorielle (RAG) — `:6333` |
| `postgresql` | `postgresql` | PG 16 — bases hermes, litellm, n8n, openwebui, grafana |
| `minio` | `minio` | Stockage objet S3 |
| `minio` | `minio` | ⚠️ **Rôle vide** (placeholder) — service inactif, à implémenter ou retirer |
| `litellm` | `litellm` | Proxy LLM `:4000` + script `ask-agent` |
| `hermes_agent` | `hermes_agent` | Agent Hermes + skills + souls |
| `rag` | `rag` | Scripts `rag-ingest` / `rag-query` + docs RAG |
@ -37,7 +38,7 @@ Deux playbooks, un par machine (le `site.yml` les enchaîne) :
| `common` | `common` | Paquets de base, sécurité, NTP |
| `rocm` | `rocm` | Stack GPU AMD (ROCm 7.x, `HSA_OVERRIDE_GFX_VERSION=10.3.0`) |
| `nfs_client` | `nfs_client` | Montage `/mnt/models` depuis storage-01 |
| `llama_server` | `llama_server` | llama-server ×3 : GPU `:1234`, CPU `:1236`/`:1237` |
| `llama_server` | `llama_server` | llama-server **GPU `:1234` uniquement** — ⚠️ les instances CPU `:1236`/`:1237` (system/monitor) sont des services créés à la main sur gpu-01, hors IaC |
| `node_exporter` | `node_exporter` | Métriques Prometheus (+ rocm power) |
> ⚠️ Le rôle `lm_studio` existe encore dans `ansible/roles/` mais n'est référencé par **aucun** playbook (remplacé par `llama_server` en mai 2026). Candidat à la suppression.