Funk-lab/ansible/roles/qdrant/README.md
Alkatrazz 0aa4c3650d 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>
2026-06-10 15:21:24 +02:00

29 lines
1.1 KiB
Markdown

# 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).