So setzen Sie Immich nach einer inkompatiblen Veröffentlichung sicher auf eine frühere Version zurück

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.

Führen Sie für Immich erst dann ein Rollback durch, wenn Sie den aktuellen Zustand gesichert und festgestellt haben, ob das neuere Release die Datenbank oder Konfiguration so geändert hat, dass das ältere Image sie nicht lesen kann.

Ein Container-Image lässt sich ersetzen, sein persistenter Zustand ist jedoch möglicherweise bereits migriert. Wenn ein Upgrade fehlschlägt, stoppen Sie automatische Updates und neue Schreibvorgänge, notieren Sie beide Versionen, schützen Sie die aktuelle Datenbank und die Medien und entscheiden Sie dann zwischen einem einfachen Image-Rollback und der Wiederherstellung des Wiederherstellungspunkts von vor dem Upgrade.

Stoppen Sie das fehlgeschlagene Upgrade, bevor es weitere Zustände verändert

Deaktivieren Sie automatische Image-Updates und verhindern Sie, dass Clients neue Fotos hinzufügen, während Sie Belege sammeln. Notieren Sie die genauen alten und neuen Immich-Image-Versionen oder Digests, die PostgreSQL-Version, Compose- und Umgebungsdateien, Mount-Pfade sowie den ersten Start- oder Migrationsfehler.

Der ZimaSpace-Leitfaden zu Grenzen beim Container-Rollback macht den entscheidenden Unterschied deutlich: Persistente Volumes überstehen den Austausch eines Images, aber das ist nur sicher, wenn die ältere Anwendung weiterhin mit dem darin enthaltenen Zustand kompatibel ist.

Erstellen Sie ein datenbanknatives Backup des aktuellen fehlerhaften Zustands, sofern die Datenbank lesbar ist, und bewahren Sie das Backup von vor dem Upgrade separat auf. Überschreiben Sie keines der beiden Backups mit wiederholten Experimenten. Die aktuelle Kopie kann später nötig sein, um weiterzukommen, selbst wenn das unmittelbare Ziel die Rückkehr zur älteren Version ist.

Stellen Sie fest, ob das Release eine Datenbankmigrationsgrenze überschritten hat

Untersuchen Sie den ersten Fehler nach dem Upgrade und ermitteln Sie, ob er vor oder während der Datenbankmigration, nach der Migration beim Start der Anwendung oder nur bei einem Benutzer-Workflow auftritt. Dieser Zeitpunkt verändert den Rollback-Plan, da ein älteres Image ein Schema möglicherweise nicht versteht, das die neuere Version bereits geändert hat.

Ein aktueller Immich-Bericht, in dem der Dienst nach einem Upgrade-Pfad ausfiel, veranschaulicht, warum nicht unterstützte oder übersprungene Migrationspfade einen einfachen Versionswechsel unzuverlässig machen können. Betrachten Sie den Thread als Fallstudie und überprüfen Sie die genaue Migrationsabfolge für Ihre Versionen.

Wenn die neuere Anwendung die Datenbank nie berührt hat und der Fehler auf die Kompatibilität von Image oder Laufzeitumgebung beschränkt ist, reicht möglicherweise ein Rollback auf ein festgelegtes Image. Wurden Migrationen abgeschlossen, gehen Sie davon aus, dass das Datenbank-Backup von vor dem Upgrade besser zum älteren Image passt, sofern Sie keine eindeutigen Kompatibilitätsnachweise haben.

Eine passende Datenbank und Laufzeitumgebung wiederherstellen, statt Versionen zu mischen

Erstellen Sie das Rollback-Ziel aus der zuletzt nachweislich funktionierenden Anwendungsversion, der dazu kompatiblen Deployment-Konfiguration und dem Datenbank-Wiederherstellungspunkt von vor der inkompatiblen Änderung. Lassen Sie den Medienbaum intakt, sofern beim Release keine Mediendateien auf dokumentierte Weise geändert wurden; kopieren Sie nicht Terabytes erneut, nur weil sich das Anwendungs-Image geändert hat.

