# Rapport Hermes — 2026-06-04_00-30 > Branche : `hermes/daily-work` · Fichiers analysés : 5 --- ## Résumé - ✅ À jour : 5 - ⚠️ À améliorer : 0 ## ✅ `admin/install/README.md` — 8/10 **Statut** : ok **Résumé** : Document structuré avec guides d'installation organisés par machine, mais manque le contenu concret des fichiers liés (storage-01.md, gpu-01.md, kubernetes.md) **Problèmes :** - Les fichiers liés (storage-01.md, gpu-01.md, kubernetes.md) ne sont pas inclus dans le document principal - Aucune mention des prérequis techniques spécifiques pour chaque installation - Le format markdown des tableaux est incomplet (|---|---|---|---| sans en-têtes) **Suggestions :** - Ajouter le contenu des fichiers liés au sein du README.md pour une documentation autonome - Spécifier les prérequis logiciels/hardware pour chaque machine - Compléter le tableau avec des en-têtes clairs (Machine, OS, Rôle) - Ajouter une section 'Notes importantes' sur les dépendances entre les machines --- ## ✅ `admin/install/gpu-01.md` — 9/10 **Statut** : ok **Résumé** : Document complet et structuré décrivant l'installation de gpu-01 avec des étapes claires et des notes techniques critiques (ROCm gfx1031, HSA_OVERRIDE_GFX_VERSION). **Problèmes :** - Manque de vérification post-install pour confirmer la reconnaissance du GPU ROCm (rocm-smi, lspci) - Aucune mention des packages ROCm à installer via Ansible (rocm, rocblas, etc.) - Les étapes de montage NFS ne précise pas les droits d'accès nécessaires **Suggestions :** - Ajouter une vérification du pilote ROCm avec 'rocm-smi' - Mettre à jour le playbook Ansible pour inclure les dépendances ROCm - Spécifier les paramètres fstab pour le montage NFS persistant **État réel connu de Hermes :** Le matériel gpu-01 est opérationnel avec ROCm 7.x et llama-server, le playbook Ansible fonctionne depuis le poste perso --- ## ✅ `admin/install/kubernetes.md` — 9/10 **Statut** : à_jour **Résumé** : Document d'installation complet et structuré pour un cluster Kubernetes avec Talos, couvrant les étapes clés de configuration réseau, chiffrement des secrets et déploiement des composants. **Problèmes :** - Manque de précision sur les versions exactes de Kubernetes (v1.33.1) et Helm (v3.x) - La section sur le NFS provisioner n'est pas développée dans le sommaire - Aucune mention des bonnes pratiques pour la gestion des secrets avec SOPS/age **Suggestions :** - Ajouter des notes sur les versions les plus récentes des composants pour garantir la compatibilité - Compléter la section sur le provisionnement NFS avec des exemples concrets - Inclure un checklist de vérification des secrets chiffrés dans la section SOPS **État réel connu de Hermes :** Ce document correspond exactement à la configuration actuelle de Funk, y compris les trois ThinkCentres et la topologie réseau. Les erreurs documentées correspondent aux problèmes rencontrés lors de l'installation initiale. --- ## ✅ `admin/install/storage-01.md` — 7/10 **Statut** : à_jour **Résumé** : Document d'installation complet pour storage-01 avec structure claire, mais contient des lacunes dans les détails techniques et des erreurs de formatage. **Problèmes :** - La configuration réseau LAN manque une commande complète (la commande 'sudo nmcli' est incomplète) - Aucune mention des étapes pour configurer le RAID5 dans les sections post-installation - La section sur le playbook Ansible manque des détails sur les phases spécifiques à exécuter - Les commandes de vérification post-installation sont trop minimalistes - Le formatage des tableaux utilise des caractères non-ASCII (---) qui pourraient poser problème **Suggestions :** - Ajouter des exemples concrets de commandes pour configurer le RAID5 - Préciser les étapes de vérification du RAID5 avec smartctl - Mettre à jour les commandes de configuration réseau avec des exemples complets - Ajouter une section détaillée sur la gestion des erreurs courantes lors de l'installation - Utiliser un format de tableau standard avec des tirets simples (-) pour améliorer la lisibilité **État réel connu de Hermes :** L'installation de storage-01 est achevée dans le cluster Funk, mais le document contient des lacunes qui pourraient causer des problèmes lors de la formation d'autres ingénieurs. --- ## ✅ `admin/k8s/argocd.md` — 8/10 **Statut** : à_jour **Résumé** : Documentation complète pour l'installation et la gestion d'ArgoCD dans le cluster Funk, avec des étapes claires et des exemples pratiques. **Problèmes :** - Le repo Helm ArgoCD utilise une version spécifique (9.5.14) qui pourrait être obsolète - Les exemples de déploiement contiennent des placeholders (ex: 'https://charts.exemple.com') à remplacer - Le mot de passe initial est récupéré via kubectl, mais la note pour le suppression du secret est minimale - La section 'GitOps' mentionne encore 'kubectl apply' manuel (contraire au principe GitOps) **Suggestions :** - Mettre à jour la version Helm à la dernière stable disponible - Remplacer les URLs placeholders par des références réelles au repo Funk-lab - Ajouter une note explicite sur la suppression du secret initial après changement - Corriger la section GitOps pour souligner l'interdiction des 'kubectl apply' manuels **État réel connu de Hermes :** Le composant est fonctionnel dans Funk, mais les étapes de bootstrap nécessitent vérification des versions et des droits SSH pour le repo Git ---