Comment exécuter Hermes Agent sur un serveur domestique sans perdre de données

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Réponse rapide

Pour exécuter Hermes Agent sur un serveur domestique sans perdre de données, ne comptez pas sur le système de fichiers interne du conteneur comme seul emplacement pour la configuration, les compétences, les journaux, les fichiers générés ou les paramètres de la passerelle. Prévoyez d’abord un dossier persistant sur l’hôte ou un volume Docker, montez-le au chemin réellement utilisé par l’application dans le conteneur, vérifiez les propriétaires des fichiers et assurez-vous que les données sont toujours présentes après un redémarrage ou une reconfiguration. Cet article porte sur un problème fréquent : le conteneur ne trouve pas un dossier en raison d’un problème de montage de volume, de permissions ou de mappage de chemin.

Voici la procédure la plus sûre pour débuter :

  1. Déterminez quelles données de Hermes Agent doivent être conservées.
  2. Choisissez un dossier dédié sur l’hôte ou un volume géré par Docker.
  3. Montez cet espace de stockage au bon chemin dans le conteneur.
  4. Vérifiez que l’utilisateur de l’application peut y écrire.
  5. Sauvegardez les paramètres importants avant les mises à jour ou les reconstructions.
  6. Redémarrez, puis vérifiez que la configuration, les journaux, les fichiers générés et les paramètres de la passerelle sont toujours présents.

Le fait qu’un conteneur soit en cours d’exécution ne signifie pas automatiquement que vos données sont en sécurité. Elles ne le sont que si elles sont stockées dans un emplacement persistant, accessible en écriture par le bon utilisateur, sauvegardées lorsque nécessaire et vérifiées après le redémarrage.

Pourquoi les données de Hermes Agent peuvent disparaître dans une configuration conteneurisée

Les applications conteneurisées sont souvent faciles à démarrer et à remplacer. C’est pratique pour les mises à jour, les tests et la récupération, mais cela signifie aussi que tout ce qui est stocké uniquement dans la couche temporaire du conteneur risque d’être perdu lorsque celui-ci est supprimé, recréé ou reconstruit.

Pour un agent IA auto-hébergé, cela peut concerner bien plus que les paramètres de base. Selon l’utilisation que vous faites de l’agent, vous pouvez tenir à sa configuration de modèle, à ses compétences, à ses fichiers générés, à ses journaux, aux paramètres de sa passerelle de messagerie et à d’autres données d’application.

Redémarrage des conteneurs et persistance des données de l’application

Un simple redémarrage du conteneur ne supprime pas toujours les données. Si les données sont stockées dans un volume persistant ou dans un dossier de l’hôte correctement mappé, elles devraient rester disponibles après le redémarrage.

Le risque apparaît lorsque des fichiers importants se trouvent uniquement dans la couche inscriptible du conteneur. Cette couche n’est pas équivalente à un emplacement de stockage persistant prévu à cet effet. Si vous recréez le conteneur sans conserver ou remonter le bon chemin, l’application peut démarrer comme si elle était neuve ou ne pas trouver ses anciens fichiers.

Pourquoi la suppression ou la recréation d’un conteneur peut entraîner la perte d’un état non enregistré

Supprimer ou recréer un conteneur n’est pas la même chose que le redémarrer. Un conteneur recréé peut utiliser un nouveau système de fichiers interne, de nouvelles variables d’environnement ou un mappage différent des points de montage.

Si les paramètres, les compétences, les journaux ou les fichiers générés par Hermes Agent n’ont jamais été enregistrés dans un dossier ou un volume persistant de l’hôte, ils risquent de ne pas être conservés dans le nouveau conteneur. C’est pourquoi « l’application fonctionnait hier » et « l’application a été réinitialisée après la mise à jour » peuvent être vrais en même temps.

La bonne habitude consiste à considérer le remplacement d’un conteneur comme un risque pour les données, sauf si vous avez confirmé où sont stockées les données de l’application.

Pourquoi faut-il planifier d’abord les chemins hôte et conteneur ?

