Funk-lab/admin/README.md
Hermes Bot 00e53fc0b8 docs(hermes): sections état vérifié — inspection cluster 2026-06-05
Ajout d'une section '## État vérifié' à chaque doc admin/ basée
sur l'inspection read-only du cluster (systemctl, kubectl, nft, etc.).
Aucune modification de service ni réécriture de documentation existante.

Co-Authored-By: Hermes <hermes@funk.lab>
2026-06-05 12:32:57 +02:00

90 lines
No EOL
3.3 KiB
Markdown

# Administration Funk — Index
## Navigation rapide
| Besoin | Fichier |
|---|---|
| Allumer / éteindre le homelab | [ops/cluster.md](ops/cluster.md) |
| Déployer quelque chose sur k8s | [k8s/argocd.md](k8s/argocd.md) |
| Débugger l'inférence LLM | [ia/llama_server.md](ia/llama_server.md) · [ia/rocm.md](ia/rocm.md) |
| Débugger Hermes / ask-agent | [ia/hermes.md](ia/hermes.md) |
| Voir les métriques / alertes | [k8s/monitoring.md](k8s/monitoring.md) |
| Problème réseau / nftables | [infra/reseau.md](infra/reseau.md) |
| Problème NFS / stockage | [infra/nfs.md](infra/nfs.md) |
| Incident passé | [incidents.md](incidents.md) |
---
## Guides d'installation (première mise en place)
| Guide | Cible |
|---|---|
| [install/storage-01.md](install/storage-01.md) | AlmaLinux + RAID5 + Ansible + stack IA complète |
| [install/gpu-01.md](install/gpu-01.md) | AlmaLinux + ROCm + llama-server (RX 6700XT) |
| [install/kubernetes.md](install/kubernetes.md) | Talos + MetalLB + Traefik + DNS wildcard + NFS + monitoring |
---
## ops/ — Opérations quotidiennes
| Fichier | Contenu |
|---|---|
| [ops/cluster.md](ops/cluster.md) | `funk-start`, `funk-stop`, `funk-status` — démarrage/arrêt cluster complet |
| [ops/ansible.md](ops/ansible.md) | Commandes Ansible — ping, apply, vault, debug, facts |
| [ops/systeme.md](ops/systeme.md) | Services systemd, logs, ressources, NetworkManager, dnf |
---
## infra/ — Infrastructure socle
| Fichier | Contenu |
|---|---|
| [infra/reseau.md](infra/reseau.md) | nftables, IP forwarding, routage, NAT, debug |
| [infra/nfs.md](infra/nfs.md) | NFS + RAID5 — exports, montages, automount, ajout de partages |
| [infra/dnsmasq.md](infra/dnsmasq.md) | DNS local `lab.local` — résolution, logs, ajout d'entrées |
| [infra/ssh.md](infra/ssh.md) | Connexions SSH — alias, jump host, transfert de fichiers |
---
## k8s/ — Cluster Kubernetes
| Fichier | Contenu |
|---|---|
| [k8s/talos.md](k8s/talos.md) | Talos Linux — talhelper, nœuds, upgrades, backup etcd |
| [k8s/argocd.md](k8s/argocd.md) | ArgoCD GitOps — App of Apps, déploiement, dépannage |
| [k8s/monitoring.md](k8s/monitoring.md) | Grafana · Prometheus · AlertManager — métriques, dashboards, alertes |
---
## ia/ — Stack IA Funk
| Fichier | Contenu |
|---|---|
| [ia/llama_server.md](ia/llama_server.md) | llama-server — 3 instances (GPU+CPU), métriques, build, modèles |
| [ia/rocm.md](ia/rocm.md) | GPU RX 6700XT — ROCm, `HSA_OVERRIDE_GFX_VERSION`, debug |
| [ia/litellm.md](ia/litellm.md) | LiteLLM Proxy — routage Qwen local + Claude API, config, validation |
| [ia/hermes.md](ia/hermes.md) | Hermes Agent + ask-agent — profils, skills, SOUL.md, délégation |
---
## incidents.md
[incidents.md](incidents.md) — historique des incidents avec causes, résolutions et fixes permanents.
---
## État vérifié — 2026-06-05
- **litellm** : inactive (désactivé)
- **hermes** : active
- **dnsmasq** : active
- **nfs-server** : active
- **qdrant** : active
Divergences notées :
- Le service `litellm` est **inactive** alors que la documentation antérieure suggérait un fonctionnement actif.
- Aucune version spécifique des services ne figure dans l'état brut.
Éléments opérationnels :
- Aucun pod crashé signalé dans les namespaces Kubernetes.
- L'export NFS semble fonctionner normalement (service nfs-server actif).