Como reverter o Immich em segurança após uma versão incompatível

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Reverta o Immich apenas depois de preservar o estado atual e determinar se a versão mais recente alterou a base de dados ou a configuração de uma forma que a imagem antiga não consegue ler.

Uma imagem de contentor pode ser substituída, mas o respetivo estado persistente poderá já ter sido migrado. Se uma atualização começar mal, pare as atualizações automáticas e as novas gravações, registe ambas as versões, proteja a base de dados e os ficheiros multimédia atuais e, em seguida, escolha entre uma simples reversão da imagem e o restauro do ponto de recuperação anterior à atualização.

Imobilize a atualização com falha antes que altere mais dados

Desative as atualizações automáticas e impeça os clientes de adicionar novas fotografias enquanto recolhe provas. Registe as versões ou os resumos exatos das imagens antigas e novas do Immich, a versão do PostgreSQL, os ficheiros Compose e de ambiente, os caminhos de montagem e o primeiro erro de arranque ou migração.

O guia da ZimaSpace sobre limites de reversão de contentores estabelece a distinção fundamental: os volumes persistentes sobrevivem à substituição da imagem, mas isso só é seguro se a aplicação mais antiga continuar a ser compatível com o estado que contêm.

Faça uma cópia de segurança nativa da base de dados do estado atual com falha, se for possível ler a base de dados, e guarde separadamente a cópia de segurança anterior à atualização. Não substitua nenhuma delas com experiências repetidas. A cópia atual poderá ser necessária para avançar mais tarde, mesmo que o objetivo imediato seja voltar à versão anterior.

Determine se a versão ultrapassou um ponto de migração da base de dados

Analise a primeira falha após a atualização e determine se ocorre antes ou durante a migração da base de dados, após a migração, durante o arranque da aplicação, ou apenas num fluxo de trabalho do utilizador. Este momento altera o plano de reversão, porque uma imagem mais antiga poderá não reconhecer um esquema já alterado pela versão mais recente.

Um relato recente sobre o Immich, em que o serviço falhou após uma sequência de atualização, ilustra por que motivo sequências de migração não suportadas ou ignoradas podem tornar pouco fiável uma simples troca de versões. Considere a discussão um estudo de caso e confirme a sequência exata de migração das suas versões.

Se a aplicação mais recente nunca tiver acedido à base de dados e a falha se limitar à compatibilidade da imagem ou do ambiente de execução, poderá bastar reverter para uma imagem fixa. Se as migrações tiverem sido concluídas, considere que a cópia de segurança da base de dados anterior à atualização é a opção mais segura para a imagem antiga, a menos que tenha provas explícitas de compatibilidade.

Restaure uma base de dados e um ambiente de execução correspondentes, em vez de misturar versões

Crie o alvo de reversão com a última versão da aplicação que se sabe estar funcional, a respetiva configuração de implementação compatível e o ponto de recuperação da base de dados anterior à alteração incompatível. Mantenha intacta a árvore de ficheiros multimédia, salvo se a versão tiver alterado ficheiros multimédia de uma forma documentada; não volte a copiar terabytes apenas porque a imagem da aplicação mudou.

A discussão sobre o rollback da base de dados no planeamento de rollbacks compatíveis com a base de dados explica o perigo geral de implementar código mais antigo num esquema que já não compreende. Este princípio é mais importante do que saber se o próprio contentor arranca com sucesso.

Inicie a instância de rollback de forma isolada, para que os clientes móveis e as tarefas agendadas não possam escrever até a validação estar concluída. Se a versão anterior apresentar imediatamente erros de esquema, pare. Não force manualmente migrações para trás na única cópia da base de dados, a menos que disponha de um procedimento de recuperação específico para essa versão e devidamente testado.

Fixe a imagem exata comprovadamente funcional e reproduza a respetiva configuração

Use uma versão específica ou uma referência imutável à imagem, em vez de uma etiqueta que muda. Restaure o ambiente correspondente, as dependências do serviço, os mapeamentos de dispositivos, as redes, as portas e o destino do proxy inverso da última implementação comprovadamente funcional. Um rollback que altera silenciosamente várias camadas da infraestrutura cria um segundo incidente.

Preserve a imagem mais recente que falhou e a respetiva configuração, juntamente com as notas do rollback. Assim, será possível fazer uma recuperação controlada para uma versão mais recente depois de compreender a incompatibilidade. Remover imediatamente todos os novos artefactos pode dificultar a comparação entre os estados que falhou e que funciona, ou a reprodução da atualização num ambiente de teste.

Se o serviço anterior arrancar com o estado restaurado, inspecione os registos antes de ativar os clientes. Confirme que não há tentativas inesperadas de migração, inicialização de uma nova instalação, pontos de montagem de armazenamento em falta ou alterações às permissões. Uma página de início de sessão, por si só, não prova que o rollback está a usar os dados pretendidos.

Valide a versão anterior com o acionador original e mantenha uma via de atualização

Teste utilizadores representativos, ficheiros antigos e recentes, álbuns, partilha, pesquisa, uma nova transferência controlada, tarefas em segundo plano, a criação de uma cópia de segurança da base de dados e a rota do proxy inverso. Reinicie a pilha uma vez e confirme que os mesmos pontos de montagem e a mesma base de dados são recuperados sem intervenção manual.

Mantenha as novas transferências em pausa até essas verificações serem concluídas com sucesso. Depois, reabra o acesso e acompanhe o período de carga normal. Preserve tanto a cópia de segurança anterior à atualização como a cópia de segurança do estado mais recente que falhou, para poder repetir a atualização mais tarde numa cópia isolada, depois de compreender o problema de compatibilidade.

O rollback falhou se a versão anterior indicar incompatibilidade do esquema, faltarem dados conhecidos ou as gravações forem feitas num caminho inesperado. Pare e restaure novamente o ponto de recuperação preservado, em vez de acumular reparações. Peça ajuda, indicando as versões exatas, os registos de migração, as datas e horas das cópias de segurança da base de dados, a diferença de configuração do Compose e a primeira etapa de verificação que falhou.

Assistência e dicas

Mais para ler

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.