Så förhindrar du att Immich-konfigurationen går förlorad under uppgraderingar
Förhindra att Immich-konfiguration går förlorad under uppgraderingar genom att behandla Compose-filen, miljövärdena, databasen, uppladdningsbiblioteket och monteringsdefinitionerna för externa bibliotek som separata beständiga tillgångar som måste säkerhetskopieras och återställas tillsammans.
En container kan ersättas; konfigurationen runt den kan det inte. En uppgradering kan verka radera Immich när en relativ bind-montering löses från en annan projektkatalog, en miljöändring aldrig når den återskapade containern eller den nya stacken startar mot en tom databas. Inventera först den aktiva driftsättningen, spara versionshanterade kopior utanför värden och bevisa en kontrollerad återskapning innan produktionsväxlingen.
Dokumentera den aktiva driftsättningen före varje uppgradering
Exportera den effektiva Compose-konfigurationen med hemligheter maskerade, dokumentera bildversioner eller digestvärden och kopiera Compose- och miljöfilerna till versionshanterad lagring. Inspektera de körande monteringarna i stället för att anta att filen i din redigerare startade de aktuella containrarna. Godkänt innebär att varje körväg mappar till en känd plats på värden.
Dokumentera sökvägar till externa bibliotek, inställningar för reverse proxy, URL:en till maskininlärningstjänsten, databasanslutningsvärden, användar- och gruppidentitet, nätverksnamn samt eventuella enheter för hårdvaruacceleration. Ett saknat objekt här blir senare en oförklarad skillnad efter uppgraderingen.
Frågor från communityn om uppgraderingar visar upprepade gånger att operatörer tappar bort vilken Compose-generation eller miljölayout som gäller. Den användbara lärdomen från en diskussion om konfiguration vid uppgradering är att bevara den aktuella fungerande definitionen innan den översätts.
Säkerhetskopiera databas, media och driftsättningsfiler separat
Ta en databasspecifik säkerhetskopia samt en filsystemsbackup eller ögonblicksbild av uppladdningsbiblioteket och driftsättningskatalogen. Dokumentera start- och sluttider, arkivstorlekar och kontrollsummor. En säkerhetskopia som endast innehåller Compose-YAML kan återskapa containrar, men inte återställa konton, metadata, album eller tillgångsposter.
Använd en säkerhetskopia medan tjänsten är stoppad för den enklaste konsistensgränsen, eller samordna en aktiv databasdump med en lagringsögonblicksbild så att deras relation dokumenteras. Behåll externa bibliotek i inventeringen även om Immich inte äger originalfilerna, eftersom sökvägar och åtkomstregler fortfarande påverkar den återställda tjänsten.
En community-underhållen procedur för uppgradering till en större version betonar att databas, media, Compose och miljöindata ska bevaras. Betrakta ordningsföljden som operatörserfarenhet och bekräfta varje steg mot den version du faktiskt driftsätter.
Förbered uppgraderingen med fixerade versioner
Läs versionsinformationen för varje överhoppad version och uppdatera den sparade driftsättningsdefinitionen medvetet. Lås målversionen, hämta den utan att ta bort gamla avbildningar och validera den renderade Compose-konfigurationen. Okända variabler, tomma monteringar eller blandade tjänsteversioner stoppar förberedelsekontrollen.
Där kapaciteten tillåter det kan du återställa säkerhetskopian till en isolerad teststack med andra portar och utan skrivåtkomst till produktionen. Starta den på målversionen och kontrollera migreringar, användare, lagringssökvägar och bakgrundsjobb. Att containern startar utan fel bevisar inte i sig att originalbiblioteket är anslutet.
Den relaterade ZimaSpace-guiden till en säker självhostad NAS hjälper dig att placera driftsättningsfiler och säkerhetskopior utanför den enda värd- och autentiseringsgräns som en uppgradering kan störa.
Bevisa att konfigurationen består efter återskapning
Återskapa testcontainrarna från de sparade filerna före växlingen i stället för att bara starta om dem på plats. Verifiera användare, serverinställningar, lagringsmallar, bibliotek, jobb, proxyåtkomst och effektiva miljövärden. Godkänt innebär att konfigurationen överlever ersättningen eftersom den finns i dokumenterade beständiga komponenter.
Efter växlingen i produktion laddar du upp en testtillgång, kör en sökning, öppnar ett original och skapar en ny databassäkerhetskopia. Starta om stacken och värden och upprepa sedan testerna. Behåll den gamla versionen, säkerhetskopian och driftsättningsdefinitionen tills den normala arbetsbelastningen förblir stabil under observationsperioden.
Om uppgraderingen redan har startat tom stoppar du den innan introduktion eller nya uppladdningar skapar motstridiga data. Anslut endast en verifierad beständig sökväg eller återställ till ett rent mål. Återgå till den tidigare versionen när förväntade användare eller tillgångar saknas; eskalera med sanerad effektiv Compose-konfiguration, monteringar, versioner och tidsstämplar för säkerhetskopior om identiteten fortfarande är oklar.
Rekommenderade produkter
Support och tips
Mer att läsa
Så optimerar du Immich-databasanslutningar för samtidiga containrar
Höj inte max_connections först. Mät Immich-sessionerna, summera alla containers behov, behåll utrymme för administratörsåtkomst och justera bara den flaskhals som har bevisats.
Så förhindrar du duplicerade jobb eller importer i Immich
Separera upprepade jobb från duplicerade resurser. Använd en enda kanonisk inläsningsväg, kontrollera omförsök och sökvägsändringar och testa sedan återinmatning på en liten grupp.
Så reparerar du Immich när dess databasvolym blir full
Ta aldrig bort PostgreSQL-WAL för att frigöra utrymme. Stoppa skrivningar till Immich, bevara databastillståndet, lägg till säker lagringskapacitet, återställ PostgreSQL och förhindra sedan att...
