# Rapport Hermes — 2026-06-07_08-30
> Branche : `hermes/daily-work` · Fichiers analysés : 5

---
## Résumé
- ✅ À jour : 5
- ⚠️  À améliorer : 0

## ✅ `admin/install/README.md` — 7/10

**Statut** : à_jour  
**Résumé** : Document d'installation structuré avec ordre de déploiement et état des services mis à jour le 2026-06-05  

**Problèmes :**
- Le service litellm est désactivé alors que la configuration attendue indique qu'il devrait être actif
- Le service qdrant est en phase d'activation, ce qui pourrait signifier un retard ou une erreur de démarrage

**Suggestions :**
- Mettre à jour l'état du service litellm pour refléter la configuration actuelle
- Ajouter une note explicite sur la phase d'activation de qdrant et ses implications
- Inclure une section de vérification post-installation pour les services critiques

**État réel connu de Hermes :**  
Le document reflète correctement l'état du système le 2026-06-05, avec des services actifs (hermes, dnsmasq, nfs-server, postfix) et des services en cours d'activation (qdrant). Le litellm est désactivé, ce qui diverge de la configuration attendue.

---

## ✅ `admin/install/gpu-01.md` — 9/10

**Statut** : à_jour  
**Résumé** : Document d'installation complet et structuré pour gpu-01, couvrant from l'OS à la configuration ROCm. Inclut des sections clés et des workarounds critiques pour la RX 6700XT.  

**Problèmes :**
- La section des prérequis mentionne une vérification de l'état de storage-01 sans détails sur les commandes exactes à exécuter
- Le playbook Ansible référence un inventaire YAML incomplet (ligne coupée)
- Le workaround pour RX 6700XT manque d'explication technique sur pourquoi HSA_OVERRIDE_GFX_VERSION=10.3.0 est nécessaire

**Suggestions :**
- Ajouter une sous-section explicative sur le workaround ROCm GFX ID
- Compléter le fichier d'inventaire Ansible (gpu_hosts:  host...)
- Inclure des vérifications supplémentaires post-playbook pour les services critiques
- Ajouter une section 'Dépannage' avec les erreurs courantes liées à ROCm

**État réel connu de Hermes :**  
Opérationnel - La machine gpu-01 est en service avec llama-server ROCm, les modèles sont montés via NFS et les tests de connectivité réussissent

---

## ✅ `admin/install/kubernetes.md` — 9/10

**Statut** : à_jour  
**Résumé** : Document d'installation complet et structuré avec tous les étapes clés pour déployer un cluster Kubernetes, incluant des notes sur les pièges à éviter.  

**Problèmes :**
- La section 'Pièges et erreurs rencontrés' est mentionnée mais pas visible dans le texte fourni
- Les versions logicielles mentionnées (Talos v1.13.0, Kubernetes v1.33.1) devraient être vérifiées pour leur actualité
- Le schéma réseau est un peu simplifié et pourrait bénéficier d'une représentation plus détaillée

**Suggestions :**
- Ajouter une section sur la gestion des mises à jour du cluster
- Inclure des exemples concrets de commandes talosctl pour chaque étape
- Ajouter des notes de sécurité supplémentaires pour les configurations sensibles
- Mettre à jour les versions logicielles mentionnées avec des versions actuelles

**État réel connu de Hermes :**  
Le document correspond à l'architecture actuelle du cluster Funk, avec les mêmes machines et configurations réseau. Les étapes décrites sont applicables à la configuration existante.

---

## ✅ `admin/install/storage-01.md` — 8/10

**Statut** : à_jour  
**Résumé** : Document complet et bien structuré décrivant l'installation de storage-01, avec des étapes claires et des commandes pratiques. Certains détails techniques pourraient être enrichis.  

**Problèmes :**
- Manque des commandes spécifiques pour la surveillance du RAID5 (ex: smartctl)
- La section Ansible pourrait préciser les variables de playbook critiques
- Redondance dans les descriptions des interfaces réseau

**Suggestions :**
- Ajouter des exemples de commande smartctl pour surveiller le RAID5
- Inclure des snippets d'variables Ansible clés dans la section 5
- Simplifier les descriptions des interfaces réseau pour éviter la redondance

**État réel connu de Hermes :**  
Le document correspond à l'état actuel du système Funk, avec des configurations validées post-installation. Les composants IA (Hermes, LiteLLM) sont correctement décrits avec leurs dépendances.

---

## ✅ `admin/k8s/argocd.md` — 8/10

**Statut** : à_jour  
**Résumé** : Documentation complète sur l'implémentation GitOps avec ArgoCD dans le cluster Funk, avec des instructions claires pour l'installation et le déploiement.  

**Problèmes :**
- Le YAML pour le déploiement de chart Helm contient une erreur de syntaxe : 'server: https://kubernetes.default.svc ---Réponds' (barre oblique manquante)
- Le champ 'syncOptions' dans l'exemple de déploiement d'application manque de commentaires expliquant son utilisation
- Aucune mention des hooks ou webhooks pour les événements de déploiement automatique

**Suggestions :**
- Ajouter une section sur la gestion des secrets sensibles (ex: rotation des mots de passe ArgoCD)
- Mettre en avant les bonnes pratiques pour la sécurité des dépôts Git (ex: .gitignore, .dockerignore)
- Préciser les commandes pour vérifier l'état des applications ArgoCD (argocd app list, argocd app get)

**État réel connu de Hermes :**  
Le composant est actif dans le cluster Funk. Le repo Funk-lab est correctement configuré comme source de vérité. Les applications monitore sont déployées et fonctionnent via le pattern App of Apps.

---

