mirror of
https://github.com/Alkatrazz24/Funk-lab.git
synced 2026-07-13 04:54:42 +02:00
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:
parent
40fd7f0868
commit
0aa4c3650d
22 changed files with 538 additions and 6 deletions
29
ansible/roles/qdrant/README.md
Normal file
29
ansible/roles/qdrant/README.md
Normal file
|
|
@ -0,0 +1,29 @@
|
|||
# qdrant
|
||||
|
||||
Base vectorielle Qdrant sur storage-01 — mémoire sémantique du RAG (collection `funk-docs`).
|
||||
|
||||
## Ce que fait le rôle
|
||||
|
||||
- User système `qdrant`, données dans `/srv/data/qdrant` (NVMe)
|
||||
- Télécharge le binaire (version pinnée), upgrade seulement si la version installée diffère
|
||||
- Config `/opt/qdrant/config.yaml` + service systemd
|
||||
|
||||
## Variables principales
|
||||
|
||||
| Variable | Défaut |
|
||||
|---|---|
|
||||
| `qdrant_version` | `1.13.4` |
|
||||
| `qdrant_http_port` / `qdrant_grpc_port` | 6333 / 6334 |
|
||||
| `qdrant_host` | `0.0.0.0` (filtré par nftables — LAN cluster seulement) |
|
||||
| `qdrant_data_dir` | `/srv/data/qdrant` |
|
||||
|
||||
## Vérifications
|
||||
|
||||
```bash
|
||||
curl -s http://127.0.0.1:6333/collections
|
||||
systemctl status qdrant
|
||||
```
|
||||
|
||||
## Caveat — crash-loop silencieux
|
||||
|
||||
Si un segment de collection est corrompu, Qdrant panique au boot et reste en `activating (auto-restart)` — **invisible dans `systemctl --state=failed`**. Symptôme : port 6333 fermé, `rag-query` en connection refused. Réparation : supprimer la collection corrompue et ré-ingérer (voir `admin/incidents.md` 2026-06-05).
|
||||
Loading…
Add table
Add a link
Reference in a new issue