Un chemin hôte désigne l’emplacement où les données se trouvent sur le serveur domestique. Un chemin de conteneur désigne l’emplacement où l’application voit ces données depuis l’intérieur du conteneur. Un montage de volume ou un montage lié relie ces deux univers.

Si le chemin hôte est correct, mais qu’il est monté au mauvais chemin dans le conteneur, l’application peut tout de même se comporter comme si le dossier n’existait pas. Si le chemin du conteneur est correct, mais que le chemin hôte est temporaire, l’application risque d’écrire les données à un endroit imprévu.

Planifiez le mappage avant de lancer l’application, et non après avoir perdu des données.

Quelles données protéger avant d’exécuter Hermes Agent ?

Avant de modifier un conteneur, de mettre à jour une image ou de reconfigurer une passerelle, dressez la liste des données qu’il serait difficile de recréer. Tous les fichiers n’ont pas besoin du même niveau de protection, mais vous devez savoir lesquels sont essentiels.

Une règle utile : protégez tout ce qui stocke une identité, un accès, une configuration, un flux de travail appris ou une sortie difficile à recréer.

Configuration de l’agent et paramètres du fournisseur de modèles

Les paramètres du modèle comprennent généralement le choix du fournisseur, les valeurs des points de terminaison, les noms des modèles, les options liées au contexte et l’accès à l’API. Si ces paramètres sont perdus, l’agent peut démarrer, mais ne pas répondre correctement.

Stockez la configuration du modèle dans un chemin de données persistant de l’application, et non dans une session de shell temporaire. Si la configuration est fournie au moyen de variables d’environnement, conservez une copie sûre du fichier compose, du fichier env ou des notes de déploiement.

Protégez également tous les choix de configuration qui déterminent la façon dont l’agent utilise les outils du terminal ou les passerelles de messagerie.

Mémoire de l’application, sessions, compétences et état d’exécution

Les données de Hermes Agent peuvent inclure plusieurs fichiers de configuration. La structure des données des compétences Hermes précise que les compétences se trouvent dans ~/.hermes/skills/, qui constitue la source de référence principale pour les compétences intégrées, installées depuis le hub et créées par l’agent. Elle décrit également l’état associé, notamment les manifestes intégrés, les lots de compétences, la configuration du hub tap, les écritures de compétences en attente et les paramètres de configuration.

C’est important, car les compétences créées par l’agent peuvent devenir une mémoire procédurale réutilisable. Si le mauvais chemin est monté, vous risquez de perdre non seulement les paramètres, mais aussi les flux de travail appris par l’agent ou les compétences que vous avez installées.

Considérez les compétences, les lots, les écritures en attente et l’état lié au profil comme des données persistantes de l’agent.

Téléchargements, fichiers générés, journaux et sorties des outils

Les fichiers générés passent facilement inaperçus. En usage normal, un agent peut créer des plans, des scripts, des rapports, des captures d’écran, des journaux ou des fichiers téléchargés.

Ces fichiers peuvent être enregistrés dans l’espace de travail actif, le répertoire de travail du backend, le répertoire personnel de l’application ou un chemin de sortie monté. Si cet emplacement se trouve uniquement dans le conteneur, les fichiers peuvent disparaître lorsque celui-ci est supprimé.

Pour un usage pratique, décidez où les fichiers générés doivent apparaître sur le serveur hôte et vérifiez que le conteneur les écrit à cet emplacement.

Clés API, jetons de bot et variables d’environnement

Les secrets ne sont pas des données d’application ordinaires. Les clés API, les jetons de bot, les mots de passe du tableau de bord et les variables d’environnement doivent être à la fois conservés et protégés.

N’enregistrez pas les secrets dans des dossiers de sortie générés au hasard ou dans de grands répertoires partagés. Conservez-les dans un emplacement de configuration contrôlé et à accès limité.

Une bonne configuration de gestion des secrets doit répondre aux questions suivantes :

  • où le secret est stocké ;
  • quel utilisateur peut le lire ;
  • s’il est inclus dans les sauvegardes ;
  • si la sauvegarde est chiffrée ou protégée par des contrôles d’accès ;
  • comment renouveler le secret s’il est exposé.

Chemin de l’hôte vs chemin du conteneur vs montages de volumes

