akadmin/Funk-lab

mirror of https://github.com/Alkatrazz24/Funk-lab.git synced 2026-07-08 09:24:43 +02:00

History

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
..
hermes/builtin	docs(hermes): rapport analyse 2026-06-05_11-30 — 5 fichiers	2026-06-05 11:32:58 +02:00
ia	docs: synchroniser la doc avec l'état réel du cluster (revue Ansible + incident Qdrant)	2026-06-10 15:11:53 +02:00
infra	docs(email): masquer exemple App Password dans la doc	2026-05-17 16:54:20 +02:00
install	docs: kubernetes — section NFS provisioner complète (install, usage, admin, pièges)	2026-05-13 22:10:26 +02:00
k8s	docs: synchroniser la doc avec l'état réel du cluster (revue Ansible + incident Qdrant)	2026-06-10 15:11:53 +02:00
ops	docs(ansible): README par rôle (19) + gaps IaC découverts à l'audit	2026-06-10 15:21:24 +02:00
funk-cluster	docs(admin): add ops documentation and fix hermes dashboard service	2026-05-12 18:50:43 +02:00
incidents.md	docs: synchroniser la doc avec l'état réel du cluster (revue Ansible + incident Qdrant)	2026-06-10 15:11:53 +02:00
index_knowledge.py	docs: mise à jour documentation — NVMe, Qwen3, gaps IaC	2026-05-30 22:58:24 +02:00
README.md	docs: réorganisation complète de admin/ en 4 domaines thématiques	2026-05-14 00:47:58 +02:00

README.md

Administration Funk — Index

Besoin	Fichier
Allumer / éteindre le homelab	ops/cluster.md
Déployer quelque chose sur k8s	k8s/argocd.md
Débugger l'inférence LLM	ia/llama_server.md · ia/rocm.md
Débugger Hermes / ask-agent	ia/hermes.md
Voir les métriques / alertes	k8s/monitoring.md
Problème réseau / nftables	infra/reseau.md
Problème NFS / stockage	infra/nfs.md
Incident passé	incidents.md

Guides d'installation (première mise en place)

Guide	Cible
install/storage-01.md	AlmaLinux + RAID5 + Ansible + stack IA complète
install/gpu-01.md	AlmaLinux + ROCm + llama-server (RX 6700XT)
install/kubernetes.md	Talos + MetalLB + Traefik + DNS wildcard + NFS + monitoring

ops/ — Opérations quotidiennes

Fichier	Contenu
ops/cluster.md	`funk-start`, `funk-stop`, `funk-status` — démarrage/arrêt cluster complet
ops/ansible.md	Commandes Ansible — ping, apply, vault, debug, facts
ops/systeme.md	Services systemd, logs, ressources, NetworkManager, dnf

infra/ — Infrastructure socle

Fichier	Contenu
infra/reseau.md	nftables, IP forwarding, routage, NAT, debug
infra/nfs.md	NFS + RAID5 — exports, montages, automount, ajout de partages
infra/dnsmasq.md	DNS local `lab.local` — résolution, logs, ajout d'entrées
infra/ssh.md	Connexions SSH — alias, jump host, transfert de fichiers

k8s/ — Cluster Kubernetes

Fichier	Contenu
k8s/talos.md	Talos Linux — talhelper, nœuds, upgrades, backup etcd
k8s/argocd.md	ArgoCD GitOps — App of Apps, déploiement, dépannage
k8s/monitoring.md	Grafana · Prometheus · AlertManager — métriques, dashboards, alertes

ia/ — Stack IA Funk

Fichier	Contenu
ia/llama_server.md	llama-server — 3 instances (GPU+CPU), métriques, build, modèles
ia/rocm.md	GPU RX 6700XT — ROCm, `HSA_OVERRIDE_GFX_VERSION`, debug
ia/litellm.md	LiteLLM Proxy — routage Qwen local + Claude API, config, validation
ia/hermes.md	Hermes Agent + ask-agent — profils, skills, SOUL.md, délégation

incidents.md

incidents.md — historique des incidents avec causes, résolutions et fixes permanents.