Procédure de migration d’un volume nommé Docker entre deux serveurs domestiques

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.

L’approche sûre consiste à traiter une archive créée lorsque les processus d’écriture sont au repos, ou une copie synchronisée dans un volume cible explicitement identifié, suivie d’une vérification par somme de contrôle et d’une validation de l’application, comme une succession de points de contrôle observables et non comme une commande unique.

Sur deux serveurs domestiques Linux exécutant Docker Compose, le risque pratique est de devoir déplacer un conteneur avec état vers un autre hôte sans copier un volume actif ou mal nommé. Notez l’identité actuelle et le point de récupération, commencez par le critère le moins intrusif, interprétez les résultats positifs et négatifs avant de modifier une autre variable, et arrêtez-vous si le stockage devient instable ou si cela risque d’exposer la seule copie récupérable. Le processus ci-dessous ne prend fin que lorsque la charge de travail d’origine fonctionne ou que les éléments disponibles imposent une escalade.

Identifiez les caractéristiques requises des volumes source et cible

Notez le digest de l’image du conteneur source, le nom du projet Compose, le service, la clé du volume, le nom réel du volume Docker, le chemin de montage, le pilote du volume et la version de l’application. Utilisez docker inspect et docker volume inspect ; ne déduisez pas le chemin physique à partir d’une simple étiquette YAML.

Compose préfixe généralement les volumes nommés avec le nom du projet, sauf si un nom explicite ou un volume externe est utilisé. Sur la cible, affichez la configuration Compose et créez explicitement le volume vide prévu afin que la migration n’aboutisse pas à un volume tandis que le service en utilise un autre.

Si le volume contient une base de données, utilisez son export natif ou une sauvegarde prise en charge comme principal moyen de récupération portable et considérez la copie du volume comme un point de récupération pour la même version. Arrêtez-vous si le pilote est distant, si le stockage source est instable ou si l’état de l’application s’étend à d’autres volumes qui ne sont pas concernés.

Mettez les processus d’écriture au repos et créez une copie qui préserve les métadonnées

Mettez l’application en mode maintenance, arrêtez les tâches en arrière-plan, puis arrêtez proprement l’application et la base de données. Vérifiez qu’aucun conteneur ne monte le volume en lecture-écriture. Créez une archive via un conteneur temporaire ou effectuez une copie contrôlée du système de fichiers qui préserve les identifiants numériques des propriétaires, les permissions, les liens symboliques, les attributs étendus si nécessaire et les fichiers creux.

Un guide indépendant sur la migration des volumes Docker avec rsync montre comment déplacer les données des volumes Docker avec rsync. Le point essentiel est que la source doit être au repos et que la commande de copie doit porter sur le contenu du volume identifié, sans manipuler à l’aveugle le répertoire interne de Docker pendant que le daemon l’utilise.

Générez un manifeste indiquant le nombre de fichiers, le nombre total d’octets, quelques sommes de contrôle représentatives et la somme de contrôle de l’archive. Laissez le volume source et la sauvegarde native intacts ; l’étape de copie est validée uniquement lorsque l’artefact de transfert est lisible sur l’hôte cible.

Restaurez dans le volume cible spécifié

Vérifiez la capacité du système de fichiers cible, la disponibilité des inœuds, les attentes en matière d’UID et de GID, ainsi que l’utilisation de la même version de l’image de l’application. Restaurez l’archive dans le volume cible vide sans aplatir sa structure de répertoires de premier niveau, puis comparez les droits de propriété, le nombre de fichiers, les tailles et quelques sommes de contrôle sélectionnées.

Une discussion communautaire sur un cas d’échec de migration d’un volume nommé montre pourquoi le remplacement direct des fichiers dans les répertoires internes des volumes Docker peut échouer ou laisser un état difficile à interpréter. Utilisez l’environnement d’exécution pour monter le volume dans un conteneur auxiliaire et effectuer la restauration via cette interface contrôlée.

Attachez d’abord uniquement une copie provisoire du service, en utilisant des ports alternatifs et sans accès aux systèmes de production associés. Si l’application signale une mise à niveau du schéma ou un état corrompu, arrêtez-vous et restaurez à nouveau le volume à partir de l’artefact intact après avoir résolu les problèmes de compatibilité de version.

Basculez et conservez un hôte de secours

Démarrez les dépendances avant l’application, puis vérifiez les journaux, la connexion, les enregistrements récents, les pièces jointes, les tâches planifiées et une écriture provisoire. Redémarrez la pile cible et confirmez qu’elle rattache le même volume nommé. Ne mettez à jour le proxy ou le DNS qu’une fois ces vérifications réussies.

L’article connexe de ZimaSpace sur la sauvegarde cohérente des données d’un conteneur peut vous aider si la cible démarre vide malgré une copie réussie. Comparez la source du montage d’exécution avec le volume prévu avant de recopier les données ; des copies répétées vers la mauvaise cible ne font qu’ajouter de la confusion.

Laissez l’application source à l’arrêt et l’ancien volume en lecture seule jusqu’à ce qu’une nouvelle sauvegarde et un test de restauration réussissent sur la cible. Revenez à la source inchangée uniquement si aucune nouvelle écriture n’a été acceptée sur la cible ; sinon, arrêtez-vous et réconciliez les données de manière réfléchie.

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.