# 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/ ---