Pourquoi un service Compose n’utilise-t-il le mauvais fichier d’environnement qu’après le redémarrage de l’hôte ?

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.

Un service Compose peut utiliser des valeurs d’environnement différentes après un redémarrage si le lanceur au démarrage résout un autre répertoire de projet, un autre fichier env ou une autre source de priorité.

Une commande manuelle peut s’exécuter depuis le dossier prévu avec un environnement shell donné, tandis que systemd, un planificateur NAS ou Portainer lance le même fichier Compose depuis un autre contexte après le démarrage. Le service peut aussi redémarrer un conteneur existant dont l’environnement a été fixé lors de sa création, au lieu de relire le fichier modifié. Comparez le modèle Compose rendu et l’environnement du processus en cours d’exécution pour le lancement manuel et celui au démarrage avant de modifier plusieurs fichiers à la fois.

Comparer l’environnement en cours d’exécution au fichier prévu

Consignez l’ID du conteneur, sa date de création, son image, ses libellés Compose, le nom du projet et les valeurs réellement visibles dans le processus principal. Comparez-les au fichier env attendu sans publier de secrets dans des journaux partagés.

L’environnement du processus Linux expose les valeurs fournies lors de son exécution, ce qui constitue une preuve plus fiable que la lecture d’un fichier env que le conteneur actuel n’a peut-être jamais utilisé.

Si le conteneur contient les anciennes valeurs et date d’avant le déploiement au redémarrage, le service l’a peut-être simplement redémarré. Si le conteneur est nouveau, examinez la priorité et la résolution des chemins.

Appliquer l’ordre de priorité des variables d’environnement Compose dans le bon ordre

Répertoriez toutes les sources d’une variable sans risque : options CLI, valeurs du shell, environment:, env_file:, fichier .env par défaut ou explicite, et ENV de l’image.

Docker définit un ordre de priorité formel des variables d’environnement : un fichier env correct peut donc être supplanté par une valeur de priorité supérieure injectée par le service au démarrage ou le gestionnaire de stack.

Ne recherchez pas uniquement les noms de fichiers en double. Recherchez le nom de la variable dans le modèle Compose rendu, le fichier d’unité, les paramètres du gestionnaire, l’environnement shell et les valeurs par défaut de l’image.

Vérifier le répertoire du projet et les chemins relatifs des fichiers d’environnement

Comparez le répertoire de travail de la commande manuelle avec celui du lanceur au démarrage, les arguments de fichier Compose, le répertoire de projet et les références relatives à env_file.

La spécification Compose définit le modèle applicatif utilisé pour résoudre les services et la configuration : la définition de projet sélectionnée et ses chemins font donc partie des paramètres de déploiement, plutôt que d’être déterminés à nouveau à partir du conteneur en cours d’exécution.

Utilisez des chemins absolus pour les fichiers d’environnement indispensables au démarrage lorsque l’outil de déploiement le permet, ou définissez explicitement un répertoire de projet et un répertoire de travail afin que les lancements manuels et automatisés utilisent les mêmes fichiers.

Vérifiez le répertoire de travail et les fichiers d’environnement de systemd

Lisez l’unité effective, tous les fichiers complémentaires, WorkingDirectory=, Environment=, EnvironmentFile= et ExecStart=. Comparez l’unité chargée au démarrage avec la commande utilisée manuellement.

Les paramètres d’exécution de systemd définissent le répertoire de travail du service et ses fichiers d’environnement ; ceux-ci n’héritent pas automatiquement du répertoire courant ou des variables exportées d’un shell de connexion interactif.

Après avoir modifié une unité ou un fichier complémentaire, rechargez le gestionnaire systemd et vérifiez à nouveau l’unité effective. Modifier un modèle ou un fichier inutilisé ne change pas le service réellement lancé.

Vérifiez les variables du gestionnaire de piles et l’état du déploiement enregistré

Si Portainer ou l’interface du NAS gère la pile, comparez les variables enregistrées, le fichier d’environnement importé, le chemin de déploiement Git, le comportement de mise à jour du webhook et le modèle Compose affiché.

Portainer distingue le comportement des fichiers .env et stack.env : les valeurs saisies dans l’interface de gestion peuvent donc différer de celles d’un fichier modifié directement sur l’hôte.

Choisissez une seule source de vérité. Une pile gérée depuis Git ou un éditeur web ne doit pas aussi être lancée manuellement depuis une autre copie locale après chaque redémarrage.

Recréez le conteneur au lieu de simplement le redémarrer

Comparez l’heure de création du conteneur à l’heure de modification du fichier d’environnement. Générez la configuration Compose prévue, puis recréez de manière contrôlée uniquement le service concerné.

Les recommandations de Red Hat sur systemd préconisent de vérifier les fichiers et les surcharges réellement utilisés par un service avant de le redémarrer, afin d’éviter qu’une ancienne unité ou un script intermédiaire ne recrée le conteneur avec d’anciennes valeurs.

Un redémarrage de conteneur ne reconstitue pas son environnement à partir de Compose. Ne le recréez qu’après avoir protégé les données persistantes et vérifié que le modèle rendu pointe vers les volumes et les secrets prévus.

Faites en sorte que le démarrage manuel, le redémarrage et le redéploiement produisent le même modèle

Fixez les fichiers Compose, le nom du projet, le répertoire du projet, le chemin du fichier d’environnement, le gestionnaire de la stack et la dépendance au démarrage. Enregistrez une configuration rendue expurgée et une empreinte d’environnement sans risque.

L’article de ZimaSpace sur la portée des sauvegardes Docker énonce la règle complémentaire : les fichiers d’environnement et les définitions de déploiement doivent être conservés avec les données persistantes.

Le problème est résolu lorsqu’une recréation manuelle, un redémarrage de l’hôte, une mise à jour planifiée et un redéploiement par le gestionnaire de stacks créent tous le service avec la même empreinte d’environnement expurgée.

Foire aux questions

Quelle est la différence entre .env et env_file ?

Un fichier de projet .env fournit généralement des valeurs d’interpolation à Compose, tandis qu’un env_file de service fournit des variables au conteneur. Leur interaction et leur priorité dépendent du modèle Compose complet.

Le redémarrage d’un conteneur recharge-t-il un fichier env modifié ?

Non. Les valeurs d’environnement sont définies à la création du conteneur. En général, le service doit être recréé à partir de la configuration Compose corrigée.

Pourquoi le problème apparaît-il uniquement après le redémarrage ?

Le chemin de redémarrage peut utiliser une unité systemd, un planificateur, des variables stockées par un gestionnaire, un autre répertoire de travail ou une ancienne copie de Compose différente du lancement manuel.

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.