Une stack Compose peut monter un nouveau volume nommé vide si un redéploiement modifie le nom du volume associé au projet ou ne trouve pas le volume d’origine.
Les anciennes données peuvent toujours se trouver dans un autre volume Docker, tandis que le service recréé monte un volume nouvellement généré au même chemin dans le conteneur. Les causes courantes incluent un changement de nom de stack ou de projet, le renommage d’une clé de volume, la suppression à l’aide d’une commande qui supprime les volumes, la suppression d’une déclaration de volume externe, le déploiement via un autre gestionnaire ou un nom de volume explicite qui correspond désormais à un volume différent. Répertoriez le volume monté et les volumes orphelins possibles avant de restaurer les données ou d’initialiser l’application.
Identifier le volume exact monté par le nouveau conteneur
Inspectez les montages du conteneur en cours d’exécution et notez le nom du volume, le pilote, le point de montage, les étiquettes, la date de création, le chemin de destination dans le conteneur et le mode lecture-écriture. Comparez-les aux relevés antérieurs au redéploiement.
La commande docker volume inspect d’Ubuntu révèle l’identité du volume, ce qui permet de distinguer le nouveau volume vide d’un ancien volume non monté au nom similaire.
Ne copiez pas de données dans le nouveau volume avant d’avoir retrouvé l’original. Le démarrage de l’application peut créer une nouvelle base de données et donner l’impression que la destination a été initialisée volontairement.
Vérifier si le nom du projet Compose a changé
Comparez l’ancien et le nouveau nom du projet, le nom de la stack, le répertoire Compose, l’option -p, COMPOSE_PROJECT_NAME, le champ de premier niveau name: et le gestionnaire de déploiement.
Docker explique que Compose associe normalement un volume au projet avec le nom du projet et la clé du volume, sauf si un nom explicite ou la recherche d’un volume externe est configuré.
Déplacer le même fichier Compose dans un autre répertoire peut donc créer un second projet et un second volume, même si les clés du service et du volume restent inchangées.
Vérifier le nom stable et les paramètres du volume externe
Comparez la définition du volume de niveau supérieur avant et après le redéploiement. Vérifiez name:, external:, les options du pilote, les variables d’interpolation et l’existence du volume attendu.
Le tutoriel Docker Compose de Microsoft indique que les volumes nommés persistent indépendamment du remplacement des conteneurs ; ainsi, un nouvel état vide signifie généralement qu’une identité de volume différente a été associée ou que l’ancien volume a été supprimé.
Définissez un volume comme externe uniquement si son cycle de vie est volontairement géré en dehors de la stack. Compose devrait échouer clairement si un volume externe est absent, plutôt que d’en créer silencieusement un nouveau.
Vérifiez si un nettoyage a supprimé le volume d’origine
Examinez les journaux de déploiement, les scripts, les actions dans l’interface, les tâches de nettoyage et les commandes de suppression de volumes. Comparez l’heure de création du volume à celle du redéploiement.
Red Hat précise que les volumes nommés gérés par les conteneurs ont des emplacements de stockage distincts des couches inscriptibles des conteneurs, d’où la différence entre la suppression d’un conteneur et celle de son volume nommé.
Si le volume d’origine est absent, arrêtez les démarrages automatiques et restaurez uniquement à partir d’une sauvegarde vérifiée. Ne supposez pas qu’un volume de remplacement vide contient une couche supprimée récupérable.
Comparez l’identité définie par le gestionnaire de stack et la méthode de déploiement
Consignez si la stack a été lancée par l’interface en ligne de commande, Portainer, une boutique d’applications NAS, un déploiement Git ou un autre outil d’automatisation. Comparez le nom de la stack et les valeurs d’environnement enregistrées par ce gestionnaire.
Portainer exige un nom de stack descriptif lors du déploiement, et cette identité contrôlée par le gestionnaire peut différer du nom de projet basé sur le répertoire utilisé par une commande Compose manuelle.
Un démarrage manuel d’urgence peut donc créer des ressources sous le préfixe d’un autre projet. Choisissez un responsable de déploiement et consignez les noms de volumes résolus qu’il crée.
Écarter la présence de données masquées sous le montage du nouveau volume
Arrêtez le conteneur et inspectez l’image ou le chemin lié sans volume nommé attaché, dans un environnement de test jetable. Déterminez si le démarrage a écrit des données dans la couche du conteneur avant le montage du volume.
Le manuel Linux sur mount explique qu’un montage masque le contenu préexistant d’un répertoire : des données peuvent donc sembler manquantes lorsqu’un nouveau volume vide recouvre des fichiers créés dans l’image ou la couche inscriptible.
Ne fusionnez pas à l’aveugle la couche masquée et l’ancien volume persistant. Déterminez quel état fait autorité et utilisez la méthode de récupération prise en charge par l’application.
Reconnecter le volume d’origine avec un test contrôlé
Arrêtez la pile, sauvegardez les deux volumes potentiels, connectez l’original à un conteneur jetable ou à un chemin de service temporaire, puis vérifiez les fichiers de l’application, l’identité de la base de données, les propriétaires et les horodatages.
Le guide ZimaSpace sur le déplacement des données de conteneur sans perturber les montages présente le processus complémentaire de correspondance des chemins ; cet article porte sur l’identité des volumes nommés associés à un projet.
Le problème est résolu lorsque l’ancien volume souhaité est monté sous un nom explicite stable ou un nom externe et que les redéploiements successifs le réutilisent sans créer un autre volume vide potentiel.
Foire aux questions
Un volume nommé vide signifie-t-il que les anciennes données ont été supprimées ?
Pas nécessairement. L’ancien volume peut toujours exister sous un autre préfixe de projet ou un nom explicite, tandis que le nouveau conteneur utilise un autre volume vide.
Le changement de nom du dossier Compose peut-il créer un nouveau volume ?
Oui. Lorsqu’aucun nom de projet n’est défini, Compose peut le déduire du répertoire du projet et créer des ressources avec différents préfixes.
Les volumes importants doivent-ils être marqués comme externes ?
Les volumes externes empêchent la pile de gérer leur cycle de vie lors de sa suppression, mais ils nécessitent une création, un nommage, une sauvegarde et des vérifications de déploiement délibérés.
Assistance et conseils
À lire aussi

Comment cacher les vidéos pour adultes stockées sur votre NAS à votre famille
Gardez les vidéos pour adultes privées sur un NAS familial. Vérifiez les autorisations des dossiers, l’accès aux bibliothèques Plex et Jellyfin, les vignettes, l’historique...

Ce qu’il faut vérifier avant de charger un modèle communautaire dans Transformers
Utilisez la mise à jour du bac à sable Jinja de Transformers pour examiner la provenance des modèles, les modèles de conversation, le code...

Exécutez Mirage localement : OCR et détection d’objets à partir d’une seule image
Essayez le petit modèle de vision local de Cactus Compute, testez la reconnaissance optique de caractères et l’extraction d’objets à partir de données réelles,...