Die Diskussion zum Datenbank-Rollback in der Planung datenbankkompatibler Rollbacks erläutert die allgemeine Gefahr, ältere Software mit einem Schema bereitzustellen, das sie nicht mehr versteht. Dieses Prinzip ist wichtiger als die Frage, ob der Container selbst erfolgreich startet.

Starten Sie die Rollback-Instanz isoliert, damit mobile Clients und geplante Jobs erst schreiben können, wenn die Validierung abgeschlossen ist. Meldet die ältere Version sofort Schemafehler, stoppen Sie. Erzwingen Sie keine Migrationen rückwärts auf der einzigen Datenbankkopie, es sei denn, Sie verfügen über ein getestetes, versionsspezifisches Wiederherstellungsverfahren.

Single board computer zimaboard2

Das exakte, bekanntermaßen funktionierende Image festlegen und seine Konfiguration reproduzieren

Verwenden Sie eine bestimmte Version oder eine unveränderliche Image-Referenz statt eines veränderlichen Tags. Stellen Sie die passende Umgebung, Dienstabhängigkeiten, Gerätezuordnungen, Netzwerke, Ports und das Reverse-Proxy-Ziel aus der letzten bekannten funktionierenden Bereitstellung wieder her. Ein Rollback, der unbemerkt mehrere Infrastrukturebenen ändert, verursacht einen zweiten Vorfall.

Bewahren Sie das fehlgeschlagene neuere Image und die Konfiguration zusammen mit den Rollback-Notizen auf. So wird eine kontrollierte Wiederherstellung auf eine neuere Version möglich, sobald die Inkompatibilität geklärt ist. Werden alle neuen Artefakte sofort entfernt, kann es schwieriger sein, den fehlgeschlagenen mit dem funktionierenden Zustand zu vergleichen oder das Upgrade in einer Testumgebung zu reproduzieren.

Wenn der ältere Dienst mit dem wiederhergestellten Zustand startet, prüfen Sie die Protokolle, bevor Sie Clients aktivieren. Bestätigen Sie, dass kein unerwarteter Migrationsversuch, keine Initialisierung einer Neuinstallation, kein fehlender Speichermount und keine Änderung der Berechtigungen vorliegt. Eine Anmeldeseite allein beweist nicht, dass der Rollback die vorgesehenen Daten verwendet.

Die ältere Version unter denselben Bedingungen validieren und einen Weg nach vorn offenhalten

Testen Sie repräsentative Benutzer, alte und aktuelle Dateien, Alben, Freigaben, die Suche, einen einzelnen kontrollierten neuen Upload, Hintergrundjobs, die Erstellung einer Datenbanksicherung und die Route des Reverse-Proxys. Starten Sie den Stack einmal neu und bestätigen Sie, dass dieselben Mounts und dieselbe Datenbank ohne manuelles Eingreifen wieder verfügbar sind.

Lassen Sie neue Uploads pausiert, bis diese Prüfungen bestanden sind. Geben Sie danach den Zugriff wieder frei und beobachten Sie den normalen Betriebszeitraum. Bewahren Sie sowohl die Sicherung vor dem Upgrade als auch die Sicherung des fehlgeschlagenen neueren Zustands auf, damit Sie das Upgrade später in einer isolierten Kopie erneut versuchen können, sobald die Kompatibilitätsprobleme geklärt sind.

Ein Rollback ist fehlgeschlagen, wenn die ältere Version eine Inkompatibilität des Schemas meldet, bekannte Daten fehlen oder Schreibvorgänge auf einem unerwarteten Pfad landen. Stoppen Sie und stellen Sie den gesicherten Wiederherstellungspunkt erneut wieder her, anstatt weitere Reparaturen darauf aufzubauen. Eskalieren Sie den Vorfall mit den exakten Versionen, Migrationsprotokollen, Zeitstempeln der Datenbanksicherungen, dem Compose-Diff und dem ersten fehlgeschlagenen Verifizierungsschritt.

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.