Funk-lab/admin/hermes/builtin/2026-06-05_03-30.md

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/

---