Se o Immich no ZimaOS continuar numa versão antiga depois de editar apenas a etiqueta da imagem immich-server, pare de alterar um contentor de cada vez e identifique primeiro o pacote/stack. O Immich é uma aplicação composta por vários serviços; o servidor, a aprendizagem automática, a base de dados e os componentes de cache têm de permanecer compatíveis, e alguns pacotes do ZimaOS são mantidos por diferentes origens da loja de aplicações.
O tópico de origem mostra por que motivo uma atualização de um único campo pode falhar: o utilizador alterou a imagem do servidor, viu atividade de transferência na rede, reiniciou e o Immich continuou a indicar a versão v2.6.1. Outro utilizador mostrou uma configuração v3.1.0 funcional, com imagens de serviço correspondentes. Por conseguinte, o guia correto é «fazer uma cópia de segurança, identificar a stack, atualizá-la de forma coerente e verificar», e não «introduzir um número mais recente num único campo».
Passo 1: Identifique qual o pacote Immich que instalou
O ZimaOS pode ter pacotes de lojas oficiais e de terceiros/comunitários. Abra as definições da aplicação e registe todas as imagens dos serviços, não apenas immich-server.
Tenha também em atenção a origem da loja de aplicações, para saber quem controla os metadados de atualização.
Passo 2: Faça uma cópia de segurança do Immich antes de qualquer atualização importante
Faça uma cópia de segurança da biblioteca de fotografias e da base de dados PostgreSQL. O atual guia de cópia de segurança e restauro do Immich documenta um procedimento de exportação da base de dados.
Não considere a recriação de um contentor como uma cópia de segurança.
Passo 3: Verifique as versões de todos os serviços
A comparação da fonte indicava:
- Servidor Immich;
- Aprendizagem automática do Immich;
- Postgres;
- Valkey/Redis.
Registe as etiquetas completas das imagens. Se a loja de aplicações as mantiver como um pacote testado, prefira a ação Atualizar em vez de avançar manualmente um componente em relação aos restantes.
Passo 4: Utilize a atualização da Loja de aplicações quando disponível
A documentação atual do ZimaOS indica que o pacote Immich mais recente pode ser instalado a partir da Loja de aplicações. Se estiver disponível um botão de atualização, utilize-o para que a definição Compose do responsável pela manutenção do pacote seja também atualizada.
O guia do Immich para ZimaOS atual é o ponto de partida oficial atual do ZimaOS.
Porque é que editar uma única etiqueta pode parecer que transfere a imagem, mas não atualiza
O gestor de aplicações pode obter uma imagem nova, mas recriar o serviço a partir de metadados da loja, de outro valor YAML guardado ou de uma definição de imagem diferente. Por isso, o contentor em execução pode voltar à etiqueta antiga.
Verifique a imagem efetivamente em execução com:
docker ps --format '{.Names} {.Image}'Não salte cegamente entre versões principais do Immich
Os lançamentos do Immich podem incluir alterações à base de dados/esquema e aos serviços. Leia as notas de lançamento/atualização oficiais para as versões que está a atravessar. Atualize a pilha como uma unidade, em vez de adivinhar combinações compatíveis.
Se utilizar um pacote BigBear ou outro pacote de terceiros
Um guia separado da comunidade ZimaSpace documenta que a alteração das etiquetas das imagens funcionou para alguns pacotes BigBear, enquanto utilizadores posteriores descobriram que o mesmo truque não era universal entre os pacotes. Identifique a origem do pacote antes de aplicar essa solução alternativa.
O guia de atualização do Immich explica esse limite específico do pacote.
Verifique a atualização depois de recriar a pilha
Verifique três locais:
- as etiquetas das imagens Docker em execução;
- a indicação da própria versão do servidor do Immich;
- os registos do contentor relativos a migrações ou erros de compatibilidade.
Não elimine a base de dados nem a pasta de carregamentos para forçar uma atualização
A remoção de volumes é uma reposição destrutiva, não um método de atualização. Preserve a base de dados e a biblioteca de fotografias, a menos que tenha uma cópia de segurança testada e pretenda deliberadamente uma instalação nova.
Perguntas frequentes
Porque é que o Immich continua a mostrar 2.6.1 depois de alterar a etiqueta do servidor?
A aplicação pode estar a recriar a definição de serviço antiga ou a pilha pode não ter sido atualizada de forma coerente. Verifique a imagem e a origem do pacote que estão efetivamente em execução.
A aprendizagem automática deve corresponder exatamente à versão do servidor?
Siga as versões testadas na definição de lançamento/Compose do Immich que está a implementar. Não invente etiquetas independentes para cada serviço.
Posso atualizar apenas o immich-server?
Evite isso como opção predefinida. O Immich é uma pilha de vários serviços e as atualizações podem exigir alterações coordenadas.
O que devo salvaguardar primeiro?
A base de dados PostgreSQL e o armazenamento de multimédia/carregamentos. Verifique a cópia de segurança antes de alterações importantes de versão.
