Warum hängt ein Compose-Stack nach der erneuten Bereitstellung ein neues, leeres benanntes Volume ein?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Ein Compose-Stack kann bei einer erneuten Bereitstellung ein neues leeres benanntes Volume einbinden, wenn sich der projektbezogene Volume-Name ändert oder das ursprüngliche Volume nicht gefunden wird.

Die alten Daten können noch in einem anderen Docker-Volume vorhanden sein, während der neu erstellte Service ein neu generiertes Volume am selben Containerpfad einbindet. Häufige Auslöser sind ein geänderter Stack- oder Projektname, ein umbenannter Volume-Schlüssel, das Löschen mit einem Befehl, der Volumes entfernt, eine fehlende Deklaration als externes Volume, die Bereitstellung über einen anderen Manager oder ein expliziter Volume-Name, der nun auf etwas anderes verweist. Erfassen Sie sowohl das eingebundene Volume als auch verwaiste Kandidaten, bevor Sie Daten wiederherstellen oder die App initialisieren.

Genaues Volume ermitteln, das im neuen Container eingebunden ist

Untersuchen Sie die Einbindungen des laufenden Containers und notieren Sie Volume-Name, Treiber, Einhängepunkt, Labels, Erstellungszeitpunkt, Zielpfad im Container und Schreib-Lese-Modus. Vergleichen Sie diese Angaben mit Aufzeichnungen vor der erneuten Bereitstellung.

Der Ubuntu-Befehl docker volume inspect gibt die Volume-Identität preis und ermöglicht so, das neue leere Volume von einem älteren, nicht eingebundenen Volume mit ähnlichem Namen zu unterscheiden.

Kopieren Sie keine Daten in das neue Volume, bevor das Original gefunden wurde. Beim Starten der App kann eine neue Datenbank erstellt werden, sodass das Ziel fälschlicherweise als absichtlich initialisiert erscheint.

Prüfen, ob sich der Compose-Projektname geändert hat

Vergleichen Sie den alten und neuen Projektnamen, Stack-Namen, das Compose-Verzeichnis, die Option -p, COMPOSE_PROJECT_NAME, name: auf oberster Ebene und den Deployment-Manager.

Docker erklärt, dass Compose ein Volume normalerweise mit Projektnamen plus Volume-Schlüssel versieht, sofern kein expliziter Name oder die Suche nach einem externen Volume konfiguriert ist.

Wird dieselbe Compose-Datei in ein anderes Verzeichnis verschoben, kann dadurch ein zweites Projekt und ein zweites Volume entstehen, selbst wenn die Service- und Volume-Schlüssel unverändert sind.

Stabilen Namen und Einstellungen für externe Volumes überprüfen

Vergleichen Sie die Volume-Definition der obersten Ebene vor und nach der erneuten Bereitstellung. Prüfen Sie name:, external:, Treiberoptionen, Interpolationsvariablen und ob das erwartete Volume vorhanden ist.

Im Docker-Compose-Tutorial von Microsoft wird darauf hingewiesen, dass benannte Volumes unabhängig vom Austausch von Containern bestehen bleiben. Ein neuer, leerer Zustand bedeutet daher meist, dass eine andere Volume-Identität eingebunden oder das alte Volume entfernt wurde.

Markieren Sie ein Volume nur dann als extern, wenn sein Lebenszyklus bewusst außerhalb des Stacks verwaltet wird. Compose sollte klar fehlschlagen, wenn ein externes Volume fehlt, statt stillschweigend ein Ersatz-Volume zu erstellen.

Prüfen Sie, ob eine Bereinigung das ursprüngliche Volume entfernt hat

Überprüfen Sie Bereitstellungsprotokolle, Skripte, UI-Aktionen, Bereinigungsaufgaben und Befehle auf das Löschen von Volumes. Vergleichen Sie den Erstellungszeitpunkt des Volumes mit dem Ereignis der erneuten Bereitstellung.

