Guide de migration des jeux de données ZFS : déplacer les données sans modifier les chemins des conteneurs

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.

La méthode sûre consiste à traiter la réplication, la vérification et le basculement atomique de l’ancien point de montage, avec conservation d’un jeu de données de retour arrière, comme une suite de jalons observables et non comme une seule commande.

Pour les jeux de données ZFS qui prennent en charge une pile de conteneurs sur un serveur domestique, le risque pratique consiste à déplacer un jeu de données ZFS tout en préservant les chemins des montages liés utilisés par les conteneurs. Consignez l’identité actuelle et le point de récupération, commencez par le critère le moins invasif, 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 la seule copie récupérable risque d’être exposée. 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.

Inventoriez le jeu de données et le contrat de chemin

Consignez le jeu de données source, ses enfants, ses instantanés, son point de montage, la valeur de canmount, la racine de chiffrement, les quotas, les réservations, le comportement des ACL et chaque montage lié de conteneur qui pointe vers son contenu. Le contrat correspond au chemin hôte vu par les conteneurs ; le nom du pool et du jeu de données peut changer sans modifier ce chemin.

La réplication ZFS peut préserver les instantanés et les propriétés ; un flux récursif nécessite donc un examen attentif des propriétés plutôt qu’une réception aveugle. Un autre guide sur la migration avec ZFS Send et Receive montre comment ces commandes servent à migrer des jeux de données en interne et pourquoi il faut inspecter la hiérarchie cible avant le basculement.

Créez une sauvegarde externe à jour ou vérifiez qu’une restauration existante fonctionne avant la migration. Arrêtez-vous si la source contient des jeux de données enfants masqués, dépend d’une clé de chiffrement inconnue ou utilise un point de montage qui chevauche celui d’un autre jeu de données actif ; ces situations peuvent faire monter un flux valide au mauvais endroit.

Recevez la première copie sans la monter par-dessus l’environnement de production

Créez un instantané récursif, par exemple zfs snapshot -r oldpool/apps@move-0, puis envoyez-le vers un jeu de données cible reçu sans montage ou avec un point de montage temporaire. Utilisez les indicateurs adaptés à vos exigences en matière de chiffrement et de propriétés ; ne partez pas du principe qu’un flux chiffré brut et une réception déchiffrée se comportent de la même façon avec les clés.

Après réception, comparez zfs list -r -t filesystem,snapshot et zfs get -r mountpoint,canmount,encryptionroot,quota,reservation sur les deux arborescences. Une discussion sur le forum à propos des propriétés mountpoint répliquées montre pourquoi ces propriétés peuvent réserver des surprises lors d’une migration pourtant réussie.

La première copie est validée lorsque la filiation du jeu de données et des snapshots correspond et que la cible reste isolée du chemin de production. Si elle se monte par-dessus la source ou modifie les fichiers visibles par les conteneurs, exportez ou démontez la cible et corrigez les propriétés avant tout envoi incrémentiel.

Combler la fenêtre d’écriture et changer le point de montage

Prenez un autre snapshot source et envoyez les différences incrémentielles pendant que l’application fonctionne encore. Pour la bascule finale, arrêtez tous les processus d’écriture, vérifiez qu’aucun processus n’a de fichiers ouverts sous le chemin du montage bind, prenez un snapshot final et envoyez uniquement ce delta. Limitez l’interruption au temps nécessaire à la synchronisation finale et au changement de chemin.

Définissez un point de montage hors production pour la source, ou canmount=noauto, puis attribuez le chemin hôte d’origine à la cible et montez-la. Ne laissez jamais deux jeux de données revendiquer le même point de montage. Démarrez la base de données et les services qui en dépendent avant l’interface de l’application, afin que les erreurs indiquent la couche concernée.

Si l’envoi final échoue, remontez la source au chemin d’origine et redémarrez la pile ; ne répartissez pas les nouvelles écritures entre les deux copies. La condition de retour arrière est explicite : la source reste intacte et aucune écriture de production n’est acceptée sur la cible tant que le flux final et les vérifications des propriétés n’ont pas réussi.

Valider les conteneurs à leur chemin inchangé

Inspectez les montages bind depuis le runtime des conteneurs, ouvrez des fichiers représentatifs, créez puis supprimez un fichier temporaire via l’application et vérifiez la propriété, les ACL, les attributs étendus et l’espace libre indiqué. Redémarrez la pile deux fois et vérifiez que les montages ZFS sont effectués avant le démarrage des conteneurs.

Effectuez un scrub ou un autre contrôle de l’état du pool conformément à votre plan de maintenance, mais ne vous en servez pas comme seule preuve de migration. Comparez les GUID des snapshots ou un manifeste de hachage représentatif, restaurez un petit élément et utilisez le test ZimaSpace pour vérifier si la réplication ZFS peut reprendre après une interruption avant de retirer la filiation source.

Conservez la source en lecture seule jusqu’à ce qu’au moins une sauvegarde normale et un cycle applicatif aient réussi. Ne la retirez que lorsque les conteneurs utilisent les chemins d’origine, que les tâches planifiées ciblent le nouveau jeu de données, que la réplication se poursuit à partir de la filiation prévue et qu’aucun retour arrière n’est plus nécessaire ; sinon, rétablissez le point de montage et conservez les deux historiques.

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.