Zo kun je Immich veilig terugdraaien na een incompatibele release

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.

Zet Immich pas terug nadat je de huidige staat hebt veiliggesteld en hebt vastgesteld of de nieuwere release de database of configuratie zodanig heeft gewijzigd dat de oudere image deze niet kan lezen.

Een container-image kan worden vervangen, maar de persistente gegevens ervan zijn mogelijk al gemigreerd. Als een upgrade misgaat, stop dan automatische updates en nieuwe schrijfbewerkingen, noteer beide versies, bescherm de huidige database en media en kies vervolgens tussen het eenvoudig terugzetten van de image en het herstellen van het herstelpunt van vรณรณr de upgrade.

Bevries de mislukte upgrade voordat deze meer gegevens wijzigt

Schakel automatische image-updates uit en voorkom dat clients nieuwe foto's toevoegen terwijl je bewijsmateriaal verzamelt. Noteer de exacte oude en nieuwe Immich-imageversies of -digests, de PostgreSQL-versie, Compose- en omgevingsbestanden, koppelingspaden en de eerste opstart- of migratiefout.

De ZimaSpace-handleiding over grenzen voor het terugzetten van containers maakt het cruciale onderscheid: persistente volumes blijven behouden wanneer een image wordt vervangen, maar dat is alleen veilig als de oudere applicatie compatibel blijft met de opgeslagen gegevens.

Maak een systeemeigen back-up van de huidige mislukte staat als de database kan worden gelezen, en bewaar de back-up van vรณรณr de upgrade apart. Overschrijf geen van beide met herhaalde experimenten. De huidige kopie kan later nodig zijn om verder te gaan, zelfs als het directe doel is om terug te keren naar de oudere versie.

Bepaal of de release een databasemigratiegrens heeft overschreden

Bekijk de eerste fout na de upgrade en bepaal of die optreedt vรณรณr of tijdens de databasemigratie, na de migratie terwijl de applicatie start, of alleen tijdens een gebruikershandeling. Dit tijdstip verandert het terugzetplan, omdat een oudere image mogelijk geen schema begrijpt dat al door de nieuwere release is gewijzigd.

Een recent Immich-rapport waarin de service na een upgradepad uitviel, laat zien waarom niet-ondersteunde of overgeslagen migratiepaden het simpelweg wisselen van versies onbetrouwbaar kunnen maken. Beschouw de discussie als een casestudy en controleer de exacte migratievolgorde voor jouw versies.

Als de nieuwere applicatie de database niet heeft aangeraakt en het probleem beperkt blijft tot de compatibiliteit van de image of runtime, kan het terugzetten naar een vastgezette image voldoende zijn. Als de migraties zijn voltooid, ga er dan van uit dat de databaseback-up van vรณรณr de upgrade beter past bij de oude image, tenzij je expliciet bewijs hebt van compatibiliteit.

Herstel een overeenkomende database en runtime in plaats van verschillende versies te combineren

Bepaal het terugzetdoel op basis van de laatst bekende goed werkende applicatieversie, de bijbehorende implementatieconfiguratie en het herstelpunt van de database van vรณรณr de incompatibele wijziging. Laat de mediaboom intact, tenzij de release mediabestanden aantoonbaar heeft gewijzigd; kopieer geen terabytes opnieuw alleen omdat de applicatie-image is veranderd.

De bespreking van database-rollback in de planning voor databasecompatibele rollbacks legt het algemene gevaar uit van oudere code implementeren op een schema dat deze niet meer begrijpt. Dat principe is belangrijker dan of de container zelf succesvol start.

Start de rollbackinstantie geรฏsoleerd, zodat mobiele clients en geplande taken niet kunnen schrijven voordat de validatie is afgerond. Als de oude versie meteen schemafouten meldt, stop dan. Voer niet handmatig een downgrade van migraties uit op de enige databasekopie, tenzij je een geteste, versiespecifieke herstelprocedure hebt.

Single board computer zimaboard2

Zet de exacte laatst bekende werkende image vast en reproduceer de configuratie

Gebruik een specifieke versie of een onveranderlijke imageverwijzing in plaats van een meebewegende tag. Herstel de bijbehorende omgeving, serviceafhankelijkheden, apparaattoewijzingen, netwerken, poorten en reverse-proxydoel van de laatst bekende werkende implementatie. Een rollback die ongemerkt meerdere infrastructuurlagen wijzigt, veroorzaakt een tweede incident.

Bewaar de mislukte nieuwere image en configuratie bij de rollbacknotities. Zo blijft gecontroleerd herstel naar een nieuwere versie mogelijk zodra de incompatibiliteit is opgehelderd. Als je alle nieuwe artefacten meteen verwijdert, kan het lastiger worden om de mislukte en werkende status te vergelijken of de upgrade in een testomgeving te reproduceren.

Als de oudere service start met de herstelde status, controleer dan de logboeken voordat je clients inschakelt. Controleer of er geen onverwachte migratiepoging, initialisatie als nieuwe installatie, ontbrekende opslagmount of wijziging van rechten plaatsvindt. Alleen een inlogpagina is geen bewijs dat de rollback de bedoelde gegevens gebruikt.

Valideer de oude versie onder de oorspronkelijke trigger en behoud een pad vooruit

Test representatieve gebruikers, oude en recente bestanden, albums, delen, zoeken, รฉรฉn nieuwe gecontroleerde upload, achtergrondtaken, het maken van een databaseback-up en de route via de reverse proxy. Herstart de stack รฉรฉn keer en bevestig dat dezelfde mounts en database zonder handmatige tussenkomst terugkomen.

Houd nieuwe uploads gepauzeerd totdat deze controles zijn geslaagd. Open daarna de toegang opnieuw en houd de normale werkbelastingperiode in de gaten. Bewaar zowel de back-up van vรณรณr de upgrade als de back-up van de mislukte nieuwere status, zodat je de upgrade later opnieuw kunt proberen in een geรฏsoleerde kopie, nadat de compatibiliteitskwestie is opgehelderd.

Rollback is mislukt als de oudere versie een schemaincompatibiliteit meldt, bekende gegevens ontbreken of schrijfbewerkingen op een onverwacht pad terechtkomen. Stop en herstel het bewaarde herstelpunt opnieuw in plaats van herstelacties op elkaar te stapelen. Escaleer met de exacte versies, migratielogboeken, tijdstempels van databaseback-ups, Compose-verschillen en de eerste verificatiestap die mislukt.

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.