C’est le concept clé derrière la plupart des problèmes du type « le conteneur ne trouve pas le dossier » et « les données ont disparu après le redémarrage ». Un conteneur ne peut voir que ce qui se trouve dans son propre système de fichiers ou ce qui y a été monté.

Utilisez La carte de persistance des données de l’agent pour organiser la configuration avant de procéder au dépannage.

Module du cadre Question clé Ce que cela vous aide à décider Objectif de configuration / dépannage
Inventaire des données Quelles données doivent survivre au redémarrage ou à la recréation du conteneur ? Quelles configurations, compétences, journaux, téléchargements, jetons et fichiers générés doivent être protégés Évite de traiter les données importantes de l’agent comme un état jetable
Chemin de persistance Où les données persistantes doivent-elles se trouver sur l’hôte ? Faut-il utiliser un dossier dédié sur l’hôte, un volume Docker ou un bind mount Évite la réinitialisation des données après la recréation du conteneur
Mappage des montages Le chemin de l’hôte est-il correctement mappé vers le chemin du conteneur ? Si l’application peut réellement accéder au dossier voulu Aide à diagnostiquer les erreurs de dossier introuvable et de chemin de destination incorrect
Périmètre des autorisations À quel utilisateur appartiennent les données montées et quel utilisateur y écrit ? Si les fichiers appartiennent à l’utilisateur de l’hôte, du conteneur, de l’application ou à root Aide à corriger les erreurs d’autorisation sans que tous les fichiers appartiennent à root
Périmètre de sauvegarde Que faut-il sauvegarder avant les mises à jour ou les reconfigurations ? Quelles données sont critiques et lesquelles sont temporaires Évite de perdre la configuration, les compétences, les sessions, les jetons et les paramètres de la passerelle
Validation après redémarrage Les données existent-elles toujours après un redémarrage ou une mise à jour ? Si la configuration est réellement persistante Transforme « ça fonctionne » en vérification de sécurité reproductible

Ce que stocke le serveur hôte

Le serveur hôte stocke les vrais dossiers, les disques et les emplacements de stockage gérés par Docker. Si vous utilisez un bind mount, vous choisissez un dossier précis sur l’hôte. Si vous utilisez un volume Docker nommé, Docker choisit l’emplacement de stockage et le gère.

Cette distinction est importante, car la visibilité sur l’hôte a une incidence sur les sauvegardes et les migrations. Un dossier monté avec un bind mount peut être plus facile à localiser et à copier pour un débutant. Un volume nommé peut être plus propre pour les données d’application gérées par Docker, mais il faut quand même savoir comment l’inspecter ou le sauvegarder.

Choisissez le type de stockage selon que vous avez besoin de dossiers hôtes lisibles, d’une persistance des données d’application gérée par Docker ou d’un chemin de sauvegarde contrôlé.

Ce que le conteneur peut voir

Le conteneur voit son propre système de fichiers interne ainsi que tous les chemins montés. Il ne voit pas automatiquement tous les dossiers de votre serveur domestique.

Le guide pas à pas du montage lié de Docker montre comment un répertoire hôte peut apparaître dans un conteneur à un chemin cible, et comment les modifications des fichiers peuvent être répercutées entre l’hôte et le conteneur lorsque le montage est correctement configuré.

C’est là l’idée essentielle : l’application ne se soucie pas de l’emplacement d’un fichier sur l’hôte, à moins que celui-ci ne soit monté dans le chemin utilisé par l’application.

Comment les montages de volumes assurent la persistance des données d’une application

Un montage persistant fournit à l’application un emplacement stable où écrire les données, au-delà de la durée de vie d’un conteneur donné. Pour les données d’une application, c’est souvent ce qui fait la différence entre une persistance après redémarrage et une persistance limitée à la durée de vie du conteneur.

Le montage doit correspondre au chemin de données attendu par l’application. Si l’application écrit dans un dossier interne et que vous en montez un autre, les données peuvent tout de même être enregistrées dans un espace de stockage temporaire.

