Immich herstellen na een mislukte containerupdate

Herstel Immich na een mislukte containerupdate door het huidige bewijs veilig te stellen, elke Immich-service vast te pinnen op de laatst bekende werkende release en gegevens alleen te herstellen als een gecoördineerde rollback de stack niet kan starten.

Een update kan applicatiecode, verwachtingen rond het databaseschema, omgevingsvariabelen en versies van ondersteunende services tegelijk wijzigen. Herhaaldelijk de nieuwste versie ophalen of oude en nieuwe containers combineren maakt de herstelgrens moeilijker vast te stellen. Sla het Compose-bestand, de omgeving, logs, database en uploadpaden op voordat je handelt en kies vervolgens tussen een rollback van de image en een volledige restore van database en 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 opstartlogs en deploymentbestanden op voordat je opnieuw iets ophaalt. Geslaagd betekent dat je kunt benoemen wat er is gewijzigd; mislukt betekent dat het herstel moet pauzeren totdat de oude versies aan de hand van de deploymentgeschiedenis of lokale images kunnen worden geïdentificeerd.

Controleer of de server afsluit voordat hij verbinding maakt met de database, tijdens een migratie of nadat hij gereed is gekomen. Een fout bij het verbinden met een afhankelijkheid wijst op herstel van netwerk, referenties of gezondheid; een migratiefout verhoogt het risico van het herstellen van alleen de app-image, omdat de database mogelijk al is gewijzigd.

Een uitleg over versiegebonden Immich-updates laat zien waarom de releasegrens en deploymentbestanden belangrijk zijn. Gebruik deze om de overgang te inventariseren, maar beschouw je eigen logs en back-ups als de autoriteit voor de rollback.

Probeer eerst een volledige rollback naar de laatst bekende werkende images

Pin alle Immich-applicatie-images op exact de eerder werkende release in plaats van slechts één service te wijzigen. Maak de getroffen containers opnieuw aan en laat persistente volumes ongemoeid. Als de stack gezond wordt en de logs geen incompatibiliteit van het schema tonen, is deze rollback met weinig wijzigingen geslaagd.

Als de oude server het huidige databaseschema weigert, stop dan. Wissel niet af tussen versies op dezelfde database en bewerk migratietabellen niet handmatig. Die mislukking betekent dat de update een datagrens heeft overschreden en dat voor het herstel een databaseback-up nodig is waarvan het tijdstip overeenkomt met de geselecteerde applicatierelease.

Een rapport over Immich v1.135.3 documenteert een specifieke opstartfout tijdens de databasemigratie na een update. Het afgebakende migratievoorbeeld onderbouwt waarom je de eerste fatale fout zorgvuldig moet lezen; het is geen toestemming om de opdrachten uit die casus naar een andere versie te kopiëren.

Herstel database en media alleen wanneer een rollback het probleem niet kan oplossen

Maak vóór het herstellen een veiligheidskopie of opslagmomentopname van de mislukte toestand. Bouw een schoon hersteldoel, herstel de databaseback-up en stel daarna de bijbehorende uploadbibliotheek en vereiste deploymentbestanden beschikbaar. Overschrijf de enige huidige bibliotheek niet met een oudere kopie alleen om tijdstempels op elkaar af te stemmen.

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

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

-15% OFF

ZimaBoard 2 - Mini-thuisserver voor jouw grote idee

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Valideer het herstel voordat je de update opnieuw probeert

Test het inloggen, bladeren door de tijdlijn, het downloaden van originelen, het genereren van miniaturen, Smart Search, gezichtsverwerking, één nieuwe upload en één databaseback-up. Herstart de containers en de host eenmaal. Geslaagd betekent dat na de herstart dezelfde assets en functies beschikbaar zijn, zonder terugkerende migratie- of toestemmingsfouten.

Houd de mislukte en herstelde toestanden afzonderlijk gelabeld totdat de validatie is voltooid. Als het herstel afhankelijk is van een oudere versie, schakel dan onbeheerde image-pulls uit en documenteer de pin. Probeer de update pas opnieuw nadat je elke tussenliggende release hebt beoordeeld en een nieuwe gecoördineerde back-up hebt gemaakt.

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