Como restaurar o Immich após uma atualização do contentor falhada

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.

Restaure o Immich após uma falha na atualização de um contentor, congelando as provas existentes, fixando todos os serviços Immich na última versão comprovadamente funcional e restaurando os dados apenas se uma reversão coordenada não conseguir iniciar a stack.

Uma atualização pode alterar simultaneamente o código da aplicação, os requisitos de esquema da base de dados, as variáveis de ambiente e as versões dos serviços complementares. Obter repetidamente a versão mais recente ou misturar contentores antigos e novos dificulta a identificação do limite de recuperação. Guarde o ficheiro Compose, o ambiente, os registos, a base de dados e os caminhos de carregamento antes de agir; depois, escolha entre reverter as imagens ou restaurar a base de dados e a biblioteca em conjunto.

Congele o estado da falha e identifique o limite da atualização

Interrompa os reinícios automáticos e registe as imagens ou os resumos exatos dos serviços de servidor, aprendizagem automática, base de dados e cache. Guarde os registos de arranque e os ficheiros de implementação antes de voltar a obter imagens. O resultado é positivo se conseguir identificar o que mudou; se não, a recuperação deve aguardar até ser possível identificar as versões antigas através do histórico de implementação ou das imagens locais.

Verifique se o servidor termina antes de se ligar à base de dados, durante uma migração ou depois de ficar pronto. Um erro de ligação a uma dependência aponta para um problema de rede, credenciais ou estado de funcionamento; um erro de migração aumenta o risco de restaurar apenas a imagem da aplicação, pois a base de dados pode já ter sido alterada.

Um guia passo a passo sobre atualizações do Immich entre versões mostra por que razão os limites entre versões e os ficheiros de implementação são importantes. Use-o para identificar as alterações, considerando os seus próprios registos e cópias de segurança como a referência definitiva para a reversão.

Experimente primeiro reverter todas as imagens para a última versão comprovadamente funcional

Fixe todas as imagens da aplicação Immich na versão exata que estava a funcionar anteriormente, em vez de alterar apenas um serviço. Recrie os contentores afetados sem tocar nos volumes persistentes. Se a stack ficar operacional e os registos não mostrarem incompatibilidades de esquema, esta reversão com poucas alterações é bem-sucedida.

Se o servidor antigo rejeitar o esquema atual da base de dados, pare. Não alterne entre versões usando a mesma base de dados nem edite manualmente as tabelas de migração. Essa falha significa que a atualização atravessou um limite de dados e a recuperação tem de usar uma cópia de segurança da base de dados com uma data e hora correspondentes à versão da aplicação selecionada.

Um relato sobre o Immich v1.135.3 documenta uma falha específica no arranque durante a migração da base de dados após uma atualização. O exemplo de migração limitada justifica a análise atenta do primeiro erro fatal; não autoriza copiar os comandos desse caso para outra versão.

Restaure a base de dados e os ficheiros multimédia apenas se não for possível recuperar através da reversão

Crie uma cópia de segurança ou um instantâneo do armazenamento do estado com falhas antes de o repor. Prepare um destino de recuperação limpo, restaure a cópia de segurança da base de dados e, em seguida, disponibilize a biblioteca de carregamentos correspondente e os ficheiros de implementação necessários. Não substitua a única biblioteca atual por uma cópia mais antiga apenas para alinhar as datas e horas.

Os registos da base de dados e os ficheiros dos recursos têm de corresponder à mesma coleção. Se a cópia de segurança for anterior a carregamentos recentes, preserve esses ficheiros mais recentes separadamente para posterior reconciliação. A reposição é bem-sucedida quando as migrações são concluídas, os utilizadores e recursos esperados aparecem e os originais selecionados abrem sem erros generalizados de ficheiros em falta.

O guia de migração do Immich do ZimaSpace fornece um inventário útil para mover componentes persistentes sem tratar uma imagem de contentor como se fosse a própria biblioteca de fotografias.

Valide a recuperação antes de voltar a tentar a atualização

Teste o início de sessão, a navegação na cronologia, a transferência do original, a geração de miniaturas, a pesquisa inteligente, o processamento de rostos, um novo carregamento e uma cópia de segurança da base de dados. Reinicie os contentores e o anfitrião uma vez. A validação é aprovada se os mesmos recursos e funcionalidades estiverem disponíveis após o reinício, sem erros recorrentes de migração ou permissões.

Mantenha os estados de falha e de recuperação identificados separadamente até ao fim da validação. Se a recuperação depender de uma versão anterior, desative a obtenção automática de imagens e documente a fixação da versão. Volte a tentar a atualização apenas depois de rever todas as versões intermédias e de criar uma nova cópia de segurança coordenada.

Reponha o destino de recuperação preservado se um novo carregamento desaparecer, os originais não abrirem ou as tarefas falharem repetidamente. Encaminhe o problema com as versões de origem e de destino, os hashes das imagens, o primeiro erro fatal do registo, a data e hora da cópia de segurança da base de dados e o mapeamento do armazenamento; nunca elimine a última cópia comprovadamente funcional enquanto a compatibilidade da atualização não estiver resolvida.

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.