mirror of
https://github.com/Alkatrazz24/Funk-lab.git
synced 2026-07-09 00:14:42 +02:00
Structure avant : 20 fichiers à plat dans admin/ — difficile à naviguer.
Structure après : 4 sous-répertoires thématiques + index clair.
Réorganisation :
admin/ops/ → cluster.md, ansible.md, systeme.md
admin/infra/ → reseau.md, nfs.md, dnsmasq.md, ssh.md
admin/k8s/ → talos.md, argocd.md, monitoring.md
admin/ia/ → llama_server.md, rocm.md, litellm.md, hermes.md
Suppressions :
- ask-agent.md : contenu fusionné dans ia/hermes.md (section ask-agent)
- lm_studio.md : obsolète (LM Studio remplacé par llama-server)
Mises à jour contenu :
- ia/hermes.md : fusion complète avec ask-agent.md (profils, skills,
SOUL.md, ask-agent CLI, dépannage) — doc unifiée sans redondance
- ops/cluster.md : section GitOps réduite à 2 lignes + lien argocd.md
- incidents.md : tableau de résumé en tête + 4 nouveaux incidents
(Grafana OOMKilled, AlertManager null receiver, llama-server 501,
nftables règle après drop)
- README.md : réécrit — navigation rapide + index par domaine
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
Administration Funk — Index
Navigation rapide
| 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.