Kann man ein Container-Image zurücksetzen, ohne App-Daten zu verlieren?

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.

Ja, Sie können ein Container-Image zurücksetzen, ohne Anwendungsdaten zu verlieren, wenn der persistente Zustand außerhalb des Containers gespeichert ist und mit der älteren Version kompatibel bleibt.

Auf einem Heim-NAS wird beim Austausch des Images normalerweise nur die Laufzeitumgebung der Anwendung neu erstellt, während benannte Volumes oder Bind-Mounts Datenbanken, Einstellungen und Benutzerdateien beibehalten. Kritisch sind Schemaänderungen: Ein neueres Image kann die Datenbank migrieren oder die Konfiguration so ändern, dass das ältere Image sie nicht lesen kann. Erfassen Sie vor dem Rollback die aktuellen Mounts, die Image-Identität, die Konfiguration, Secrets und eine konsistente Datensicherung.

Sichern Sie den aktuellen Zustand, bevor Sie das Image ändern

Stoppen Sie automatische Image-Updates und notieren Sie das aktuelle Image-Tag, den unveränderlichen Digest, die Container-Konfiguration, Umgebungsvariablen, Netzwerke, Ports, Mounts, die Neustartrichtlinie und den Healthcheck. Speichern Sie die Compose-Datei oder exportierte Konfiguration getrennt vom Container.

Ein NAS-Container-Rollback-Workflow empfiehlt, ein bekanntermaßen funktionierendes früheres Image bereitzuhalten, statt sich auf ein veränderliches latest-Tag zu verlassen. Der nutzbare Wiederherstellungspunkt besteht aus der konkreten vorherigen Image-Version und der dazugehörigen Konfiguration.

Erstellen Sie vor dem Stoppen der neueren Version ein konsistentes Datenbank-Backup oder einen Snapshot. Gehen Sie nicht davon aus, dass das vorhandene Volume eine Rollback-Kopie ist, denn es enthält möglicherweise bereits Schema- oder Datenänderungen des Updates.

Bestätigen Sie, dass die Anwendungsdaten außerhalb der beschreibbaren Ebene liegen

Erfassen Sie alle benannten Volumes und Bind-Mounts und ermitteln Sie dann, ob Datenbanken, Uploads, Plugins, Zertifikate, Cache oder Konfiguration noch ausschließlich in der beschreibbaren Ebene des Containers gespeichert sind.

Persistenter Speicher bleibt nach dem Austausch eines Containers nur erhalten, wenn der neue Container wieder mit demselben externen Speicherort verbunden wird. SynoForums Workflow zum Ändern der Image-Version prüft ausdrücklich, ob Volume-Daten auf dem NAS-Speicher bleiben, bevor ein Container mit einem anderen Image neu erstellt wird.

Wenn wichtige Daten nur in der beschreibbaren Ebene vorhanden sind, kopieren oder exportieren Sie sie, bevor Sie den aktuellen Container entfernen. Betrachten Sie diese Extraktion als Wiederherstellungsschritt und nicht als Grund, einen Container ohne festgelegte Version unbegrenzt beizubehalten.

Das genaue ältere Image festlegen, statt „latest“ wiederzuverwenden

Rufen Sie das letzte bekanntermaßen funktionierende Tag oder den Digest ab oder ermitteln Sie ihn, und aktualisieren Sie nur den Image-Verweis. Prüfen Sie Architektur, Anwendungsversion und erforderliche Umgebungsvariablen, bevor Sie den Dienst neu erstellen.

Nutzer, die von Compose verwaltete Dienste zurücksetzen, wechseln üblicherweise zu einer zuvor festgelegten Image-Version, statt Docker aufzufordern, einen laufenden Container direkt zurückzusetzen. Bei einem praktischen Rollback geht es darum, das festgelegte Compose-Image-Tag zu ändern und den Dienst neu zu erstellen.

Verwenden Sie kein altes zwischengespeichertes Image, dessen Identität unbekannt ist. Notieren Sie den Digest nach dem Herunterladen, damit ein weiterer Neuaufbau nicht unbemerkt eine andere Binärdatei unter demselben veränderlichen Tag auswählt.

Single board computer zimaboard2

Prüfen, ob die neuere Version die Datenbank geändert hat

Lesen Sie die Versionshinweise und Migrationsprotokolle der Anwendung für alle Versionen zwischen der Rollback-Zielversion und dem aktuellen Image. Achten Sie auf irreversible Schemaänderungen, umgeschriebene Konfigurationen, Änderungen an Verschlüsselungsschlüsseln oder Plugin-Upgrades.

Ein Datenbank-Rollback ist schwieriger als ein Image-Rollback, weil Anwendungscode und Schema kompatibel bleiben müssen. Octopus bezeichnet abwärtskompatible Migrationen als Voraussetzung, wenn alte und neue Anwendungsversionen parallel bestehen oder zurückgesetzt werden können. Damit wird die Schema-Kompatibilität über mehrere Versionen hinweg zur entscheidenden Grenze für den Rollback.

Wenn das ältere Image die migrierte Datenbank nicht lesen kann, stellen Sie stattdessen die Datenbanksicherung von vor dem Upgrade wieder her, anstatt alten Code auf den neuen Datenstand anzusetzen. Sichern Sie die aktuelle Datenbank separat, falls der Rollback selbst rückgängig gemacht werden muss.

Dienst mit denselben persistenten Pfaden neu erstellen

Stoppen Sie den Anwendungscontainer und erstellen Sie ihn mit dem älteren Image neu. Verwenden Sie dabei dieselben verifizierten benannten Volumes oder Bind-Mounts. Verwenden Sie keine Befehle oder UI-Optionen, die Volumes entfernen.

Behalten Sie Netzwerknamen, Dienst-Aliase, veröffentlichte Ports, UID/GID-Zuordnungen, Secrets und Reverse-Proxy-Ziele bei, sofern die ältere Version keine dokumentierte Abweichung erfordert. Ein Container, der erfolgreich startet, aber falsch eingebundene Volumes verwendet, kann eine neue, leere App erstellen und wie ein Datenverlust wirken.

Prüfen Sie die Mount-Liste und die Anwendungsprotokolle, bevor Sie sich anmelden oder Hintergrundjobs ausführen lassen. Wenn die App eine neue Datenbank initialisiert, stoppen Sie sofort und korrigieren Sie den Datenpfad, anstatt Daten am falschen Speicherort zu importieren.

Rollback validieren und einen Wiederherstellungspfad nach vorn offenhalten

Testen Sie die Anmeldung, Datenbank-Lese- und Schreibvorgänge, Uploads, geplante Jobs, Integrationen und einen kontrollierten Neustart. Vergleichen Sie eine Stichprobe von Datensätzen und Dateien mit dem Inventar vor dem Rollback.

Der ZimaSpace-Workflow für Snapshots der App-Daten vor einem Update bietet eine sicherere Vorbereitung auf zukünftige Upgrades.

Der Rollback ist erst abgeschlossen, wenn das alte Image die vorgesehenen persistenten Daten verwendet, das Schema kompatibel oder wiederhergestellt ist und der Dienst auch nach einer erneuten Neuerstellung funktioniert. Bewahren Sie das neuere Image, dessen Datensicherung und die Rollback-Notizen auf, bis die alte Version während des üblichen Workload-Zeitraums stabil gelaufen ist.

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.