Como impedir que as cópias de segurança do Immich capturem um estado inconsistente

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.

Evite cópias de segurança inconsistentes do Immich tratando a base de dados e os ficheiros multimédia como uma única unidade de recuperação, cuja ordem de captura e atividade de escrita são controladas deliberadamente.

Uma cópia de segurança pode conter todos os ficheiros que lhe foi pedido copiar e, ainda assim, ser restaurada incorretamente se a base de dados fizer referência a recursos que não foram capturados ou se a cópia dos ficheiros multimédia corresponder a um momento diferente do catálogo. Defina primeiro o limite de consistência, escolha um método com a aplicação parada ou em funcionamento coordenado e valide o resultado num ambiente isolado.

Defina a unidade de recuperação antes de agendar a cópia de segurança

Identifique a base de dados PostgreSQL, os ficheiros multimédia carregados, os dados de perfil, a configuração da implementação, os valores de ambiente, os segredos e quaisquer caminhos de armazenamento personalizados necessários para recriar o serviço. Distinga as miniaturas geradas, os vídeos codificados e os ficheiros de modelos, de acordo com a política de recuperação, que determina se devem ser salvaguardados ou regenerados.

A comparação da ZimaSpace entre cópias de segurança do Immich em funcionamento e com a aplicação parada explica a escolha básica de consistência. Este fluxo de prevenção vai um passo além: seja qual for o método escolhido, tem de produzir um ponto documentado que possa ser restaurado sem adivinhar qual a base de dados que corresponde a cada cópia dos ficheiros multimédia.

Indique a ordem de restauro junto ao âmbito da cópia de segurança. Se o plano disser «restaurar fotografias», mas não especificar qual o despejo da base de dados, a configuração, as credenciais e os mapeamentos de armazenamento que voltam a associar essas fotografias aos utilizadores e aos álbuns, a definição da cópia de segurança está incompleta antes mesmo do início da primeira execução agendada.

Use uma captura com a aplicação parada quando for aceitável optar pela abordagem mais simples

Para uma família pequena que possa tolerar uma curta janela de manutenção, pause os carregamentos e pare os serviços da aplicação que escrevem dados na biblioteca. Crie a cópia de segurança da base de dados, capture os ficheiros multimédia e a configuração e, em seguida, reinicie os serviços apenas quando o instantâneo ou a cópia tiver uma data e hora claras e um resultado de conclusão.

O facto de a aplicação estar parada não significa que um caminho incorreto se torne automaticamente correto. Verifique se a exportação da base de dados foi bem-sucedida, se foram incluídas as raízes de ficheiros multimédia pretendidas e se o destino da cópia de segurança é independente dos dados ativos que deverá permitir recuperar. Registe as horas de início e de fim para que os restauros posteriores possam identificar a geração exata.

O método é aprovado quando não ocorrem gravações na aplicação durante a captura e um teste de restauro devolve os utilizadores, as contagens de recursos, os álbuns e os originais amostrados esperados. Se o tempo de inatividade exceder regularmente o que a família tolera, passe para um método em funcionamento coordenado, em vez de permitir discretamente que os carregamentos sejam retomados a meio da cópia de ficheiros.

Para cópias de segurança em funcionamento, capture a base de dados e os ficheiros por uma ordem definida

Quando o Immich tem de continuar disponível, crie um despejo consistente nativo da base de dados, em vez de copiar como ficheiros normais o diretório de dados ativo do PostgreSQL. Em seguida, capture ou crie um instantâneo da árvore de ficheiros multimédia pela ordem documentada, acompanhando os carregamentos que ocorram durante a janela de cópia de segurança.

O fluxo de trabalho prático para criar cópias de segurança da base de dados do Immich demonstra a abordagem consciente da base de dados. Os comandos e os nomes dos contentores podem variar consoante a implementação; por isso, o princípio transferível é pedir ao PostgreSQL uma cópia de segurança consistente, em vez de confiar numa cópia recursiva em direto dos ficheiros da base de dados.

Prefira uma ordem que não possa deixar a base de dados restaurada a apontar para ficheiros multimédia que nunca foram incluídos na cópia de segurança. Se a cópia do sistema de ficheiros contiver ficheiros adicionais de que a base de dados ainda não tem conhecimento, estes podem ser reconciliados com mais segurança do que registos da base de dados cujos ficheiros originais referenciados estejam em falta. Documente todos os carregamentos que atravessem o limite.

Coordene os instantâneos do sistema de ficheiros com hooks da base de dados, em vez de presumir atomicidade

Os instantâneos do sistema de ficheiros são valiosos porque capturam rapidamente um volume, mas, por si só, não tornam transacionalmente consistentes dois sistemas que mudam de forma independente. Se a base de dados e os ficheiros multimédia estiverem em conjuntos de dados ou dispositivos diferentes, defina hooks anteriores e posteriores à criação do instantâneo e mantenha os respetivos horários visíveis no registo da cópia de segurança.

Um exemplo de 2026 que combina software de cópias de segurança com hooks de instantâneos Btrfs mostra por que motivo a orquestração de instantâneos precisa de limites explícitos ao nível da aplicação ou da base de dados. Use a ideia para coordenar as capturas; não copie cegamente os comandos do sistema de ficheiros para uma disposição diferente.

Se a ferramenta de instantâneos não conseguir coordenar o limite temporal da base de dados e dos ficheiros multimédia, recorra a um despejo lógico da base de dados e a uma cópia de segurança dos ficheiros multimédia, em vez de afirmar que a recuperação é atómica. A complexidade só se justifica quando o teste de restauro comprova que a captura mais rápida continua a devolver um estado coerente da aplicação.

Inclua os testes de restauro no calendário das cópias de segurança

Uma tarefa de cópia de segurança bem-sucedida apenas demonstra que a captura foi concluída. Selecione periodicamente uma geração recente, restaure-a num nome de anfitrião isolado, anexe o armazenamento previsto e verifique os utilizadores, os ficheiros originais representativos, os álbuns, as permissões, o comportamento da pesquisa e uma cópia de segurança recente da base de dados a partir da instância restaurada.

A visão geral da recuperação do PostgreSQL, apresentada no planeamento de cópias de segurança e restauro do PostgreSQL, dá ênfase à validação do restauro e aos objetivos de recuperação, em vez de considerar a criação do despejo como o fim do processo. Aplique a mesma disciplina à unidade de recuperação combinada do Immich.

Reprove a política de cópias de segurança se o restauro da base de dados for bem-sucedido, mas faltarem ficheiros, se os ficheiros multimédia abrirem sem utilizadores ou relações, ou se a recuperação depender de um segredo guardado apenas no anfitrião que falhou. Corrija o âmbito, a ordem, a retenção ou a independência antes de aumentar a frequência das cópias de segurança; mais cópias inconsistentes não criam um ponto de recuperação fiável.

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.