Une bonne configuration persistante doit définir :

  • le dossier hôte ou le volume nommé ;
  • le chemin cible dans le conteneur ;
  • si le montage est en lecture-écriture ou en lecture seule ;
  • les données de l’application qui doivent s’y trouver ;
  • la manière dont le chemin sera sauvegardé.

Pourquoi un mauvais mappage de chemin provoque des erreurs de dossier manquant

Un mauvais mappage de chemin ressemble souvent à un problème de dossier manquant. Le dossier peut exister sur l’hôte, mais le conteneur ne peut pas le voir. Ou bien le conteneur peut avoir un dossier au chemin attendu, sans qu’il soit relié au dossier hôte prévu.

Les symptômes courants sont notamment :

  • l’application indique qu’un dossier n’existe pas ;
  • les fichiers générés apparaissent dans le conteneur, mais pas sur l’hôte ;
  • les journaux disparaissent après la reconstruction du conteneur ;
  • la configuration est réinitialisée après une mise à jour ;
  • vous modifiez un dossier hôte, mais l’application continue d’utiliser les anciens paramètres ;
  • les scripts de sauvegarde s’exécutent, mais n’incluent pas les véritables données de l’application.

Lorsque cela se produit, vérifiez ensemble le chemin hôte et le chemin du conteneur. N’examinez pas un seul côté.

Comment exécuter Hermes Agent sans perdre de données

L’objectif n’est pas seulement de démarrer Hermes Agent. Il s’agit de veiller à ce que les données qui vous importent survivent aux redémarrages, aux mises à jour, aux reconstructions et aux reconfigurations.

Étape 1 : choisissez un dossier de données hôte dédié

Choisissez un dossier de données hôte avant de lancer ou de reconstruire le conteneur. Il doit être facile à identifier et à sauvegarder, et ne pas être mélangé à des fichiers personnels sans rapport.

Un dossier dédié réduit les risques, car vous pouvez voir ce qui appartient à l’application. Il évite également de monter tout votre répertoire personnel ou d’autres dossiers sensibles dans le conteneur.

Un dossier de données hôte adapté doit être :

  • spécifique à l’application ;
  • situé en dehors des chemins de téléchargement temporaires ;
  • inclus dans votre stratégie de sauvegarde ;
  • non partagé à grande échelle avec des services sans lien ;
  • modifiable uniquement par les utilisateurs ou services qui en ont besoin.

Étape 2 : monter le dossier de données dans le conteneur

Montez le dossier de données de l'hôte dans le chemin du conteneur attendu par l'application. C'est à cette étape que de nombreux problèmes de perte de données sont provoqués ou évités.

Pour un montage bind, vous choisissez le chemin sur l'hôte et le chemin cible correspond à son emplacement dans le conteneur. Pour un volume nommé, Docker gère l'emplacement côté hôte.

Ne supposez pas que l'application utilisera automatiquement un dossier monté. Vérifiez que la cible du montage correspond au chemin réel des données de l'application.

Étape 3 : confirmer que le conteneur utilise le chemin de données attendu par l'application

Après le montage, vérifiez le chemin depuis l'intérieur du conteneur. Un dossier peut exister sur l'hôte tout en restant invisible pour l'application s'il n'est pas correctement monté.

La méthode de validation la plus simple consiste à créer ou à repérer un fichier de test inoffensif depuis un côté, puis à confirmer qu'il apparaît de l'autre côté. Vérifiez ensuite que l'application écrit bien les fichiers de configuration, les journaux ou les fichiers générés réels dans le même emplacement persistant.

Cette étape est particulièrement importante avant une mise à jour ou une migration.

Étape 4 : vérifier le propriétaire des fichiers et les autorisations d'écriture

Même un montage correct peut échouer si l'application ne peut pas y écrire. Les erreurs d'autorisation surviennent souvent lorsque les fichiers sont créés par root, mais que l'application s'exécute ensuite sous un autre utilisateur.

Vérifiez le propriétaire avant de modifier largement les autorisations. La bonne solution consiste généralement à permettre à l'utilisateur prévu de l'application de lire et d'écrire dans le dossier de données spécifique de l'application, et non à donner à tous les processus le contrôle total de vastes répertoires de l'hôte.

