Så åtgärdar du en Docker-bindmontering som plötsligt blir skrivskyddad

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 Docker-bindmontering blir skrivskyddad när Docker får en skrivskyddad sökväg eller när värdens filsystem slutar ta emot skrivningar.

Eftersom en bindmontering exponerar en sökväg på värden direkt inuti containern kan containern inte själv åtgärda en underliggande disk, ett filsystem, en monteringsflagga eller en säkerhetspolicy. Det säkraste sättet att återställa systemet är att stoppa skrivningar, jämföra containerns montering med värdens montering, ta reda på om det skrivskyddade läget har konfigurerats eller utlösts av ett fel och återställa lagringens funktion innan programmet startas om.

Bekräfta vilken sökväg som är skrivskyddad

Testa att göra en ofarlig skrivning i containern vid bindmålet och en annan skrivning på värden vid källsökvägen. Notera det exakta felet i stället för att anta att alla behörighetsfel betyder att filsystemet är skrivskyddat.

Ett Docker-forumärende visar att en skrivskyddad överordnad bindmontering kan hindra Docker från att skapa en nästlad monteringspunkt, eftersom den nödvändiga katalogen inte kan skapas på det skrivskyddade överordnade filsystemet.

Om värden kan skriva men containern inte kan det ska du granska Dockers monteringsalternativ och säkerhetskontroller. Om båda misslyckas med ett fel om skrivskyddat filsystem ska du sluta ändra containerns användare och i stället felsöka värdens montering och lagringsenheten.

Kontrollera Dockers effektiva monteringsflaggor

Granska konfigurationen för den körande containern i stället för att bara titta på den aktuella Compose-filen. Bekräfta källan, målet, spridningsläget och om monteringen är markerad som skrivskyddad med :ro, lång syntax, en åsidosättningsfil eller ett distributionsverktyg.

Ett Docker-klientärende dokumenterar fall där monterade sökvägar verkade vara skrivskyddade eftersom körtidskonfigurationen skilde sig från den avsedda konfigurationen med läs- och skrivrättigheter. Den viktiga informationen är det faktiska monteringsläget för den körande containern.

Om monteringen avsiktligt är skrivskyddad ska du ta bort den flaggan bara om programmet verkligen behöver skriva. Återskapa containern när du har ändrat deklarationen, eftersom en ändring i en Compose-fil inte retroaktivt ändrar en befintlig montering.

Ta reda på om värden monterade om filsystemet skrivskyddat

Kontrollera värdens monteringstabell, kärnlogg, lagringslogg och filsystemets status efter I/O-fel, journalfel, kontrollsummefel, enhetsåterställningar eller en skyddande ommontering. Tvinga inte fram en ommontering med läs- och skrivrättigheter innan du förstår varför skyddet aktiverades.

Ett supportärende om Unraid beskriver hur Docker-appdata slutade fungera efter att ett filsystem blev skrivskyddat, med fel när Plex-kataloger skulle skapas. Det mönstret tyder på ett fel i värdens filsystem snarare än en behörighetsinställning för containern.

Stoppa berörda containrar och spara diagnostikdata. Reparera disken, lagringspoolen, kabeln, filsystemet eller journalen enligt plattformens stödda underhållsrutin. Kontrollera sedan att värdsökvägen fungerar som den ska innan databas- eller mediacontainrar får skriva igen.

Single board computer zimaboard2

Granska nästlade och överlappande monteringar

Lista alla bind-monteringar och namngivna volymer vars mål ligger i en annan monterad katalog. Överlappande monteringar kan dölja kataloger, medföra oväntat åtkomstbeteende eller kräva att Docker skapar en monteringspunkt under en skrivskyddad överordnad katalog.

En diskussion på Server Fault förklarar att överlagring av en skrivbar montering och en mer omfattande skrivskyddad montering på närliggande sökvägar i containern kan ge förvirrande resultat. Eftersom den domänen redan används på annat håll i det här batchjobbet är den praktiska regeln här att kartlägga hela målkatalogträdet innan behörigheterna ändras.

Skapa nödvändiga värdkataloger innan du startar containern, undvik att montera en skrivbar underordnad katalog under en skrivskyddad överordnad katalog när körmiljön måste skapa den, och ange beständiga sökvägar uttryckligen i Compose. Återskapa containern efter att ha förenklat monteringsstrukturen.

Skilj skrivskyddat tillstånd från behörigheter och säkerhetspolicy

Jämför felet från ett skrivtest med källkatalogens ägare, läge, ACL, SELinux-etikett, AppArmor-profil och användar-ID för containern. Åtkomst nekad och skrivskyddat filsystem är olika fel som kräver olika åtgärder.

En guide för felsökning av lagring delar in incidenter med skrivskyddade volymer i monteringsflaggor, filsystemfel, säkerhetskontexter och problem med lagringsdrivrutiner. Den klassificeringen hjälper till att undvika ett ogenomtänkt svar med chmod 777 på ett skrivskyddat tillstånd i lagringslagret.

Om behörigheterna är felaktiga korrigerar du ägarskap eller ACL:er på värden med avsedd UID och GID för containern. Om filsystemet i sig är skrivskyddat misslyckas behörighetsändringar och ska inte användas i stället för att reparera filsystemet.

Starta om programmet först när ett skrivtest på värden har godkänts

Skriv, synkronisera, läs och ta bort en tillfällig fil på värdsökvägen. Upprepa sedan testet i en kortlivad testcontainer med samma monteringsdeklaration och användare. Kontrollera att det förväntade filsystemet fortfarande är monterat efter en omstart.

ZimaSpaces guide för att hitta ett beroende som orsakar omstarter av containrar är nästa steg om programmet fortsätter att starta om i en loop efter att lagringen blivit skrivbar.

Reparationen är slutförd först när värdfilsystemet är felfritt, den aktiva Docker-monteringen är skrivbar enligt avsikten, programmet kan uppdatera sina beständiga filer och inga nya I/O- eller filsystemfel uppstår vid långvarig användning.

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.