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

---
## Résumé
- ✅ À jour : 4
- ⚠️  À améliorer : 1

## ⚠️ `admin/install/README.md` — 4/10

**Statut** : incomplet  
**Résumé** : Le fichier contient uniquement une table des matières sans les guides d'installation réels, rendant le document inutilisable.  

**Problèmes :**
- Absence des guides d'installation détaillés pour chaque machine
- Les références vers les fichiers (storage-01.md, etc.) ne sont pas incluses dans le document
- Manque de versions spécifiques des logiciels (ex: versions de AlmaLinux, ROCm)
- Pas de section sur la vérification des étapes d'installation
- Aucune information sur les dépannages courants

**Suggestions :**
- Ajouter les guides d'installation complets pour chaque machine
- Spécifier les versions exactes des logiciels et dépendances
- Inclure une section 'Vérification' après chaque étape
- Ajouter une section 'Dépannage courant' avec exemples de problèmes
- Mettre à jour les références vers les fichiers associés

**État réel connu de Hermes :**  
Le document est une table des matières incomplète sans contenu concret, les guides réels sont probablement absents ou non mis à jour

---

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

**Statut** : à_jour  
**Résumé** : Document complet et structuré décrivant l'installation de gpu-01 avec des étapes claires, mais nécessite quelques mises à jour sur les versions ROCm et des précisions supplémentaires sur les configurations réseau.  

**Problèmes :**
- La mention de gfx1031 pour RX 6700XT pourrait être vérifiée avec la documentation ROCm la plus récente
- Le playbook Ansible référencé manque de détails concrets sur les tâches exécutées
- Aucune mention des dépendances spécifiques à ROCm 7.x
- Les commandes de vérification post-install sont limitées à des tests basiques

**Suggestions :**
- Ajouter une note sur la vérification des versions ROCm compatibles avec gfx1031
- Préciser les tâches clés du playbook Ansible (ex: installation ROCm, configuration NFS)
- Inclure des commandes pour vérifier l'importation des modèles via NFS
- Mettre à jour le workaround HSA_OVERRIDE_GFX_VERSION avec la documentation officielle ROCm

**État réel connu de Hermes :**  
gpu-01 est actif dans le cluster, le playbook Ansible fonctionne, les services ROCm sont opérationnels avec le workaround appliqué

---

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

**Statut** : à_jour  
**Résumé** : Document d'installation complet et structuré avec des sections claires, mais présente un petit problème de formatage dans le code Ansible.  

**Problèmes :**
- La section 2 contient un code Ansible incomplet (« ba--- ») qui pourrait être un artefact de mise en forme

**Suggestions :**
- Corriger le code Ansible incomplet dans la section 2
- Ajouter une note explicite sur la gestion des erreurs dans la section « Pièges et erreurs rencontrés »

**État réel connu de Hermes :**  
Le cluster Kubernetes est opérationnel avec les configurations décrites, mais la documentation manque d'une section complète sur les erreurs et les solutions.

---

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

**Statut** : à_jour  
**Résumé** : Document d'installation complet pour storage-01 avec structure claire, mais manque de détails sur la configuration RAID5, les vérifications post-install, et des étapes de dépannage.  

**Problèmes :**
- Section 9 (Pièges et incidents) est vide
- Aucune vérification du statut RAID5 post-installation
- Pas de détails sur la gestion des erreurs I/O des disques
- Manque de commande pour vérifier les exports NFS
- Section 'Jouer le playbook' ne précise pas les playbooks utilisés

**Suggestions :**
- Ajouter une section sur la vérification du statut RAID5 avec 'cat /proc/mdstat'
- Inclure des commandes pour tester les exports NFS (exportfs -va)
- Documenter les étapes pour remplacer un disque RAID
- Spécifier les playbooks Ansible utilisés dans la section 7
- Ajouter un exemple de script pour surveiller la santé des disques

**État réel connu de Hermes :**  
Le document correspond à l'état actuel du cluster, mais manque de détails opérationnels critiques pour la maintenance post-installation.

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète sur l'implémentation GitOps avec ArgoCD dans Funk, couvrant installation, structure et déploiement, mais avec quelques améliorations possibles.  

**Problèmes :**
- Le YAML d'exemple pour le déploiement de chart Helm contient une erreur de format (--- à la fin de l'URL)
- Pas de mention des bonnes pratiques de sécurité comme la rotation du mot de passe initial ou la gestion des clés SSH
- La version d'ArgoCD (9.5.14) n'est pas vérifiée comme étant la dernière stable

**Suggestions :**
- Mettre à jour la version d'ArgoCD vers la dernière stable pour garantir la sécurité et les fonctionnalités
- Corriger le typo dans le YAML d'exemple (enlever le --- à la fin de l'URL)
- Ajouter une section sur les bonnes pratiques de sécurité (rotation des mots de passe, gestion des clés SSH)

---

