Waardoor kan een container de systeemschijf vullen terwijl de gegevens ergens anders staan?

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.

Een container kan de systeemschijf vullen wanneer logboeken, caches, tijdelijke bestanden of onbedoelde schrijfbewerkingen in de lokale opslag van Docker blijven staan.

Als je een mediabibliotheek of databasevolume naar een andere pool verplaatst, worden de containerimage, schrijfbare laag, JSON-logboek, BuildKit-cache, metadata en paden die ontbreken in de lijst met koppelingen niet mee verplaatst. Een mislukte externe koppeling kan er ook voor zorgen dat de verwachte map op de host leeg blijft, waardoor de applicatie nieuwe gegevens op de systeemschijf schrijft zonder een duidelijke foutmelding.

Meet de Docker-root voordat je applicatiegegevens controleert

Controleer het bestandssysteem waarop de gegevensroot van Docker staat en vergelijk de grootte van mappen op de host met de rapportage van Docker voor images, containers, volumes en de buildcache. Noteer het gebruik voordat je iets verwijdert.

Een Cloudron-gebruiker ontdekte dat /var/lib/docker/overlay2 meer ruimte innam dan alle zichtbare applicatiegegevens. Dit laat zien waarom je de Docker-opslagroot apart moet meten van externe bibliotheken.

Als de systeemschijf vol is maar de externe opslagpool nog ruimte heeft, bepaal dan of de groei zich bevindt in containers, overlaylagen, volumes, images of de buildcache. Voer niet zomaar een algemene prune uit voordat actieve en herstelbare gegevens zijn geclassificeerd.

Onbeperkte JSON-logboeken van containers controleren

Controleer de logdriver en de grootte van elk logbestand van de container. Een service kan zijn primaire gegevens ergens anders opslaan, terwijl stdout en stderr in de lokale containermap van Docker onbeperkt blijven groeien.

Code Maven documenteert een geval waarin docker system df het hoofdprobleem niet aan het licht bracht, omdat het standaardlogbestand bleef groeien buiten dat overzicht om. De verborgen ruimtevreter was een logboek van een container dat voortdurend bleef groeien.

Spoor de fout in de applicatie op die het probleem veroorzaakt en los die op voordat je logboeken roteert of afkapt. Configureer logrotatie met limieten voor toekomstige containers en controleer of de nieuwe bestanden niet verder groeien dan de ingestelde limiet.

Gegevens opsporen die naar de schrijfbare laag van de container zijn geschreven

Vergelijk de bedoelde persistente paden met de daadwerkelijke cache-, transcodeer-, download-, database-, miniatuur-, back-up- en tijdelijke mappen van de applicatie. Alle schrijfbewerkingen naar niet-gemounte paden blijven in de schrijfbare laag van de container op de systeemschijf.

Een uitleg op een Docker-forum vermeldt dat schrijfbewerkingen en gewijzigde imagebestanden worden opgeslagen in de schrijfbare laag, terwijl grote, niet-geroteerde logboeken in de metadata van de container staan. Beide kunnen ervoor zorgen dat één container bijna alle lokale opslagruimte in beslag neemt, ondanks een extern datavolume.

Gebruik rapportage van de grootte per container en controleer de grootste gewijzigde paden in de container. Voeg expliciete bindkoppelingen of benoemde volumes alleen toe voor gegevens die bewaard moeten blijven en maak de container opnieuw aan om verouderde inhoud van de beschrijfbare laag te verwijderen nadat je waardevolle gegevens hebt geback-upt.

Controleer of de externe koppeling aanwezig was toen de container startte

Controleer of de SSD, NAS-share of opslagpool op het verwachte hostpad was gekoppeld voordat Docker de container startte. Vergelijk de apparaatidentiteit en de uitvoer van de koppeling met de map die de container ziet.

Wanneer een externe koppeling ontbreekt, kan de onderliggende lege map op het systeembestandssysteem nog steeds bestaan. De container kan normaal naar die terugvalmap schrijven, waardoor de systeemschijf groeit terwijl de externe pool onaangeroerd lijkt.

Stop de container voordat je de opslag opnieuw koppelt over bestaande terugvalgegevens heen. Verplaats de verborgen bestanden veilig of stem ze op elkaar af, voeg afhankelijkheden van koppelingen of opstartcontroles toe en weiger de applicatie te starten als het verwachte apparaat ontbreekt.

Controleer imagelagen, de buildcache en achtergelaten objecten

Controleer ongebruikte images, gestopte containers, anonieme volumes en de BuildKit-cache. Regelmatige updates of lokale builds kunnen veel lagen opstapelen, zelfs wanneer de permanente gegevens van de applicatie correct elders zijn gekoppeld.

Een uitleg op het forum van het Moby-project maakt duidelijk dat overlay-koppelingen schijfmetingen verwarrend kunnen maken en dat het gebruik van het onderliggende bestandssysteem zorgvuldig moet worden geïnterpreteerd. Ook bleek in een afzonderlijk geval met Home Assistant dat overlay2 in de loop van de tijd groeide door logs en lagen.

Verwijder alleen objecten waarvan is bevestigd dat ze niet worden gebruikt door de huidige Compose-projecten en back-ups. Verwijder nooit handmatig afzonderlijke overlay2-mappen, omdat de metagegevensverwijzingen van Docker dan inconsistent kunnen raken.

Valideer de oplossing met een groeibaseline

Nadat je het verantwoordelijke pad hebt gecorrigeerd, leg je op regelmatige tijdstippen het Docker-rootgebruik, de loggroottes, de beschrijfbare containergroottes en het gebruik van de externe pool vast tijdens de belasting die eerder groei veroorzaakte.

De ZimaSpace-workflow voor het voorbereiden van een grote NAS-overdracht biedt een herhaalbare belasting om te controleren of gegevens op de beoogde pool terechtkomen.

Het probleem is pas opgelost wanneer de groei van de systeemschijf overeenkomt met de verwachte image- en logactiviteit, de permanente applicatiegegevens op de externe pool groeien en een ontbrekende externe koppeling leidt tot een veilige mislukte opstart in plaats van ongemerkt schrijven naar het rootbestandssysteem.

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.