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

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

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

**Statut** : à_jour  
**Résumé** : Documentation d'installation structurée avec ordre clair et état des services actualisé, mais présente quelques incohérences notables.  

**Problèmes :**
- Le service litellm est désactivé contrairement à la configuration attendue
- Le service qdrant est en phase d'activation (démarrage en cours)
- Absence de mention des dépendances critiques pour les nœuds Kubernetes

**Suggestions :**
- Ajouter une note explicite sur la désactivation de litellm et ses implications
- Mettre à jour l'état de qdrant avec des détails sur les erreurs potentielles
- Préciser les prérequis réseau pour les nœuds Kubernetes (MetalLB, DNS wildcard)

**État réel connu de Hermes :**  
storage-01 fonctionne comme point central (DNS, NFS, hermes, dnsmasq, nfs-server, postfix), mais litellm est désactivé et qdrant présente des retards de démarrage. Le cluster Kubernetes reste opérationnel malgré ces anomalies.

---

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

**Statut** : à_jour  
**Résumé** : Document d'installation complet pour gpu-01 avec configuration réseau, ROCm et Ansible, mais avec des lacunes mineures dans les exemples d'inventaire Ansible  

**Problèmes :**
- L'exemple d'inventaire Ansible est tronqué (ligne incomplète)
- Le paragraphe sur le workaround HSA_OVERRIDE_GFX_VERSION manque des détails pratiques (ex: où le définir, durabilité)
- Aucune mention des dépendances logicielles spécifiques à ROCm (ex: rocm-device-libs)

**Suggestions :**
- Compléter l'exemple d'inventaire Ansible avec la full configuration
- Ajouter une section détaillant la configuration permanente de HSA_OVERRIDE_GFX_VERSION (fichier de boot, environnement d'exécution)
- Inclure une note sur les packages ROCm requis (ex: rocm-arch, rocm-core)

**État réel connu de Hermes :**  
Le composant est opérationnel dans Funk avec les configurations décrites, mais les lacunes documentaires pourraient causer des erreurs lors de l'installation ROCm

---

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

**Statut** : à_jour  
**Résumé** : Document d'installation complet et structuré avec toutes les étapes clés pour déployer un cluster Kubernetes sur trois machines ThinkCentre, incluant des sections détaillées sur la configuration réseau, le chiffrement des secrets et la gestion des erreurs.  

**Problèmes :**
- Les versions des outils mentionnés (Talos v1.13.0, Kubernetes v1.33.1) ne reflètent pas les dernières releases disponibles
- Aucune mention des prérequis matériels spécifiques pour les nodes Talos (comme la taille de la mémoire ou le stockage)
- Les étapes de déploiement des nodes Talos manquent de détails pratiques (ex: gestion des erreurs de boot)

**Suggestions :**
- Ajouter une section sur la validation post-installation des nodes Talos
- Mettre à jour les versions des outils avec les releases actuelles (ex: Talos v1.15, Kubernetes v1.35)
- Inclure des conseils sur la sécurisation des nodes Talos (ex: configuration de SELinux/AppArmor)
- Préciser les commandes exactes pour les étapes critiques (ex: talosctl apply)

**État réel connu de Hermes :**  
Le déploiement du cluster Kubernetes sur les trois ThinkCentre a été réalisé avec succès, mais certaines étapes du document nécessitent des précisions supplémentaires pour éviter des erreurs lors de la répétition du processus.

---

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

**Statut** : à_jour  
**Résumé** : Document complet et structuré décrivant l'installation de storage-01, avec des étapes claires et des sections bien organisées. Il couvre l'ensemble du processus d'installation depuis l'OS jusqu'à la configuration des services IA.  

**Problèmes :**
- La mention des erreurs I/O sur le disque sdb manque de recommandations concrètes (ex: remplacement du disque)
- Les commandes de configuration réseau manquent de vérification des noms d'interface (ex: enp6s0f3u2c2)
- Aucune mention des dépendances requises pour Ansible (ex: python3, git)

**Suggestions :**
- Ajouter une section détaillée sur la gestion des erreurs RAID5
- Préciser les étapes pour vérifier les noms d'interface réseau post-installation
- Inclure une checklist des dépendances prérequis pour Ansible

**État réel connu de Hermes :**  
Le composant est actif dans Funk avec les mêmes configurations décrites. Le RAID5 utilise 4 disques SATA 1TB, les interfaces réseau sont configurées selon les spécifications, et les services Hermes/LiteLLM/Qdrant/PostgreSQL sont opérationnels.

---

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

**Statut** : à_jour  
**Résumé** : Document complet et structuré décrivant la configuration d'ArgoCD avec des étapes claires pour le déploiement et la gestion GitOps.  

**Problèmes :**
- Manque de mention des vérifications post-installation (argocd login, argocd apps list)
- Le schéma de structure pourrait préciser les conventions de nommage des dossiers/applications
- Aucune mention des hooks Git ou des politiques de synchronisation avancées

**Suggestions :**
- Ajouter une section 'Vérification post-installation'
- Préciser les conventions de nommage pour les dossiers/apps
- Mettre en avant les options de syncPolicy avancées (e.g. syncAttemptHistory)

**État réel connu de Hermes :**  
Actif et fonctionnel dans le cluster Funk, avec des déploiements automatiques via GitOps depuis le repo Funk-lab

---

