Varför ansluter en Compose-stack en ny, tom namngiven volym efter omdistribution?

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.

En Compose-stack kan ansluta en ny, tom namngiven volym om omdistributionen ändrar det projektspecifika volymnamnet eller inte hittar originalvolymen.

De gamla uppgifterna kan fortfarande finnas i en annan Docker-volym medan den återskapade tjänsten monterar en nygenererad volym på samma sökväg i containern. Vanliga orsaker är ett ändrat stack- eller projektnamn, en ändrad volymnyckel, borttagning med ett kommando som raderar volymer, att en extern deklaration saknas, distribution via en annan hanterare eller ett explicit volymnamn som nu pekar på något annat. Inventera både den monterade volymen och föräldralösa kandidater innan du återställer data eller initierar appen.

Identifiera exakt vilken volym den nya containern har monterat

Inspektera den körande containerns monteringar och anteckna volymnamn, drivrutin, monteringspunkt, etiketter, skapandetid, containerns målkatalog och läs- och skrivläge. Jämför dem med uppgifter från före omdistributionen.

Ubuntus kommando docker volume inspect visar volymens identitet, vilket gör det möjligt att skilja den nya tomma volymen från en äldre omonterad volym med ett liknande namn.

Kopiera inte data till den nya volymen innan originalet har hittats. Om du startar appen kan en ny databas skapas, vilket får målet att se ut som om det har initierats avsiktligt.

Kontrollera om Compose-projektnamnet har ändrats

Jämför det gamla och det nya projektnamnet, stacknamnet, Compose-katalogen, alternativet -p, COMPOSE_PROJECT_NAME, toppnivåfältet name: och distributionshanteraren.

Docker förklarar att Compose normalt namnger en volym med projektnamnet plus volymnyckeln, såvida inte ett explicit namn eller en sökning efter en extern volym har konfigurerats.

Om du flyttar samma Compose-fil till en annan katalog kan det därför skapas ett andra projekt och en andra volym, även om tjänste- och volymnycklarna är oförändrade.

Verifiera stabilt namn och inställningar för externa volymer

Jämför den övergripande volymdefinitionen före och efter omdriftsättningen. Kontrollera name:, external:, drivrutinsalternativ, interpoleringsvariabler och om den förväntade volymen finns.

Microsofts Docker Compose-självstudie nämner att namngivna volymer består oberoende av om containrar byts ut, så ett nytt, tomt tillstånd innebär vanligtvis att en annan volymidentitet kopplades till eller att den gamla volymen togs bort.

Markera en volym som extern endast när dess livscykel avsiktligt hanteras utanför stacken. Compose bör tydligt misslyckas om en extern volym saknas, i stället för att i tysthet skapa en ersättning.

Kontrollera om en rensning tog bort den ursprungliga volymen

Granska driftsättningsloggar, skript, användargränssnittsåtgärder, rensningsjobb och kommandon som tar bort volymer. Jämför när volymen skapades med händelsen då den driftsattes på nytt.

Red Hat dokumenterar att namngivna volymer som hanteras av containrar har separata lagringsplatser från containrarnas skrivbara lager. Därför är det två skilda livscykelhändelser att ta bort en container respektive dess namngivna volym.

Om den ursprungliga volymen saknas ska du stoppa automatiska starter och återställa endast från en verifierad säkerhetskopia. Utgå inte från att en tom ersättningsvolym innehåller ett återställningsbart borttaget lager.

Jämför stackens identitet och driftsättningsmetod

Anteckna om stacken startades via CLI, Portainer, en NAS-appbutik, Git-driftsättning eller något annat automatiseringsverktyg. Jämför stacknamnet och miljövärdena som lagras av det verktyget.

Portainer kräver ett beskrivande stacknamn vid driftsättning, och den identitet som hanteras av den ansvariga tjänsten kan skilja sig från det katalogbaserade projektnamn som används av ett manuellt Compose-kommando.

En manuell nödstart kan därför skapa resurser under ett annat projektprefix. Välj en ansvarig för driftsättningen och dokumentera de fullständiga volymnamn som skapas.

Uteslut att data döljs under den nya volymmonteringen

Stoppa containern och inspektera avbildningen eller bind-sökvägen utan den namngivna volymen ansluten i ett engångstest. Ta reda på om startprocessen skrev data till containerlagret innan volymen monterades.

Linux manual för mount förklarar att en montering döljer befintligt kataloginnehåll, så data kan verka saknas när en ny, tom volym täcker filer som skapats i avbildningen eller det skrivbara lagret.

Slå inte ihop det dolda lagret och den gamla beständiga volymen utan eftertanke. Ta reda på vilket tillstånd som är det rätta och använd programmets stödda återställningsmetod.

Återanslut den ursprungliga volymen med ett kontrollerat test

Stoppa stacken, säkerhetskopiera båda kandidatvolymerna, anslut den ursprungliga till en engångscontainer eller en tillfällig tjänstsökväg och verifiera programfiler, databasidentitet, ägarskap och tidsstämplar.

ZimaSpaces guide till att flytta containerdata utan att förstöra monteringar beskriver det närliggande arbetsflödet för sökvägsmappning; den här artikeln fokuserar på identiteten hos projektspecifika namngivna volymer.

Problemet är löst när den avsedda gamla volymen monteras med ett stabilt, uttryckligt eller externt namn och upprepade omdriftsättningar återanvänder den utan att skapa ännu en tom kandidat.

Vanliga frågor

Betyder en tom namngiven volym att de gamla uppgifterna har raderats?

Inte nödvändigtvis. Den gamla volymen kan fortfarande finnas under ett annat projektprefix eller ett uttryckligt namn, medan den nya containern använder en annan, tom volym.

Kan ett namnbyte på Compose-mappen skapa en ny volym?

Ja. Om inget projektnamn är fastställt kan Compose härleda det från projektkatalogen och skapa resurser med olika prefix.

Bör viktiga volymer markeras som externa?

Externa volymer kan förhindra att stackborttagning hanterar deras livscykel, men de kräver noggrann hantering av skapande, namngivning, säkerhetskopiering och driftsättningskontroller.

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.