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

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Återställ Immich efter en misslyckad containeruppdatering genom att först säkra det aktuella underlaget, låsa alla Immich-tjänster till den senast kända fungerande versionen och bara återställa data om en samordnad återställning inte kan starta stacken.

En uppdatering kan ändra programkod, förväntningar på databasschemat, miljövariabler och versioner på tillhörande 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 fastställa. Spara Compose-filen, miljövariablerna, loggarna, databasen och uppladdningssökvägarna innan du agerar. Välj sedan mellan att återställa programavbilderna och att återställa hela databasen och biblioteket.

Frys det misslyckade läget och fastställ uppdateringsgränsen

Stoppa automatiska omstarter och anteckna de exakta avbilderna eller sammanfattningarna för servern, maskininlärningen, databasen och cachetjänsterna. Spara startloggarna och driftsättningsfilerna innan du hämtar något igen. Godkänt innebär att du kan ange vad som ändrades. Om det inte går bör återställningen pausas tills de gamla versionerna kan identifieras utifrån driftsättningshistoriken eller lokala avbilder.

Kontrollera om servern avslutas innan den ansluter till databasen, under en migrering eller efter att den blivit redo. Ett fel vid anslutning till en beroendetjänst pekar på nätverks-, autentiserings- eller hälsokontroller som behöver åtgärdas. Ett migreringsfel ökar risken med att bara återställa programavbilden, eftersom databasen redan kan ha ändrats.

En genomgång av versionsstyrda Immich-uppdateringar visar varför versionsgränsen och driftsättningsfilerna spelar roll. Använd den för att kartlägga övergången, men låt dina egna loggar och säkerhetskopior vara vägledande vid återställningen.

Prova först att återställa alla avbilder till den senast kända fungerande versionen

Lås alla Immich-programavbilder till exakt den tidigare fungerande versionen i stället för att bara ändra en tjänst. Återskapa de berörda containrarna utan att röra beständiga volymer. Om stacken blir frisk och loggarna inte visar någon inkompatibilitet i schemat är den här återställningen med få ändringar godkänd.

Om den gamla servern inte godtar det aktuella databasschemat ska du avbryta. Växla inte mellan versioner mot samma databas och redigera inte migrationstabeller manuellt. Det här felet betyder att uppdateringen passerat en datagräns, och återställningen måste göras från en databassäkerhetskopia med en tidsstämpel som matchar den valda programversionen.

En rapport om Immich v1.135.3 dokumenterar ett specifikt startfel vid databasmigrering efter en uppdatering. Dess exempel på avgränsad migrering motiverar att läsa det första fatala felet noggrant; det är inte tillstånd att kopiera kommandona från det fallet till en annan version.

Återställ databas och media endast när återställning inte kan åtgärda problemet

Skapa en säkerhetskopia eller lagringsögonblicksbild av det felaktiga tillståndet innan du återställer. Skapa ett rent återställningsmål, återställ databassäkerhetskopian och gör sedan motsvarande uppladdningsbibliotek och nödvändiga distributionsfiler tillgängliga. Skriv inte över det enda aktuella biblioteket med en äldre kopia enbart för att få tidsstämplarna att stämma.

Databasposter och resursfiler måste beskriva samma samling. Om säkerhetskopian är äldre än de senaste uppladdningarna bevarar du 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 resurser visas och provtagna original öppnas utan omfattande fel om saknade filer.

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

Single board computer zimaboard2

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

Testa inloggning, tidslinjebl äddring, nedladdning av original, generering av miniatyrbilder, Smart Search, ansiktsbehandling, en ny uppladdning och en databassäkerhetskopia. Starta om containrarna och värden en gång. Testet är godkänt om samma resurser och funktioner finns kvar efter omstart utan återkommande migrerings- eller behörighetsfel.

Håll de felaktiga och återställda tillstånden separat märkta tills valideringen är klar. Om återställningen är beroende av en äldre version inaktiverar du automatiska bildhämtningar och dokumenterar versionslåsningen. Försök med uppdateringen igen först efter att ha granskat varje mellanliggande version och gjort en ny samordnad säkerhetskopia.

Återgå till det bevarade återställningsmålet om en ny uppladdning försvinner, original inte går att öppna eller jobb kraschar upprepade gånger. Eskalera med käll- och målversioner, bilddigestar, den första fatala loggen, tidsstämpel för databassäkerhetskopian och lagringsmappning; ta aldrig bort den senast kända fungerande kopian medan uppdateringskompatibiliteten fortfarande är olöst.

Support och tips

Mer att läsa

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.