Si un message « permission denied » s'affiche, identifiez :

  1. le chemin de montage sur l'hôte ;
  2. le chemin cible dans le conteneur ;
  3. l'utilisateur qui exécute l'application ;
  4. le propriétaire du fichier ;
  5. si le montage est en lecture seule ;
  6. si un chemin de sauvegarde ou d'exportation est également accessible en écriture.

Étape 5 : conserver les secrets et les fichiers de configuration hors des emplacements temporaires

Les secrets et les fichiers de configuration ne doivent pas se trouver uniquement dans des dossiers temporaires, des répertoires de sortie générée ou l'historique ad hoc du shell. Si vous utilisez des variables d'environnement, conservez le fichier de déploiement ou le fichier env dans un emplacement persistant et contrôlé.

Évitez de mélanger les secrets avec les journaux ou les fichiers générés. Les journaux peuvent être partagés pour faciliter le dépannage, contrairement aux secrets, qui ne doivent jamais être partagés à la légère.

Si vous sauvegardez des secrets, protégez la sauvegarde. Une sauvegarde qui expose des clés API ou des jetons de bot crée un autre type de risque.

Étape 6 : redémarrer le conteneur et vérifier que les données sont toujours présentes

Après la configuration, redémarrez le conteneur et vérifiez que les données importantes sont toujours présentes. C'est le test de persistance le plus pratique.

Ne vous contentez pas de vérifier que « le conteneur démarre ». Confirmez que :

  • les paramètres du modèle sont toujours présents ;
  • les compétences ou l'état de l'application restent visibles ;
  • les journaux continuent d'être enregistrés à l'emplacement prévu ;
  • les fichiers générés apparaissent sur l'hôte ;
  • les paramètres de la passerelle ou du bot fonctionnent toujours ;
  • les fichiers de sauvegarde peuvent être localisés.

Une configuration qui passe la validation après redémarrage est beaucoup plus sûre qu'une configuration qui n'a réussi que la première installation.

Limites des autorisations, des sauvegardes et de sécurité

La sécurité des données dépend de trois limites : qui peut écrire, quelles données sont sauvegardées et à quoi l’agent est autorisé à accéder. Ces limites sont particulièrement importantes pour les agents auto-hébergés, car ils peuvent créer des fichiers, modifier des flux de travail ou interagir avec des outils.

Pourquoi les permissions de l’utilisateur du conteneur sont importantes

Les permissions de l’utilisateur du conteneur déterminent si l’application peut lire et écrire ses données. Si l’application s’exécute avec un utilisateur, mais que le dossier monté appartient à un autre utilisateur, les opérations d’écriture peuvent échouer.

C’est pourquoi exécuter une commande de configuration en tant que root peut causer des problèmes par la suite. Root peut créer des fichiers, mais il se peut que l’utilisateur normal de l’application ne puisse pas les modifier.

Corrigez les permissions au niveau du dossier de données de l’application. Évitez les modifications générales des permissions qui exposent des fichiers sans rapport sur l’hôte.

Pourquoi éviter de tout exécuter en tant que root

Le compte root peut contourner de nombreuses restrictions, mais cela n’en fait pas une option sûre par défaut. Tout exécuter en tant que root peut créer des fichiers appartenant à root, masquer des problèmes de permissions et donner à l’application plus d’accès que nécessaire.

Pour la plupart des opérations avec des applications auto-hébergées, le compte root ne doit servir qu’à des tâches administratives précises. Dans la mesure du possible, la configuration courante de l’application doit s’effectuer avec le compte utilisateur prévu pour l’application ou le conteneur.

Une approche plus sûre consiste à appliquer le principe du moindre privilège : n’accordez à l’application des droits d’écriture que sur les dossiers dont elle a besoin.

Quand utiliser des montages en lecture seule ou des dossiers à accès limité

Utilisez des montages en lecture seule lorsque l’agent doit consulter des fichiers sans les modifier. Utilisez des dossiers avec des droits d’écriture limités lorsque l’agent doit créer des fichiers, sans pour autant toucher à de vastes répertoires personnels ou système.

