Så återställer du Immich efter en misslyckad containeruppdatering

Eva Wong

IceWhale author

Eva Wong är Teknisk skribent och den boende fixaren på ZimaSpace. En livslång nörd med en passion för hemma-labb och öppen källkod, hon specialiserar sig på att översätta komplexa tekniska koncept till tillgängliga, praktiska guider. Eva tror att självhosting ska vara roligt, inte skrämmande. Genom sina handledningar ger hon gemenskapen verktyg att avmystifiera hårdvaruinstallationer, från att bygga sin första NAS till att bemästra Docker-containrar.

How to Restore Immich After a Failed Container Update - Zima Store Online

Återställ Immich efter en misslyckad containeruppdatering genom att frysa den aktuella bevisningen, låsa varje Immich-tjänst till den senast kända fungerande versionen och återställa data endast om en samordnad återställning inte kan starta stacken.

En uppdatering kan ändra programkod, förväntningar på databasschemat, miljövariabler och versioner av kompletterande tjänster samtidigt. Om du upprepade gånger hämtar senaste versionen eller blandar gamla och nya containrar blir återställningsgränsen svårare att se. Spara Compose-filen, miljön, loggarna, databasen och uppladdningssökvägarna innan du agerar, och välj sedan mellan en återställning av avbildningar och en fullständig återställning av databas och bibliotek.

Frys det misslyckade tillståndet och identifiera uppdateringsgränsen

Stoppa automatiska omstarter och dokumentera de exakta avbildningarna eller digest-värdena för server-, maskininlärnings-, databas- och cachetjänsterna. Spara startloggarna och distributionsfilerna innan du hämtar något på nytt. Godkänt innebär att du kan ange vad som ändrades; underkänt innebär att återställningen bör pausas tills de gamla versionerna kan identifieras från distributionshistoriken eller lokala avbildningar.

Kontrollera om servern avslutas innan den ansluter till databasen, under en migrering eller efter att den blivit redo. Ett fel vid anslutning till ett beroende pekar på nätverks-, autentiserings- eller hälsokontrollsreparation; ett migreringsfel ökar risken med att endast återställa appavbildningen, eftersom databasen redan kan ha ändrats.

En genomgång av versionshanterade Immich-uppdateringar visar varför versionsgränsen och distributionsfilerna är viktiga. Använd den för att kartlägga övergången, men låt dina egna loggar och säkerhetskopior vara auktoriteten vid återställningen.

Prova först en fullständig återställning av den senast kända fungerande avbildningen

Lås alla Immich-programavbildningar till exakt den tidigare fungerande versionen i stället för att ändra endast en tjänst. Skapa om de berörda containrarna och låt beständiga volymer vara orörda. Om stacken blir frisk och loggarna inte visar någon inkompatibilitet i schemat är denna återställning med små förändringar godkänd.

Om den gamla servern vägrar använda det aktuella databasschemat ska du stoppa. Växla inte mellan versioner mot samma databas och redigera inte migreringstabeller manuellt. Det felet innebär att uppdateringen passerade en datagräns, och återställningen måste använda en säkerhetskopia av databasen vars tidsstämpel matchar den valda programversionen.

En rapport om Immich v1.135.3 dokumenterar ett specifikt startfel vid databasmigrering efter en uppdatering. Dess avgränsade migreringsexempel motiverar att du läser det första allvarliga felet noggrant; det är inte ett tillstånd att kopiera kommandona från det fallet till en annan version.

Återställ databas och medier endast när återställning inte kan reparera systemet

Skapa en säkerhetskopia eller lagringssnapshot av det misslyckade tillståndet innan du återställer. Bygg ett rent återställningsmål, återställ databassäkerhetskopian och exponera sedan motsvarande uppladdningsbibliotek och nödvändiga distributionsfiler. Skriv inte över det enda aktuella biblioteket med en äldre kopia enbart för att anpassa tidsstämplarna.

Databasposter och tillgångsfiler måste beskriva samma samling. Om säkerhetskopian är äldre än de senaste uppladdningarna ska du bevara de nyare filerna separat för senare avstämning. En återställning är godkänd när migreringarna slutförs, förväntade användare och tillgångar visas och stickprov av originalfiler öppnas utan omfattande fel om saknade filer.

ZimaSpaces Immich-migreringsguide innehåller en användbar inventering för att flytta beständiga komponenter utan att behandla en containeravbildning som själva fotobiblioteket.

-15% OFF

ZimaBoard 2 - Minihemmserver för din stora idé

Single board computer zimaboard2

Validera återställningen innan du försöker uppdatera igen

Testa inloggning, bläddring i tidslinjen, nedladdning av original, generering av miniatyrbilder, Smart Search, ansiktsbehandling, en ny uppladdning och en säkerhetskopia av databasen. Starta om containrarna och värden en gång. Godkänt kräver att samma tillgångar och funktioner fungerar efter omstart utan återkommande migrerings- eller behörighetsfel.

Håll de misslyckade och återställda tillstånden separat märkta tills valideringen är klar. Om återställningen kräver en äldre version ska du inaktivera obevakade hämtningar av avbildningar och dokumentera låsningen. Försök uppdatera igen först efter att ha granskat varje mellanliggande version och tagit en ny samordnad säkerhetskopia.

Återgå till det bevarade återställningsmålet om en ny uppladdning försvinner, original inte kan öppnas eller jobb kraschar upprepade gånger. Eskalera med käll- och målversioner, avbildningarnas digest-värden, den första allvarliga loggraden, tidsstämpeln för databassäkerhetskopian och lagringsmappningen; avveckla aldrig den senast kända fungerande kopian medan kompatibiliteten för uppdateringen fortfarande är olöst.