Handleiding voor ZFS-datasetmigratie: verplaats gegevens zonder containerpaden te wijzigen

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.

De veilige aanpak is om repliceren, verifiรซren en het oorspronkelijke mountpoint atomair omschakelen te behandelen als een reeks observeerbare controles, met behoud van een rollbackdataset, en niet als รฉรฉn enkele opdracht.

Bij een ZFS-dataset die de basis vormt voor een containerstack op een homeserver, is het praktische risico dat je een ZFS-dataset moet verplaatsen met behoud van de bind-mountpaden die containers gebruiken. Leg de huidige identiteit en het herstelpunt vast, begin met de minst ingrijpende onderscheidende test, interpreteer geslaagde en mislukte resultaten voordat je een andere variabele wijzigt, en stop zodra de opslag instabiel wordt of de enige herstelbare kopie gevaar loopt. De onderstaande procedure is pas afgerond als de oorspronkelijke workload werkt of het bewijsmateriaal een escalatiegrens bereikt.

Breng de dataset en het padcontract in kaart

Leg de brondataset, childdatasets, snapshots, het mountpoint, de canmount-waarde, de encryptieroot, quota's, reserveringen, het ACL-gedrag en elke bind mount van een container die erin terechtkomt vast. De afspraak betreft het hostpad dat containers zien; de pool- en datasetnaam kunnen daaronder veranderen.

ZFS-replicatie kan snapshots en eigenschappen behouden, dus een recursieve stream vereist een zorgvuldige controle van eigenschappen in plaats van een blinde ontvangst. Een onafhankelijke ZFS-migratie met send en receive laat zien hoe send en receive worden gebruikt voor interne datasetmigratie en waarom de doelhiรซrarchie vรณรณr de omschakeling moet worden gecontroleerd.

Maak vรณรณr de migratie een actuele externe back-up of bewijs dat een bestaande back-up kan worden teruggezet. Stop als de bron verborgen childdatasets, een onbekende afhankelijkheid van een versleutelingssleutel of een mountpoint heeft dat overlapt met een andere actieve dataset; hierdoor kan een correcte stream op de verkeerde locatie worden gekoppeld.

Ontvang de eerste kopie zonder die over de productieomgeving te koppelen

Maak een recursieve snapshot, zoals zfs snapshot -r oldpool/apps@move-0, en verstuur die naar een doeldataset die is ontvangen met koppelen uitgeschakeld of met een tijdelijk mountpoint. Gebruik de juiste vlaggen voor je versleuteling en eigenschappen; ga er niet van uit dat een onbewerkte versleutelde stream en een ontsleutelde ontvangst hetzelfde sleutelgedrag hebben.

Vergelijk na ontvangst op beide boomstructuren zfs list -r -t filesystem,snapshot en zfs get -r mountpoint,canmount,encryptionroot,quota,reservation. Een forumdiscussie over gerepliceerde mountpoint-eigenschappen laat zien waarom gerepliceerde mountpoint-eigenschappen een verder succesvolle migratie kunnen verrassen.

De eerste kopie is geslaagd wanneer de dataset en de snapshot-afstamming overeenkomen en het doel geรฏsoleerd blijft van het productiepad. Als het doel over de bron heen wordt aangekoppeld of bestanden wijzigt die zichtbaar zijn voor containers, exporteer of ontkoppel het doel dan en corrigeer de eigenschappen voordat je een incrementele send uitvoert.

Dicht het schrijfgat en schakel het koppelpunt om

Maak nog een snapshot van de bron en verstuur de incrementele verschillen terwijl de app nog actief is. Stop voor de definitieve omschakeling alle schrijvers, controleer of geen enkel proces bestanden heeft geopend onder het bindmountpad, maak een laatste snapshot en verstuur alleen die delta. Beperk de downtime tot de laatste synchronisatie en de omschakeling van het pad.

Stel de bron in op een niet-productiekoppelpunt of canmount=noauto en wijs vervolgens het oorspronkelijke hostpad toe aan het doel en koppel dat aan. Laat nooit twee datasets hetzelfde koppelpunt claimen. Start de database en afhankelijke services vรณรณr de applicatiefrontend, zodat fouten aan de juiste laag kunnen worden gekoppeld.

Als de laatste send mislukt, koppel de bron dan weer aan op het oorspronkelijke pad en herstart de stack; vermeng geen nieuwe schrijfbewerkingen over beide kopieรซn. De voorwaarde voor terugdraaien is duidelijk: de bron blijft intact en er worden geen productieschrijfbewerkingen op het doel geaccepteerd totdat de laatste stream- en eigenschapscontroles zijn geslaagd.

Valideer containers op het ongewijzigde pad

Controleer de bindmounts in de containerruntime, open representatieve bestanden, maak via de app een tijdelijk bestand aan en verwijder het weer, en controleer eigenaarschap, ACL's, uitgebreide kenmerken en de melding van de vrije ruimte. Herstart de stack twee keer en controleer of ZFS wordt aangekoppeld voordat de containers starten.

Voer volgens je onderhoudsplan een scrub of een andere controle van de poolgezondheid uit, maar gebruik die niet als enig bewijs van een geslaagde migratie. Vergelijk snapshot-GUID's of een representatief hashmanifest, herstel een klein item en gebruik de ZimaSpace-test om te controleren of ZFS-replicatie na een onderbreking kan worden hervat voordat je de bron-lineage verwijdert.

Behoud de bron alleen-lezen totdat ten minste รฉรฉn normale back-up- en toepassingscyclus is geslaagd. Verwijder de bron pas wanneer containers de oorspronkelijke paden gebruiken, geplande taken op de nieuwe dataset zijn gericht, replicatie vanaf de beoogde lineage doorgaat en terugdraaien niet meer nodig is; herstel anders het koppelpunt en bewaar beide geschiedenissen.

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.