C’est particulièrement utile lorsque vous voulez que l’agent génère des rapports, des plans ou des scripts sans lui accorder l’accès en écriture à tous les fichiers du serveur.

Une conception limitant l’accès à certains dossiers réduit l’impact des erreurs. Elle facilite aussi les sauvegardes, car vous savez quel dossier contient l’état de l’application et lequel contient les fichiers générés.

Comment sauvegarder les données de l’agent avant les mises à jour ou la reconfiguration

Sauvegardez les données importantes de l’application avant de modifier les images de conteneurs, les chemins de montage, les paramètres de la passerelle ou les profils. Une sauvegarde n’est utile que si vous savez ce qu’elle contient et comment la restaurer.

La discussion sur les erreurs de permission lors de la sauvegarde de volumes de la communauté Docker montre un problème fréquent rencontré par les utilisateurs : un chemin peut exister, mais les opérations de sauvegarde ou d’écriture peuvent tout de même échouer en raison de restrictions liées aux permissions, à la propriété, à l’étiquetage ou aux montages.

Voyez cela comme un rappel : testez vos sauvegardes, ne vous contentez pas de les créer. Un plan de sauvegarde doit inclure à la fois la création des sauvegardes et la vérification de leur restauration.

Problèmes courants et solutions

Lorsque les données de l’agent Hermes sont manquantes, ne réinstallez pas immédiatement l’application. Identifiez d’abord la couche défaillante : inventaire des données, chemin de persistance, correspondance des montages, limites des permissions, périmètre de sauvegarde ou validation après redémarrage.

Le conteneur ne trouve pas un dossier monté

Cela signifie généralement que le chemin existe dans une couche, mais pas dans l’autre. Le dossier hôte n’est peut-être pas monté, le chemin cible dans le conteneur est peut-être incorrect ou l’application cherche peut-être ailleurs.

Procédez aux vérifications dans cet ordre :

  1. Vérifiez que le dossier existe sur l’hôte.
  2. Vérifiez que le conteneur dispose du montage.
  3. Vérifiez le chemin cible dans le conteneur.
  4. Vérifiez que l’application est configurée pour utiliser ce chemin cible.
  5. Vérifiez que l’utilisateur de l’application peut lire le dossier.
  6. Vérifiez que le montage a été recréé après la modification des paramètres de Compose ou de lancement.

Ne corrigez pas le problème en créant des dossiers au hasard dans le conteneur. Cela peut faire disparaître temporairement l’erreur tout en laissant les données dans un espace de stockage temporaire.

Les données de l’application sont réinitialisées après le redémarrage

Si les données sont réinitialisées après le redémarrage, l’application écrit peut-être dans le système de fichiers interne du conteneur plutôt que dans le chemin persistant. Elle peut aussi utiliser un profil, une variable d’environnement ou un répertoire de données différent de celui prévu.

Vérifiez si le chemin des données est le même avant et après le redémarrage. Vérifiez ensuite si le dossier est associé à un montage ou s’il se trouve uniquement dans la couche du conteneur.

Si l’application a été recréée, vérifiez que le même volume ou montage lié a été associé au nouveau conteneur.

Erreurs « Permission denied » dans le répertoire de données

« Permission denied » signifie que l’application peut accéder au chemin, mais pas effectuer l’action requise. Le problème peut venir du propriétaire, des paramètres de montage en lecture seule, des étiquettes du système de fichiers ou d’une incompatibilité entre l’utilisateur hôte et l’utilisateur du conteneur.

Commencez par la vérification la plus simple : l’utilisateur de l’application peut-il créer un fichier de test inoffensif dans le répertoire de données ? Si ce n’est pas le cas, vérifiez le propriétaire et les permissions de ce chemin précis.

Évitez de résoudre le problème en accordant un accès en écriture étendu à l’ensemble du répertoire hôte. Corrigez le chemin des données de l’application et définissez l’utilisateur prévu pour l’application.

Les fichiers générés sont enregistrés uniquement dans le conteneur

Si les fichiers générés disparaissent après une reconstruction, ils ont probablement été enregistrés dans le conteneur plutôt que dans un chemin hôte monté. Cela se produit souvent lorsque le répertoire de travail ou le répertoire de sortie de l’application n’est pas mappé.

