Gemenskapslösning

Immich fastnar på en gammal version i ZimaOS: säker uppdateringsguide

A ZimaOS 1.7.0 user could not move Immich beyond 2.6.1 by editing only the server image tag; another user showed a working multi-service v3.1.0 setup.

Om Immich på ZimaOS fortfarande har en gammal version efter att du endast har redigerat image-taggen för immich-server ska du sluta ändra en container i taget och först identifiera paketet eller stacken. Immich är en applikation med flera tjänster; server-, maskininlärnings-, databas- och cachekomponenterna måste förbli kompatibla, och vissa ZimaOS-paket underhålls av olika appbutikskällor.

Källtråden visar varför en uppdatering av ett enda fält kan misslyckas: användaren ändrade serverimagen, såg nätverksaktivitet för nedladdning, startade om och Immich visade fortfarande v2.6.1. En annan användare visade en fungerande v3.1.0-installation med matchande tjänsteimages. Den korrekta guiden är därför ”säkerhetskopiera, identifiera stacken, uppdatera samordnat, verifiera”, inte ”skriv in ett högre nummer i ett enda fält”.

ZimaOS Immich-appredigerare som visar att immich-server-imagen har ändrats till v3.1.0
Communityförslaget var att ändra image-taggen för immich-server i appredigeraren. Källa: IceWhale Community Forum.
ZimaOS Immich-tjänstekonfiguration som visar image-fältet för immich-server
Användaren hade redan ändrat serverns image-fält, men den körande applikationen uppdaterades inte. Källa: IceWhale Community Forum.
Immich-webbgränssnitt som visar att servern är online med version 2.6.1 och att uppdatering till 3.1.0 är tillgänglig
Immich-gränssnittet visade fortfarande v2.6.1 efter att ZimaOS-imagen hade redigerats. Källa: IceWhale Community Forum.
Immich-webbgränssnitt som visar att servern är online med version 3.1.0
En jämförelseinstallation visade den förväntade serverversionen v3.1.0. Källa: IceWhale Community Forum.

Steg 1: Identifiera vilket Immich-paket du installerade

ZimaOS kan ha officiella paket och paket från tredjeparts- eller communitybutiker. Öppna appinställningarna och anteckna varje tjänsteimage, inte bara immich-server.

Notera även appbutikskällan, så att du vet vem som hanterar uppdateringsmetadata.

Steg 2: Säkerhetskopiera Immich före alla större uppdateringar

Säkerhetskopiera fotobiblioteket och PostgreSQL-databasen. Den aktuella guiden för säkerhetskopiering och återställning av Immich beskriver ett arbetsflöde för databasdumpar.

Betrakta inte återskapandet av en container som en säkerhetskopia.

Steg 3: Kontrollera alla tjänsteversioner

Källjämförelsen angav:

  • Immich-server;
  • Immich-maskininlärning;
  • Postgres;
  • Valkey/Redis.

Anteckna de fullständiga image-taggarna. Om appbutiken tillhandahåller dem som ett testat paket bör du föredra dess uppdateringsåtgärd framför att manuellt uppdatera en komponent före de andra.

Steg 4: Använd uppdateringen i App Store när den är tillgänglig

Den aktuella ZimaOS-dokumentationen anger att det senaste Immich-paketet kan installeras från App Store. Om det finns en uppdateringsknapp ska du använda den, så att paketunderhållarens Compose-definition uppdateras samtidigt.

Den aktuella ZimaOS-guiden för Immich är den aktuella officiella startpunkten för ZimaOS.

Varför det kan se ut som att redigering av en tagg hämtar en avbild utan att uppdatera

Apphanteraren kan hämta en ny avbild men återskapa tjänsten från butikens metadata, ett annat sparat YAML-värde eller en annan avbildsdefinition. Den körande containern kan därför återgå till den gamla taggen.

Kontrollera den faktiska körande avbilden med:

docker ps --format '{.Names}  {.Image}'

Hoppa inte blint över större Immich-versioner

Immich-versioner kan innehålla ändringar i databasen/schemat och tjänsterna. Läs de uppströms publicerade versions- och uppgraderingsanteckningarna för de versioner du går mellan. Uppdatera stacken som en enhet i stället för att gissa vilka kombinationer som är kompatibla.

Om du använder ett BigBear-paket eller ett annat tredjepartspaket

En separat ZimaSpace-communityguide dokumenterar att ändring av avbildstaggar fungerade för vissa BigBear-paket, medan senare användare upptäckte att samma knep inte var universellt för alla paket. Identifiera paketeringskällan innan du använder den lösningen.

Immichs uppdateringsguide förklarar den paketspecifika gränsen.

Verifiera uppdateringen efter att du har återskapat stacken

Kontrollera tre ställen:

  • de körande Docker-avbildstaggarna;
  • Immichs egen visning av serverversionen;
  • containerloggar för migreringar eller kompatibilitetsfel.

Ta inte bort databasen eller uppladdningsmappen för att tvinga fram en uppdatering

Att ta bort volymer är en destruktiv återställning, inte en uppdateringsmetod. Bevara databasen och fotobiblioteket om du inte har en testad säkerhetskopia och avsiktligen vill ha en nyinstallation.

Vanliga frågor

Varför visar Immich fortfarande 2.6.1 efter att jag ändrat servertaggen?

Appen kan hålla på att återskapa den gamla tjänstedefinitionen, eller så har stacken kanske inte uppdaterats konsekvent. Kontrollera den faktiska körande avbilden och paketskällan.

Måste machine learning ha exakt samma version som servern?

Följ de testade versionerna i den Immich-release-/Compose-definition som du distribuerar. Hitta inte på oberoende taggar för varje tjänst.

Kan jag bara uppdatera immich-server?

Undvik det som standard. Immich är en stack med flera tjänster, och uppgraderingar kan kräva samordnade ändringar.

Vad bör jag säkerhetskopiera först?

PostgreSQL-databasen och din lagring för medier/uppladdningar. Verifiera säkerhetskopian innan större versionsändringar.