Waarom koppelt een Compose-stack na opnieuw implementeren een nieuw, leeg benoemd volume?

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 Compose-stack kan een nieuw, leeg volume met een vaste naam koppelen als de implementatie de projectgebonden volumenaam wijzigt of het oorspronkelijke volume niet kan vinden.

De oude gegevens staan mogelijk nog in een ander Docker-volume, terwijl de opnieuw aangemaakte service een nieuw gegenereerd volume koppelt aan hetzelfde pad in de container. Veelvoorkomende oorzaken zijn een gewijzigde stack- of projectnaam, een hernoemde volumesleutel, verwijdering met een opdracht die volumes verwijdert, het ontbreken van een externe declaratie, implementatie via een andere manager of een expliciete volumenaam die nu naar iets anders verwijst. Breng zowel het gekoppelde volume als verweesde kandidaten in kaart voordat je gegevens terugzet of de app initialiseert.

Bepaal welk volume precies aan de nieuwe container is gekoppeld

Inspecteer de mounts van de actieve container en noteer de volumenaam, driver, mountpoint, labels, aanmaaktijd, bestemmingspad in de container en lees-schrijfmodus. Vergelijk deze met gegevens van vóór de nieuwe implementatie.

Met de opdracht docker volume inspect van Ubuntu kun je de volume-identiteit bekijken, zodat je het nieuwe lege volume kunt onderscheiden van een ouder, niet-aangekoppeld volume met een vergelijkbare naam.

Kopieer geen gegevens naar het nieuwe volume voordat het origineel is gevonden. Bij het starten van de app kan een nieuwe database worden aangemaakt, waardoor de bestemming eruitziet alsof die bewust is geïnitialiseerd.

Controleer of de naam van het Compose-project is gewijzigd

Vergelijk de oude en nieuwe projectnaam, stacknaam, Compose-map, optie -p, COMPOSE_PROJECT_NAME, de naam op het hoogste niveau name: en de implementatiemanager.

Docker legt uit dat Compose een volume normaal gesproken een naam geeft met de projectnaam plus de volumesleutel, tenzij een expliciete naam of externe volumezoekopdracht is ingesteld.

Als je hetzelfde Compose-bestand naar een andere map verplaatst, kan daardoor een tweede project en een tweede volume ontstaan, zelfs als de service- en volumesleutels ongewijzigd zijn.

Stabiele naam en instellingen voor externe volumes controleren

Vergelijk de definitie van het volume op hoofdniveau vóór en na de redeployment. Controleer name:, external:, driveropties, interpolatievariabelen en of het verwachte volume bestaat.

In de Docker Compose-tutorial van Microsoft staat dat benoemde volumes onafhankelijk van de vervanging van containers blijven bestaan. Een nieuwe, lege status betekent dus meestal dat er een ander volume is gekoppeld of dat het oude volume is verwijderd.

Markeer een volume alleen als extern wanneer de levenscyclus ervan bewust buiten de stack wordt beheerd. Compose moet duidelijk mislukken als een extern volume ontbreekt, in plaats van stilzwijgend een vervangend volume aan te maken.

Controleer of een opschoonactie het oorspronkelijke volume heeft verwijderd

Controleer deploymentlogboeken, scripts, UI-acties, opschoontaken en opdrachten op verwijdering van volumes. Vergelijk het tijdstip waarop het volume is aangemaakt met de redeployment.

Red Hat documenteert dat door containers beheerde benoemde volumes afzonderlijke opslaglocaties hebben ten opzichte van schrijfbare containerlagen. Daarom zijn het verwijderen van een container en het verwijderen van het benoemde volume verschillende gebeurtenissen in de levenscyclus.

Als het oorspronkelijke volume ontbreekt, stop dan automatische starts en herstel alleen vanaf een geverifieerde back-up. Ga er niet van uit dat een leeg vervangend volume een herstelbare verwijderde laag bevat.

Vergelijk de identiteit van de stackbeheerder en de deploymentmethode

Noteer of de stack is gestart via de CLI, Portainer, een NAS-appstore, een Git-deployment of een andere automatiseringstool. Vergelijk de stacknaam en omgevingswaarden die door die beheerder zijn opgeslagen.

Portainer vereist een beschrijvende stacknaam bij de deployment, en die identiteit wordt door de beheerder bepaald en kan verschillen van de projectnaam op basis van de map die wordt gebruikt door een handmatige Compose-opdracht.

Een handmatige noodstart kan daarom resources aanmaken onder een ander projectvoorvoegsel. Kies één eigenaar voor de deployment en documenteer de uiteindelijke volumenamen die deze aanmaakt.

Sluit gegevens uit die onder de nieuwe volumekoppeling verborgen zijn geraakt

Stop de container en inspecteer de image of het bind-pad zonder het benoemde volume eraan gekoppeld, in een wegwerptest. Bepaal of het opstartproces gegevens naar de containerlaag heeft geschreven voordat het volume werd gekoppeld.

De Linux-handleiding voor mount legt uit dat een koppeling bestaande mapinhoud verbergt. Daardoor kunnen gegevens ontbreken wanneer een nieuw leeg volume bestanden afdekt die in de image of beschrijfbare laag zijn gemaakt.

Voeg de verborgen laag en het oude persistente volume niet zomaar samen. Bepaal welke status leidend is en gebruik de door de toepassing ondersteunde herstelmethode.

Koppel het oorspronkelijke volume opnieuw met een gecontroleerde test

Stop de stack, maak een back-up van beide kandidaatvolumes, koppel het oorspronkelijke volume aan een wegwerpcontainer of tijdelijk servicepad en controleer de toepassingsbestanden, database-identiteit, eigenaarschap en tijdstempels.

De ZimaSpace-gids over containergegevens verplaatsen zonder koppelingen te verbreken beschrijft de aanverwante werkwijze voor padtoewijzing; dit artikel richt zich op de identiteit van benoemde volumes die aan een project zijn gekoppeld.

Het probleem is opgelost wanneer het bedoelde oude volume is gekoppeld met een stabiele expliciete of externe naam en herhaalde implementaties het opnieuw gebruiken zonder een nieuw leeg alternatief aan te maken.

Veelgestelde vragen

Betekent een leeg benoemd volume dat de oude gegevens zijn verwijderd?

Niet noodzakelijk. Het oude volume kan nog bestaan onder een ander projectvoorvoegsel of een expliciete naam, terwijl de nieuwe container een ander, leeg volume gebruikt.

Kan het wijzigen van de Compose-mapnaam een nieuw volume aanmaken?

Ja. Als er geen projectnaam is vastgelegd, kan Compose deze afleiden van de projectmap en resources met verschillende voorvoegsels aanmaken.

Moeten belangrijke volumes als extern worden gemarkeerd?

Externe volumes kunnen ervoor zorgen dat het verwijderen van een stack hun levenscyclus niet beheert, maar ze vereisen bewuste aanmaak, naamgeving, back-ups en implementatiecontroles.

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.