Décidez où les fichiers générés doivent être enregistrés. Montez ensuite ce dossier de sortie ou configurez l’application pour qu’elle écrive dans un emplacement persistant existant.

Après avoir modifié le chemin, créez un fichier de test inoffensif et vérifiez qu’il apparaît sur l’hôte.

Les paramètres du bot ou de la passerelle disparaissent après une reconfiguration

Les paramètres de la passerelle peuvent disparaître si la configuration est stockée dans un emplacement non persistant ou si l’application utilise un profil différent après le redémarrage. La même chose peut se produire si une variable d’environnement est modifiée à un endroit, mais que le conteneur en cours d’exécution utilise une autre valeur.

Vérifiez que la configuration de la passerelle, la référence au jeton du bot, la liste d’autorisation et les paramètres du tableau de bord sont stockés à l’emplacement persistant prévu. Redémarrez ensuite la passerelle et vérifiez que les paramètres sont toujours actifs.

Si le bot fonctionne avant le redémarrage, mais plus après, vérifiez la persistance et la configuration de l'environnement avant de modifier le jeton.

Comment vérifier que les données de votre agent Hermes sont en sécurité

Une configuration sûre doit réussir les vérifications de redémarrage, d'écriture, de sauvegarde et d'accès. Ces vérifications n'ont pas besoin d'être complexes, mais elles doivent être répétées après les changements importants.

La configuration est conservée après le redémarrage

Modifiez un paramètre sans conséquence, redémarrez le conteneur et vérifiez que le paramètre est conservé. Cela confirme que l'application écrit les données dans un stockage persistant.

Si le paramètre disparaît, n'ajoutez pas d'autres éléments de configuration. Corrigez d'abord le chemin des données.

Les journaux et les fichiers générés apparaissent dans le dossier hôte prévu

Les journaux et les fichiers générés doivent apparaître sur l'hôte à l'emplacement prévu. S'ils apparaissent uniquement dans le conteneur, ils risquent d'être perdus lors de sa recréation.

Vérifiez les deux côtés du montage. L'hôte et le conteneur doivent être cohérents concernant les fichiers importants.

L'agent peut écrire dans les données de l'application sans erreur d'autorisation

L'agent doit pouvoir écrire dans son dossier de données d'application en tant qu'utilisateur prévu. Un test d'écriture réussi est plus utile que de simplement confirmer que le dossier existe.

Après le redémarrage, repérez les erreurs d'autorisation dans les journaux. Certains problèmes d'autorisation ne surviennent que lorsque l'agent tente de mettre à jour la configuration, d'écrire une compétence, d'enregistrer un fichier généré ou de mettre à jour l'état de la passerelle.

Les fichiers de sauvegarde peuvent être localisés et restaurés

Une sauvegarde est incomplète tant que vous ne pouvez pas la localiser et la restaurer dans un emplacement de test. Au minimum, vérifiez qu'elle contient bien les données que vous souhaitiez protéger.

Pour les configurations importantes, restaurez la sauvegarde dans un dossier distinct ou sur une instance de test avant de vous y fier. Vous éviterez ainsi de découvrir des problèmes de restauration seulement après avoir perdu des données.

Le tableau de bord ou l'accès à la messagerie fonctionne toujours après le redémarrage

Après le redémarrage, vérifiez que le tableau de bord ou l'accès à la messagerie fonctionne toujours. Cela confirme que les données persistantes, les identifiants, les paramètres de la passerelle et l'accès réseau sont toujours correctement configurés.

Si le tableau de bord fonctionne, mais que la messagerie échoue, vérifiez les paramètres de la passerelle et l'accès au jeton. Si la messagerie fonctionne, mais que les fichiers générés disparaissent, vérifiez le chemin de sortie et les montages.

Fonctionnement dans un environnement réel de serveur domestique

Dans une configuration réelle de serveur domestique, les mêmes règles de protection des données s'appliquent, même si le système propose un tableau de bord convivial. Vous devez tout de même savoir quelles données doivent être conservées, où elles sont stockées, comment le conteneur y accède, quel utilisateur peut y écrire et comment les vérifier après un redémarrage.

