Immich herstellen na een mislukte containerupdate

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.

Herstel Immich na een mislukte containerupdate door het huidige bewijsmateriaal veilig te stellen, elke Immich-service vast te zetten op de laatst bekende goede versie en gegevens alleen terug te zetten als een gecoördineerde rollback de stack niet kan starten.

Een update kan tegelijk de toepassingscode, de verwachtingen voor het databaseschema, omgevingsvariabelen en versies van bijbehorende services wijzigen. Voortdurend de nieuwste versies ophalen of oude en nieuwe containers combineren maakt het lastiger om de herstelgrens vast te stellen. Sla het Compose-bestand, de omgeving, logboeken, database en uploadpaden op voordat je iets doet. Kies daarna tussen een rollback van de image en een volledig herstel van zowel de database als de bibliotheek.

Bevries de mislukte toestand en bepaal de updategrens

Stop automatische herstarts en noteer de exacte images of digests voor de server-, machinelearning-, database- en cacheservices. Sla de opstartlogboeken en implementatiebestanden op voordat je opnieuw iets ophaalt. De controle is geslaagd als je kunt benoemen wat er is gewijzigd; zo niet, pauzeer dan het herstel totdat de oude versies kunnen worden achterhaald aan de hand van de implementatiegeschiedenis of lokale images.

Controleer of de server stopt voordat hij verbinding maakt met de database, tijdens een migratie of nadat hij klaar is voor gebruik. Een fout bij het verbinden met een afhankelijkheid wijst op een probleem met het netwerk, de inloggegevens of de status; een migratiefout vergroot het risico van alleen de applicatie-image terugzetten, omdat de database mogelijk al is gewijzigd.

Een stapsgewijze uitleg van versiebeheerde Immich-updates laat zien waarom de versiegrens en implementatiebestanden belangrijk zijn. Gebruik deze om de overgang in kaart te brengen en beschouw je eigen logboeken en back-ups als de leidraad voor een rollback.

Probeer eerst een volledige rollback naar de laatst bekende goede image

Zet alle Immich-toepassingsimages vast op de exact eerder werkende versie, in plaats van slechts één service te wijzigen. Maak de getroffen containers opnieuw aan zonder de persistente volumes aan te raken. Als de stack gezond wordt en de logboeken geen incompatibiliteit van het schema tonen, is deze rollback met minimale wijzigingen geslaagd.

Als de oude server het huidige databaseschema weigert, stop dan. Gebruik geen afwisselende versies met dezelfde database en bewerk migratietabellen niet handmatig. Deze fout betekent dat de update een gegevensgrens heeft overschreden; herstel moet plaatsvinden met een databaseback-up waarvan de tijdstempel overeenkomt met de geselecteerde toepassingsversie.

Een melding over Immich v1.135.3 beschrijft een specifieke opstartfout bij databasemigratie na een update. Het voorbeeld van een begrensde migratie is reden om de eerste fatale fout zorgvuldig te lezen; het is geen toestemming om de opdrachten uit dat geval naar een andere versie te kopiëren.

Herstel de database en media alleen als terugdraaien geen herstel biedt

Maak vóór het herstellen een veiligheidskopie of opslagmomentopname van de mislukte status. Maak een schoon hersteldoel, herstel de databaseback-up en koppel vervolgens de bijbehorende uploadbibliotheek en vereiste implementatiebestanden. Overschrijf de enige actuele bibliotheek niet met een oudere kopie alleen om tijdstempels op elkaar af te stemmen.

Databaserecords en assetbestanden moeten naar dezelfde verzameling verwijzen. Als de back-up van vóór recente uploads dateert, bewaar die nieuwere bestanden dan apart voor latere afstemming. Een herstel is geslaagd wanneer migraties zijn voltooid, de verwachte gebruikers en assets verschijnen en steekproefsgewijs gecontroleerde originelen zonder grootschalige fouten over ontbrekende bestanden openen.

De Immich-migratiehandleiding van ZimaSpace biedt een handige inventaris voor het verplaatsen van persistente onderdelen, zonder een containerimage te beschouwen als de fotobibliotheek zelf.

Single board computer zimaboard2

Herstel valideren voordat u de update opnieuw probeert

Test het inloggen, bladeren door de tijdlijn, originele bestanden downloaden, miniaturen genereren, Smart Search, gezichtsverwerking, één nieuwe upload en één databaseback-up. Herstart de containers en de host één keer. Alles is geslaagd als na de herstart dezelfde assets en functies beschikbaar zijn, zonder terugkerende migratie- of rechtenfouten.

Houd de mislukte en herstelde status apart gelabeld totdat de validatie is afgerond. Schakel automatische image-pulls uit en documenteer de vastgepinde versie als herstel afhankelijk is van een oudere versie. Probeer de update pas opnieuw nadat elke tussenliggende release is beoordeeld en een nieuwe gecoördineerde back-up is gemaakt.

Ga terug naar het bewaarde hersteldoel als een nieuwe upload verdwijnt, originelen niet meer openen of taken herhaaldelijk crashen. Escaleer met de bron- en doelversies, image-digests, het eerste fatale logbericht, het tijdstip van de databaseback-up en de opslagmapping; verwijder nooit de laatst bekende werkende kopie zolang de compatibiliteit van de update niet is opgelost.

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.