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

Restaure o Immich após uma atualização falhada do contentor, congelando as evidências atuais, fixando cada serviço do Immich na última versão conhecida como estável e restaurando os dados apenas se uma reversão coordenada não conseguir iniciar a pilha.

Uma atualização pode alterar simultaneamente o código da aplicação, as expectativas do esquema da base de dados, as variáveis de ambiente e as versões dos serviços complementares. Extrair repetidamente a versão mais recente ou misturar contentores antigos e novos torna mais difícil identificar o limite da recuperação. Guarde o ficheiro Compose, o ambiente, os registos, a base de dados e os caminhos dos carregamentos antes de agir; depois, escolha entre reverter a imagem ou restaurar integralmente a base de dados e a biblioteca.

Congele o Estado Falhado 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 efetuar outra extração. A aprovação significa que consegue indicar o que mudou; a reprovação significa que 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 uma reparação da rede, das credenciais ou do estado de saúde; 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 sobre atualizações versionadas do Immich mostra por que motivo o limite da versão e os ficheiros de implementação são importantes. Utilize-o para inventariar a transição, tratando os seus próprios registos e cópias de segurança como a autoridade para a reversão.

Tente Primeiro uma Reversão Completa para a Última Imagem Conhecida como Estável

Fixe todas as imagens da aplicação Immich na versão exata que funcionava anteriormente, em vez de alterar apenas um serviço. Recrie os contentores afetados, mantendo os volumes persistentes intactos. Se a pilha ficar saudável e os registos não mostrarem incompatibilidade do esquema, esta reversão de baixa alteração é aprovada.

Se o servidor antigo recusar 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 que a recuperação tem de utilizar uma cópia de segurança da base de dados cujo carimbo temporal corresponda à versão da aplicação selecionada.

Um relatório do Immich v1.135.3 documenta uma falha específica de arranque durante a migração da base de dados após uma atualização. O seu exemplo de migração limitada justifica a leitura cuidadosa do primeiro erro fatal; não constitui autorização para copiar os comandos desse caso para outra versão.

Restaure a Base de Dados e os Ficheiros Multimédia Apenas Quando a Reversão Não Conseguir Recuperar o Sistema

Crie uma cópia de segurança ou um instantâneo do armazenamento do estado falhado antes de restaurar. 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 os carimbos temporais.

Os registos da base de dados e os ficheiros dos recursos devem descrever a mesma coleção. Se a cópia de segurança for anterior aos carregamentos recentes, preserve esses ficheiros mais recentes separadamente para reconciliação posterior. Uma restauração é aprovada 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 da 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.

-15% OFF

ZimaBoard 2 - Mini Servidor Doméstico para a Sua Grande Ideia

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Valide a Recuperação Antes de Tentar Novamente a Atualização

Teste o início de sessão, a navegação pela linha cronológica, a transferência de originais, 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 aprovação exige que os mesmos recursos e funções estejam disponíveis após o reinício, sem erros repetidos de migração ou permissões.

Mantenha os estados falhado e recuperado identificados separadamente até terminar a validação. Se a recuperação depender de uma versão mais antiga, desative as extrações automáticas de imagens e documente a versão fixada. Tente novamente a atualização apenas depois de rever todas as versões intermédias e efetuar uma nova cópia de segurança coordenada.

Reverta para o destino de recuperação preservado se um novo carregamento desaparecer, os originais não abrirem ou as tarefas falharem repetidamente. Escale o problema com as versões de origem e destino, os resumos das imagens, o primeiro registo fatal, o carimbo temporal da cópia de segurança da base de dados e o mapeamento do armazenamento; nunca elimine a última cópia conhecida como estável enquanto a compatibilidade da atualização continuar por resolver.