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

---
## Résumé
- ✅ À jour : 2
- ⚠️  À améliorer : 3

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

**Statut** : à_jour  
**Résumé** : Documentation d'installation structurée avec état des services et ordre d'installation, mais manque de détails opérationnels sur les étapes de configuration  

**Problèmes :**
- Le service litellm est désactivé alors que le guide indique qu'il devrait être actif
- L'état de qdrant est en phase d'activation, ce qui pourrait signifier un retard ou une erreur de démarrage
- Aucun script d'installation ou commande spécifique n'est fourni dans le document

**Suggestions :**
- Ajouter des étapes précises pour activer litellm et vérifier son fonctionnement
- Préciser les dépendances entre les services (ex: DNS avant les nœuds Kubernetes)
- Inclure des exemples de commandes pour configurer les services mentionnés
- Mettre à jour la section 'État vérifié' avec les dates de dernière vérification

**État réel connu de Hermes :**  
storage-01 : litellm (inactif), hermes (actif), dnsmasq (actif), nfs-server (actif), qdrant (activation en cours), postfix (actif)

---

## ⚠️ `admin/install/gpu-01.md` — 7/10

**Statut** : obsolète  
**Résumé** : Document complet mais contient des incohérences (AlmaLinux 9.8 vs 9.7 dans l'architecture) et manque de détails sur la configuration ROCm  

**Problèmes :**
- Mentionne AlmaLinux 9.8 dans l'installation mais l'architecture déclare AlmaLinux 9.7
- Le workaround HSA_OVERRIDE_GFX_VERSION manque de contexte technique
- Pas de détails sur la configuration ROCm 7.x spécifique aux RX 6700XT
- La section des pièges ne précise pas les étapes de vérification des permissions NFS

**Suggestions :**
- Mettre à jour la version AlmaLinux pour aligner avec l'architecture (9.7)
- Ajouter une section détaillée sur la configuration ROCm avec des exemples de commandes
- Inclure un check-list pour vérifier les permissions NFS et les symlinks
- Ajouter des notes sur les dépendances logicielles requises pour ROCm 7.x

**État réel connu de Hermes :**  
AlmaLinux 9.7 / Linux 5.14.0-687.5.3.el9_8.x86_64 avec ROCm 7.x fonctionnel sur RX 6700XT (gfx1031)

---

## ⚠️ `admin/install/kubernetes.md` — 8/10

**Statut** : incomplet  
**Résumé** : Document d'installation complet avec structure claire, mais plusieurs sections contiennent des ellipses (...) suggérant des contenus manquants ou incomplets.  

**Problèmes :**
- Sections 2 à 19 contiennent des ellipses (...) indiquant des parties manquantes
- Manque de détails sur les étapes critiques comme la configuration réseau et les erreurs rencontrées
- La section 'Pièges et erreurs rencontrés' est incomplète

**Suggestions :**
- Compléter toutes les sections avec des détails opérationnels
- Ajouter des exemples concrets de commandes et de configurations
- Documenter les erreurs rencontrées avec des solutions détaillées
- Ajouter des captures d'écran ou des schémas pour les étapes complexes

**État réel connu de Hermes :**  
Le cluster Kubernetes est installé selon ce document, mais les sections incomplètes pourraient entraîner des risques d'erreurs lors de futurs maintenances

---

## ⚠️ `admin/install/storage-01.md` — 7/10

**Statut** : incomplet  
**Résumé** : Document complet sur l'installation de storage-01 avec des sections claires, mais contient des sections incomplètes et des placeholders non remplacés.  

**Problèmes :**
- Section 7 'Jouer le playbook' est incomplète (cut-off avec 'Mis---')
- Repo Git contient un placeholder 'yourusername/funk-homelab.git' non remplacé
- Aucune mention des étapes de vérification post-installation des services critiques (Hermes, LiteLLM, Qdrant)
- La configuration RAID5 mentionne un disque errant mais sans procédure de vérification SMART
- Le playbook phase 3 est incomplet

**Suggestions :**
- Compléter la section sur le playbook avec les phases manquantes
- Remplacer le placeholder du repo Git avec l'URL réelle
- Ajouter une vérification SMART des disques RAID5 avec 'smartctl'
- Documenter les étapes de test des services post-installation
- Ajouter une note sur la sécurisation du fichier vault_password_file

**État réel connu de Hermes :**  
Le document décrit une installation fonctionnelle, mais des sections critiques sont incomplètes et nécessitent des mises à jour pour garantir une installation réussie.

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète et actualisée sur la configuration d'ArgoCD dans le cluster Funk, avec des instructions claires pour l'installation, la gestion et le déploiement d'applications.  

**Problèmes :**
- La version Helm spécifiée (9.5.14) pourrait être obsolète si une version plus récente est disponible.
- Le mot de passe initial est récupéré via kubectl, mais aucun avertissement n'est donné sur la suppression du secret après changement du mot de passe (bien que mentionné dans le texte).

**Suggestions :**
- Mettre à jour la version Helm vers la dernière version stable disponible.
- Ajouter une note explicite sur la sécurisation du secret initial et la suppression du secret après modification du mot de passe.

**État réel connu de Hermes :**  
Tous les applications ArgoCD sont synchronisés (Synced) et en état santé (Healthy). Les pods critiques (argocd-application-controller, argocd-repo-server, argocd-server) sont actifs sans restarts. Aucune divergence avec la documentation.

---