Guide för migrering av ZFS-dataset: Flytta data utan att ändra containersökvägar

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Det säkra tillvägagångssättet är att behandla replikering, verifiering och atomär övergång till den ursprungliga mountpointen, med en återställningsdataset bevarad, som en följd av observerbara kontrollpunkter och inte som ett enda kommando.

För en ZFS-dataset som ligger till grund för en containerstack på en hemmaserver är den praktiska risken att behöva flytta en ZFS-dataset samtidigt som bind mount-sökvägarna som containrarna använder bevaras. Dokumentera den nuvarande identiteten och återställningspunkten, börja med det minst ingripande testet, tolka godkända och underkända resultat innan du ändrar ytterligare en variabel och avbryt om lagringen blir instabil eller den enda återställningsbara kopian skulle utsättas för risk. Arbetsflödet nedan är inte slutfört förrän den ursprungliga arbetsbelastningen fungerar eller underlaget visar att frågan behöver eskaleras.

Inventera dataseten och sökvägskraven

Dokumentera källdataseten, underordnade dataset, ögonblicksbilder, mountpoint, värdet för canmount, krypteringsrot, kvoter, reservationer, ACL-beteende och varje bind mount för containrar som pekar in i dataseten. Det som måste bevaras är värdsökvägen som containrarna ser; pool- och datasetnamnen kan ändras bakom den.

ZFS-replikering kan bevara ögonblicksbilder och egenskaper, så en rekursiv dataström kräver en noggrann granskning av egenskaperna i stället för en blind mottagning. En fristående guide om migrering med ZFS Send och Receive visar hur Send och Receive används för intern migrering av dataset och varför målhierarkin bör granskas före övergången.

Skapa en aktuell extern säkerhetskopia eller verifiera att en befintlig säkerhetskopia går att återställa innan migreringen. Avbryt om källan har dolda underordnade dataset, ett okänt beroende av en krypteringsnyckel eller en mountpoint som överlappar en annan aktiv dataset; sådana förhållanden kan göra att en korrekt dataström monteras på fel plats.

Ta emot den första kopian utan att montera den ovanpå produktionsmiljön

Skapa en rekursiv ögonblicksbild, till exempel zfs snapshot -r oldpool/apps@move-0, och skicka den till en måldataset som tas emot med montering inaktiverad eller med en tillfällig mountpoint. Använd de flaggor som passar dina krav på kryptering och egenskaper; utgå inte från att en rå, krypterad dataström och en dekrypterad mottagning hanterar nycklar på samma sätt.

När överföringen är klar jämför du zfs list -r -t filesystem,snapshot och zfs get -r mountpoint,canmount,encryptionroot,quota,reservation för båda träden. En forumdiskussion om replikerade mountpoint-egenskaper visar varför replikerade mountpoint-egenskaper kan överraska vid en i övrigt lyckad migrering.

Den första kopieringen är godkänd när datamängdens och ögonblicksbildernas historik stämmer överens och målet förblir åtskilt från produktionssökvägen. Om det monteras ovanpå källan eller ändrar filer som är synliga för containrarna exporterar eller avmonterar du målet och korrigerar egenskaperna innan någon inkrementell överföring.

Stäng skrivglappet och byt monteringspunkt

Ta en ny ögonblicksbild av källan och skicka den inkrementella skillnaden medan appen fortfarande körs. Inför det slutliga bytet stoppar du alla skrivningar, bekräftar att ingen process har öppna filer under bind-monteringssökvägen, tar en sista ögonblicksbild och skickar endast den skillnaden. Begränsa driftstoppet till den slutliga synkroniseringen och bytet av sökväg.

Ställ in källan på en monteringspunkt som inte används i produktion eller på canmount=noauto, tilldela sedan den ursprungliga värdsökvägen till målet och montera det. Låt aldrig två datamängder göra anspråk på samma monteringspunkt. Starta databasen och beroende tjänster innan applikationens gränssnitt, så att fel kan hänföras till rätt lager.

Om den sista överföringen misslyckas monterar du källan på den ursprungliga sökvägen igen och startar om stacken. Blanda inte nya skrivningar mellan de båda kopiorna. Villkoret för återställning är tydligt: källan förblir intakt och inga produktionsskrivningar tillåts på målet förrän den sista dataströmmen och egenskapskontrollerna har godkänts.

Validera containrar på den oförändrade sökvägen

Kontrollera bind-monteringar i containerruntime-miljön, öppna representativa filer, skapa och ta bort en tillfällig fil via appen och bekräfta ägarskap, ACL:er, utökade attribut och rapportering av ledigt utrymme. Starta om stacken två gånger och verifiera att ZFS monteras innan containrarna startar.

Kör en scrub eller annan kontroll av poolens hälsa enligt din underhållsplan, men använd den inte som enda bevis på att migreringen lyckats. Jämför ögonblicksbilds-GUID:er eller ett representativt hashmanifest, återställ ett litet objekt och använd ZimaSpace-testet för att kontrollera om ZFS-replikering kan återupptas efter avbrott innan källhistoriken avvecklas.

Behåll källan skrivskyddad tills minst en vanlig säkerhetskopiering och en applikationscykel har slutförts utan problem. Avveckla den först när containrarna använder de ursprungliga sökvägarna, schemalagda jobb riktas mot den nya datamängden, replikeringen fortsätter från den avsedda historiken och det inte längre behövs någon återställning. Återställ annars monteringspunkten och bevara båda historikerna.

Support och tips

Mer att läsa

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.