Containergegevens naar een SSD-pool verplaatsen zonder koppelingspaden te verbreken

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Verplaats de gegevensbron aan de hostzijde naar de SSD, maar behoud voor elke container hetzelfde bestemmingspad aan de containerzijde.

Bij een veilige migratie geldt de huidige koppelingsindeling als een interfacecontract. Containers, databases en media-apps verwachten paden zoals /config, /data of /media, ongeacht welke schijf ze levert. De werkwijze moet schrijfbewerkingen stoppen, de SSD voorspelbaar aankoppelen, eigenaarschap en metadata kopiëren, alleen de bron op de host bijwerken, de nieuwe koppeling vóór het opstarten controleren en de oorspronkelijke gegevens behouden totdat een volledige hersteltest is geslaagd.

Inventariseer elke huidige bron en bestemming in de container

Exporteer het Compose-bestand of de containerinspectiegegevens en noteer elke bind mount, elk benoemd volume, elke tmpfs-mount, elke databasemap, cache, transcodeerpad en medialocatie. Noteer de bron op de host en de bestemming in de container afzonderlijk.

Een praktische handleiding voor volumemigratie begint met het vinden van de huidige gegevens en het stoppen van de containers voordat je de gegevens naar een nieuwe schijflocatie kopieert. Dankzij die inventarisatie blijft er geen configuratie op de systeemschijf achter.

Noteer welke paden de gezaghebbende status, opnieuw op te bouwen cache en grote mediabestanden bevatten. Ga er niet van uit dat een map met de naam data alle blijvende applicatiestatus bevat.

Koppel de SSD-pool voorspelbaar aan voordat Docker start

Maak het bestandssysteem of de pool op de SSD aan, identificeer deze met een stabiele UUID of poolnaam en koppel hem aan op het definitieve hostpad. Controleer na een herstart de vrije ruimte, de verwachte functies van het bestandssysteem en de schrijfrechten.

Het verplaatsen van Docker-gegevens naar externe opslag kan mislukken als de schijf ontbreekt of bij het opstarten op een ander pad is aangekoppeld. Een recente situatie met een externe SSD laat zien hoe het verplaatsen van Docker-opslag afhankelijkheid creëert van het doelpad voor de koppeling.

Configureer de volgorde van services of het automountgedrag zo dat Docker nooit een lege terugvalmap op de systeemschijf aanmaakt. Ga niet verder als de SSD niet op het exact verwachte pad is aangekoppeld.

Stop schrijvende processen en kopieer gegevens met behoud van metadata

Stop de applicatie en alle afhankelijkheden die naar de gegevens kunnen schrijven, waaronder databases, indexeerders, downloaders en achtergrondtaken. Maak voor databases een applicatieconsistente dump of sluit ze netjes af voordat je de ruwe bestanden kopieert.

In een Synology-containerdiscussie wordt aangeraden een door Docker beheerd volume pas naar een bind mount te verplaatsen nadat je de volumegegevens hebt geïdentificeerd en de inhoud ervan hebt behouden op de nieuwe bron voor de bind mount.

Kopieer recursief en behoud waar mogelijk eigenaarschap, machtigingen, tijdstempels, koppelingen, ACL's en uitgebreide attributen. Voer na het kopiëren en voordat je Compose wijzigt een proefvergelijking uit of controleer een checksumsteekproef.

Single board computer zimaboard2

Wijzig alleen het bronpad op de host

Houd de bestemmingslocatie in de container hetzelfde. Wijzig bijvoorbeeld /oldpool/app:/config in /ssdpool/app:/config in plaats van de applicatie een nieuw intern pad aan te leren.

Bind mounts maken een exacte hostlocatie toegankelijk via een vast pad in de container. Een opslagoverzicht legt uit dat deze directe koppeling handig is wanneer beheerders controle over het hostpad nodig hebben.

Door de bestemmingslocatie te behouden, voorkom je dat applicatiedatabases, bibliotheekverwijzingen, scripts, machtigingen en configuratiewaarden met het containerpad erin stukgaan.

Herstel eigenaarschap, labels en databaseconsistentie

Vergelijk de numerieke UID- en GID-waarden die de image verwacht met het eigenaarschap op de SSD. Herstel ook ACL's, SELinux-labels, AppArmor-toestemmingen en mountopties die nodig zijn voor vergrendeling of memory-mapped bestanden.

In een handleiding voor het migreren van Docker-opslag op macOS staat dat je voor het verplaatsen van Docker-gegevens de volledige opslagkopie moet kopiëren en vervolgens moet bevestigen dat de runtime de nieuwe opslaglocatie gebruikt. Op Linux-NAS-systemen moet je op dezelfde manier controleren of elke geconfigureerde bron naar de gemounte SSD verwijst.

Start alleen de database en controleer de herstel日志boeken voordat je afhankelijke apps start. Als er corruptie of ontbrekende bestanden worden gemeld, stop dan en keer terug naar de oorspronkelijke kopie in plaats van de applicaties een lege database te laten initialiseren.

Schakel over met een rollbackmogelijkheid en test de volledige workflow

Start de stack in de juiste volgorde van afhankelijkheden en controleer de configuratie, databasegegevens, machtigingen, mediabibliotheken, uploads, downloads, updates en het opnieuw aanmaken van containers. Controleer of nieuwe gegevens op de SSD worden opgeslagen en de systeemschijf niet langer voller raakt.

Het ZimaSpace-artikel over een Docker-bindmount die alleen-lezen wordt beschrijft de volgende diagnose als het gemigreerde pad wel wordt gemount, maar schrijfbewerkingen weigert.

Houd de oude gegevens offline en ongewijzigd totdat back-ups zijn gemaakt en een tweede container opnieuw is opgebouwd vanaf het SSD-pad. Verwijder de oude bron pas nadat een rollbacktest heeft bewezen dat je het Compose-bestand, de mounts, databases en applicatiestatus kunt herstellen.

Ondersteuning en tips

Meer om te lezen

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.