Red Hat dokumentiert, dass von Containern verwaltete benannte Volumes getrennte Speicherorte von beschreibbaren Containerebenen haben. Deshalb sind das Entfernen eines Containers und das Entfernen seines benannten Volumes unterschiedliche Lebenszyklusereignisse.

Falls das ursprüngliche Volume fehlt, stoppen Sie automatische Starts und stellen Sie Daten ausschließlich aus einem verifizierten Backup wieder her. Gehen Sie nicht davon aus, dass ein leeres Ersatz-Volume eine wiederherstellbare gelöschte Ebene enthält.

Vergleichen Sie die Identität des Stack-Managers und die Bereitstellungsmethode

Halten Sie fest, ob der Stack über die CLI, Portainer, einen NAS-App-Store, eine Git-Bereitstellung oder ein anderes Automatisierungstool gestartet wurde. Vergleichen Sie den Stack-Namen und die Umgebungsvariablen, die der jeweilige Manager gespeichert hat.

Portainer erfordert bei der Bereitstellung einen aussagekräftigen Stack-Namen. Diese vom Manager kontrollierte Identität kann sich vom Verzeichnisnamen des Projekts unterscheiden, den ein manueller Compose-Befehl verwendet.

Ein manueller Notstart kann daher Ressourcen unter einem anderen Projektpräfix erstellen. Legen Sie einen einzigen Verantwortlichen für die Bereitstellung fest und dokumentieren Sie die aufgelösten Volume-Namen, die dabei erstellt werden.

Schließe aus, dass Daten unter der neuen Volume-Einbindung verborgen sind

Stoppe den Container und untersuche das Image oder den Bind-Pfad in einem temporären Test, ohne das benannte Volume einzubinden. Ermittle, ob der Start Daten in die Container-Ebene geschrieben hat, bevor das Volume eingebunden wurde.

Das Linux-Handbuch zu mount erklärt, dass eine Einbindung vorhandene Verzeichnisinhalte verdeckt. Dadurch können Daten fehlen, wenn ein neues leeres Volume Dateien überdeckt, die im Image oder in der beschreibbaren Ebene erstellt wurden.

Führe die verborgene Ebene und das alte persistente Volume nicht blind zusammen. Ermittle, welcher Zustand maßgeblich ist, und verwende die von der Anwendung unterstützte Wiederherstellungsmethode.

Das ursprüngliche Volume mit einem kontrollierten Test erneut verbinden

Stoppe den Stack, sichere beide infrage kommenden Volumes, binde das ursprüngliche Volume in einen temporären Container oder Dienstpfad ein und überprüfe Anwendungsdateien, Datenbankidentität, Eigentümerschaft und Zeitstempel.

Die ZimaSpace-Anleitung zum Verschieben von Containerdaten, ohne Einbindungen zu beeinträchtigen beschreibt den verwandten Arbeitsablauf für die Pfadzuordnung. Dieser Artikel konzentriert sich auf die Identität von benannten Volumes, die auf ein Projekt beschränkt sind.

Das Problem ist behoben, wenn das vorgesehene alte Volume unter einem stabilen, expliziten oder externen Namen eingebunden wird und wiederholte erneute Bereitstellungen es wiederverwenden, ohne ein weiteres leeres Volume anzulegen.

Häufig gestellte Fragen

Bedeutet ein leeres benanntes Volume, dass die alten Daten gelöscht wurden?

Nicht unbedingt. Das alte Volume kann weiterhin unter einem anderen Projektpräfix oder expliziten Namen vorhanden sein, während der neue Container ein anderes, leeres Volume verwendet.

Kann eine Änderung des Compose-Ordnernamens ein neues Volume erstellen?

Ja. Wenn kein Projektname festgelegt ist, kann Compose ihn aus dem Projektverzeichnis ableiten und Ressourcen mit unterschiedlichen Präfixen erstellen.

Sollten wichtige Volumes als extern markiert werden?

Externe Volumes können verhindern, dass ein Stack ihren Lebenszyklus verwaltet. Sie müssen jedoch bewusst erstellt und benannt, gesichert und bei der Bereitstellung überprüft werden.

Support und Tipps

Mehr zum Lesen

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.