mirror of
https://github.com/Alkatrazz24/Funk-lab.git
synced 2026-07-12 07:34:43 +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
35
ansible/roles/rag/README.md
Normal file
35
ansible/roles/rag/README.md
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
# rag
|
||||
|
||||
Déploie la chaîne RAG sur storage-01 : scripts d'ingestion/requête + copie des docs + skill Hermes.
|
||||
|
||||
## Ce que fait le rôle
|
||||
|
||||
- Crée `/srv/data/rag/docs`
|
||||
- Déploie `/usr/local/bin/rag-ingest` et `/usr/local/bin/rag-query`
|
||||
- **Synchronise `admin/` du repo vers `/srv/data/rag/docs/`** (copie indexée)
|
||||
- Déploie le skill `rag-docs` dans les skills globaux Hermes + le profil funk-ai
|
||||
|
||||
## Variables principales
|
||||
|
||||
| Variable | Défaut |
|
||||
|---|---|
|
||||
| `rag_docs_dir` | `/srv/data/rag/docs` |
|
||||
| `qdrant_url` | `http://127.0.0.1:6333` |
|
||||
| `embed_url` | `http://192.168.10.20:1234/v1/embeddings` (llama-server GPU) |
|
||||
| `embed_model` | `qwen3-8b` |
|
||||
| `rag_collection` | `funk-docs` |
|
||||
|
||||
## Workflow après modification de `admin/`
|
||||
|
||||
```bash
|
||||
ansible-playbook -i inventory.yml playbooks/storage-01.yml --tags rag # re-sync les docs
|
||||
ssh storage-01 /usr/local/bin/rag-ingest # ré-indexe dans Qdrant
|
||||
```
|
||||
|
||||
(`hermes-auto-improve` fait aussi un rsync + rag-ingest en fin de run.)
|
||||
|
||||
## Caveats
|
||||
|
||||
- **Dépendances fortes** : Qdrant up (`:6333`) et llama-server GPU up (`:1234`) — sinon connection refused
|
||||
- `rag-ingest` parcourt **tout** `/srv/data/rag/docs` y compris `hermes/builtin/` (rapports du bot) — pollution potentielle des résultats, exclusion à prévoir
|
||||
- Les embeddings viennent du modèle de génération (Qwen3-8B) — un modèle d'embedding dédié (nomic-embed, bge-m3) est dans la roadmap
|
||||
Loading…
Add table
Add a link
Reference in a new issue