Como recuperar uma base de dados do Immich a partir de uma cópia de segurança fiá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.

Uma cópia de segurança conhecida como válida da base de dados do Immich só é útil se a restaurar num estado controlado e confirmar que a base de dados recuperada continua a apontar para os ficheiros multimédia a que o seu servidor consegue aceder.

Trate a recuperação como uma sequência, não como um único comando de importação. Preserve primeiro a instância com falhas, identifique a versão do Immich e a data e hora da cópia de segurança, inicie um destino limpo com uma base de dados compatível, restaure sem deixar primeiro a aplicação escrever num esquema vazio e, em seguida, valide as contas, os dados da cronologia, os caminhos dos ficheiros multimédia e uma nova escrita. Se algum passo não estiver claro, pare antes de substituir a última cópia recuperável.

Congele o estado com falhas antes de restaurar seja o que for

Interrompa novos carregamentos e escritas em segundo plano na instância do Immich afetada antes de iniciar a recuperação. Guarde o ficheiro Compose atual, os valores do ambiente, os caminhos montados, as versões das imagens, os registos recentes e o estado danificado da base de dados, se o armazenamento o permitir. Uma base de dados com falhas ainda pode conter indícios que expliquem o que aconteceu, e substituí-la elimina esses indícios.

Identifique exatamente a cópia de segurança em que pretende confiar. Registe a data e hora, como foi criada, o tamanho do ficheiro e se alguma vez foi testada numa restauração. Um despejo SQL produzido pela base de dados é um recurso de recuperação diferente de uma cópia em bruto do diretório de dados ativo do PostgreSQL; não os trate como equivalentes.

Sempre que possível, crie o destino da recuperação num diretório separado ou numa pilha isolada. A condição para concluir esta etapa é simples: o estado original com falhas foi preservado, a cópia de segurança escolhida está em modo só de leitura e sabe a que versão da implementação e caminhos de armazenamento a restauração se destina.

Confirme que a cópia de segurança pode mesmo ser restaurada

Inspecione a cópia de segurança antes de a voltar a reproduzir. Um despejo SQL comprimido deve ser descomprimido sem erros e conter conteúdo reconhecível de um despejo PostgreSQL, em vez de ser um arquivo vazio produzido por um processo que falhou. Se tiver somas de verificação ou resultados de verificação do repositório, compare-os agora, em vez de descobrir que há corrupção a meio da recuperação.

Um dump do PostgreSQL é um recurso de recuperação mais seguro do que uma cópia ocasional de um diretório de uma base de dados em utilização, porque é criado com ferramentas específicas para bases de dados e pode ser reproduzido num destino limpo. O padrão de cópia de segurança através de um dump da base de dados também mantém a base de dados separada da cópia dos ficheiros multimédia, facilitando a validação de cada parte antes da recuperação.

Confirme também que os ficheiros multimédia e a configuração correspondentes ao período da cópia de segurança ainda existem. Restaurar apenas a base de dados pode recuperar utilizadores, álbuns, metadados e referências a ficheiros, mas deixar todos os recursos inacessíveis se os caminhos da biblioteca referenciados estiverem em falta. Avance apenas quando o dump e o conjunto de ficheiros multimédia e de configuração corresponderem a um ponto de recuperação conhecido.

Inicie primeiro um destino de base de dados limpo e compatível

Adapte o método de restauração à versão que criou a cópia de segurança. As versões atuais do Immich permitem restaurar a base de dados através de Administração > Manutenção e do processo de configuração inicial de uma nova instalação, enquanto as cópias de segurança mais antigas podem exigir instruções manuais específicas da versão; o processo de restauração foi alterado na v2.5.0.

Num destino de recuperação novo, não permita que o Immich execute migrações normais numa estrutura vazia antes de a restauração da base de dados estar pronta. Se o seu método de implementação iniciar a aplicação juntamente com o PostgreSQL, use os controlos de restauração adequados à versão, para que o servidor não crie um estado concorrente antes da importação.

Se a base de dados não ficar operacional por si só, pare e resolva primeiro esse problema. Não continue a reproduzir a mesma cópia de segurança num destino que está a reiniciar, sem espaço em disco ou a usar uma configuração de armazenamento incompatível. Um destino limpo e estável é um requisito, não uma tarefa secundária de resolução de problemas.

Restaure o dump uma vez e pare ao primeiro erro

Restaure a cópia escolhida na base de dados preparada e registe a saída completa. Utilize as ferramentas e opções adequadas ao formato da cópia para que um erro faça o restauro falhar de forma visível, em vez de deixar um esquema importado parcialmente que ainda inicia.

Um conjunto de migração utilizável requer os ficheiros, o estado do PostgreSQL e a configuração que os liga. Um conjunto completo de cópias de segurança do Immich inclui ficheiros carregados, uma cópia de segurança da base de dados num formato suportado e a configuração da implementação, sendo o teste de restauro utilizado para comprovar que o conjunto funciona. Mantenha estes elementos juntos para que seja possível associar o destino a um único ponto de recuperação.

Após uma importação bem-sucedida, inicie a aplicação Immich e acompanhe atentamente o primeiro arranque. Se a interface lhe pedir para criar um novo administrador principal em vez de aceitar as contas existentes, pare: isso sugere fortemente que a base de dados restaurada não é a que o Immich está a utilizar. Não comece a carregar novamente fotografias para esse estado vazio.

Valide o estado da base de dados, os caminhos dos ficheiros multimédia e uma nova gravação

Inicie sessão com uma conta existente e percorra a cronologia, incluindo datas antigas e recentes. Abra vários originais, inspecione álbuns ou favoritos que sabe que existiam e confirme que a aplicação consegue localizar os ficheiros subjacentes, em vez de apenas apresentar linhas da base de dados.

O estado da base de dados, os ficheiros da aplicação, a configuração e os carregamentos têm de estar em concordância no momento do restauro. Use uma cópia de segurança consistente do contentor da base de dados como critério de aceitação, em vez de verificar apenas se o PostgreSQL inicia.

Por fim, carregue uma única fotografia descartável, aguarde o processamento normal, confirme que permanece após reiniciar o Immich e o anfitrião e, em seguida, elimine-a através da aplicação. Se as contas, os ficheiros existentes e a nova gravação funcionarem normalmente, faça uma nova cópia de segurança do estado recuperado antes de qualquer atualização de versão. Caso contrário, volte às provas da falha preservadas ou a uma cópia de segurança anterior comprovadamente funcional, em vez de agravar os danos.

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.