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

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

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

**Statut** : à_jour  
**Résumé** : Document structuré décrivant les guides d'installation avec ordre recommandé, mais manquant de détails opérationnels pour chaque étape  

**Problèmes :**
- Les fichiers de guide (storage-01.md, gpu-01.md, kubernetes.md) référencés ne sont pas inclus dans le contenu fourni
- Aucune information sur les versions spécifiques des logiciels ou OS
- Pas de section dédiée aux dépannages ou résolution des problèmes
- Manque de précisions sur les prérequis techniques spécifiques (ex: configuration RAID5)

**Suggestions :**
- Ajouter des étapes détaillées pour chaque guide d'installation
- Inclure des notes sur les versions critiques des logiciels (ex: AlmaLinux 9.7, Talos v1.13)
- Ajouter une section 'Problèmes courants' avec solutions
- Préciser les paramètres de configuration spécifiques (ex: HSA_OVERRIDE_GFX_VERSION=10.3.0)

---

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

**Statut** : à_jour  
**Résumé** : Document complet et structuré décrivant l'installation de gpu-01 avec des étapes claires, des configurations réseau, et un workaround critique pour ROCm sur RX 6700XT  

**Problèmes :**
- Manque de version spécifique de l'ISO AlmaLinux (9.7 minimal)
- Le workaround ROCm est présenté comme une 'solution de contournement' sans mention des risques liés à la stabilité
- Aucune mention des dépendances logicielles spécifiques à ROCm (ex: hip compiler)

**Suggestions :**
- Ajouter la version exacte de l'ISO utilisée (ex: AlmaLinux-9.7-x86_64-minimal-9.7.0-20230828.iso)
- Mettre en évidence le risque de compatibilité à long terme avec le workaround HSA_OVERRIDE_GFX_VERSION
- Ajouter une section sur la vérification du fonctionnement de ROCm après l'installation (ex: `rocprof --version`)

**État réel connu de Hermes :**  
gpu-01 est opérationnel dans Funk avec llama-server ROCm fonctionnant sur RX 6700XT via le workaround documenté

---

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

**Statut** : à_jour  
**Résumé** : Document complet et structuré avec une bonne organisation, mais manque de détails techniques et de configurations spécifiques dans certaines sections.  

**Problèmes :**
- La section 'Stockage persistant — NFS provisioner' manque de détails sur la configuration exacte du provisioner NFS.
- La section 'Pièges et erreurs rencontrés' est mentionnée mais non développée, ce qui pourrait laisser des problèmes non documentés.
- Les exemples d'Ansible pour dnsmasq/nftables sont incomplets (début incorrect avec 'ba---')
- La configuration Talos est décrite mais manque de commandes spécifiques pour la gestion des nœuds.
- La section 'Bootstrap etcd' ne fournit pas de détails sur le processus de bootstrap.

**Suggestions :**
- Ajouter des exemples concrets d'Ansible pour dnsmasq/nftables
- Développer la section 'Pièges et erreurs' avec des cas réels rencontrés
- Inclure des commandes spécifiques pour la configuration Talos
- Préciser les étapes du bootstrap etcd avec des instructions détaillées
- Ajouter une vérification finale avec des tests concrets à exécuter

**État réel connu de Hermes :**  
Le document correspond à l'architecture actuelle de Funk, avec les mêmes machines et stack logicielle. Les sections sur Talos et les outils de chiffrement sont correctement alignées avec l'infrastructure existante.

---

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

**Statut** : à_jour  
**Résumé** : Document complet et structuré avec des étapes claires pour l'installation de storage-01, mais nécessite quelques améliorations pour clarifier les détails techniques et les risques.  

**Problèmes :**
- La section RAID5 manque des instructions précises pour la surveillance des disques (smartctl)
- Le playbook Ansible n'est pas détaillé avec des exemples de commandes spécifiques
- Le paragraphe sur les interfaces réseau manque une explication des noms d'interfaces non intuitifs

**Suggestions :**
- Ajouter une section détaillée sur la configuration du RAID5 avec des exemples de commandes smartctl
- Inclure des captures d'écran ou des exemples de commandes Ansible pour chaque playbook
- Mettre en évidence les risques liés aux disques SATA et recommander des mesures préventives

**État réel connu de Hermes :**  
Le composant est fonctionnel avec des disques RAID5, mais le disque sdb présente des erreurs I/O nécessitant une surveillance continue.

---

## ✅ `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 instructions claires pour l'installation et la gestion des applications.  

**Problèmes :**
- La commande pour récupérer le mot de passe initial contient un typo dans la suppression du secret (début de ligne incorrect)
- Le modèle Helm pour les charts mentionne un serveur destination avec un hyphen superflu: 'https://kubernetes.default.svc ---'
- Aucune mention des bonnes pratiques de sécurité comme la rotation des mots de passe ou l'utilisation de SSH keys

**Suggestions :**
- Ajouter une note sur l'utilisation de 'git diff' avant les commits importants
- Mettre en avant l'outil 'argo diff' pour les vérifications pré-déploiement
- Indiquer de supprimer le secret initial après 24h pour respecter les politiques de sécurité
- Ajouter un exemple de validation des manifests avec 'kubectl validate'

**État réel connu de Hermes :**  
L'implémentation GitOps avec ArgoCD est fonctionnelle dans Funk. Le repo Helm utilisé (argo-helm) est à jour, mais la version 9.5.14 pourrait être vérifiée contre la dernière version disponible sur https://argoproj.github.io/argo-helm/

---