Par exemple, le workflow d'installation de l'agent Hermes sur ZimaOS présente une procédure adaptée à l'appareil, qui comprend la configuration du fournisseur de modèles, la configuration de la passerelle Telegram, l'accès au conteneur Hermes, l'activation de l'environnement de l'application, la vérification du tableau de bord Web et le dépannage des problèmes d'autorisations ou de réponses du bot.

Pour les utilisateurs qui exécutent des applications Docker, des flux de travail d’agent et des services locaux sur une machine compacte fonctionnant en permanence, le serveur domestique ZimaBoard 2 est un exemple pertinent d’environnement de serveur domestique léger où les dossiers persistants, les chemins des conteneurs, les autorisations et l’extension du stockage doivent être planifiés conjointement. Ce n’est pas la seule configuration possible, mais elle correspond au type de flux de travail applicatif auto-hébergé présenté dans ce guide.

La leçon générale est applicable partout : avant de confier des tâches utiles à un agent conteneurisé, assurez-vous que ses données importantes subsistent au-delà du conteneur actuellement en cours d’exécution.

FAQ

Pourquoi mes données Hermes Agent ont-elles disparu après le redémarrage du conteneur ?

Un simple redémarrage ne devrait pas supprimer les données persistantes, mais l’application peut sembler réinitialisée si elle écrivait dans un chemin non persistant du conteneur. Les données peuvent aussi manquer si le conteneur a été recréé sans le même volume ou montage bind. Vérifiez le chemin sur l’hôte, celui dans le conteneur et le chemin réel des données de l’application avant de modifier d’autres paramètres.

Quelle est la différence entre un volume Docker et un montage bind ?

Un volume Docker est géré par Docker, tandis qu’un montage bind relie un dossier de l’hôte que vous choisissez au conteneur. Un volume est souvent pratique pour les données gérées par l’application, tandis qu’un montage bind est plus facile à localiser directement sur l’hôte. Le meilleur choix dépend de votre préférence pour un stockage géré par Docker ou pour un dossier visible sur l’hôte, facile à sauvegarder et à inspecter.

Où dois-je stocker les données de l’application Hermes Agent sur un serveur domestique ?

Utilisez un dossier persistant dédié ou un volume Docker plutôt qu’un chemin temporaire du conteneur. L’emplacement doit être facile à sauvegarder, limité aux besoins de l’application et séparé des fichiers sensibles sans rapport avec celle-ci. Le plus important est que le chemin attendu par l’application dans le conteneur corresponde bien à cet espace de stockage persistant.

Pourquoi le conteneur indique-t-il qu’un dossier n’existe pas ?

Le dossier peut exister sur l’hôte, mais pas dans le conteneur. Cela signifie généralement que le montage n’a pas été créé, que le chemin source ou le chemin cible est incorrect, ou que l’application cherche le dossier à un autre emplacement dans le conteneur. Vérifiez à la fois le côté hôte et le côté conteneur au lieu de créer un nouveau dossier à l’aveugle.

Dois-je exécuter Hermes Agent en tant que root pour éviter les erreurs d’autorisation ?

L’exécution en tant que root peut masquer l’erreur immédiate, mais elle peut créer des fichiers appartenant à root et accroître les risques. Une approche plus sûre consiste à permettre à l’utilisateur prévu pour l’application de lire et d’écrire uniquement dans le chemin de données nécessaire à l’application. N’utilisez root que pour des tâches précises d’administration ou de réparation, lorsque vous comprenez les changements effectués.

À quelle fréquence dois-je sauvegarder les données de Hermes Agent ?

Effectuez une sauvegarde avant les mises à jour, la reconstruction des conteneurs, les changements de chemin, la reconfiguration de la passerelle ou la migration vers un autre serveur. En cas d’utilisation active, planifiez des sauvegardes régulières en fonction de la fréquence à laquelle les compétences, les paramètres, les fichiers générés ou les sessions changent. Une sauvegarde n’est fiable qu’après avoir vérifié que les fichiers peuvent être retrouvés et restaurés.

Assistance et conseils

À lire aussi

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.