Porque é que o Immich perde o acesso aos dados persistentes após recriar a stack?

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.

Quando o Immich parece vazio ou não consegue ler a biblioteca após a recriação da stack, parta do princípio de que os dados persistentes antigos estão desligados ou ilegíveis, antes de presumir que foram eliminados.

A recriação dos contentores pode alterar a identidade do projeto Compose, a origem da montagem bind, a associação do volume nomeado, o momento de ligação da partilha de rede ou o UID/GID usado para ler os dados. Pare a instância que parece nova antes de esta gravar muitos dados novos, localize no anfitrião os caminhos antigos da base de dados e dos ficheiros multimédia e compare a stack recriada com o último mapeamento comprovadamente válido. O objetivo é voltar a ligar primeiro os dados existentes; recorra a uma cópia de segurança apenas depois de confirmar que esses dados estão realmente em falta ou danificados.

Pare a instância recém-criada e confirme que os dados antigos continuam a existir

Um assistente de configuração, uma cronologia vazia ou a ausência de uma biblioteca externa imediatamente após a recriação são sinais de alerta de persistência. Pare o Immich e inspecione as localizações da base de dados e dos ficheiros multimédia no anfitrião antes de carregar novos ficheiros ou aceitar uma nova configuração vazia. Novas gravações podem dificultar comparações posteriores dos caminhos.

Verifique se os diretórios antigos contêm as quantidades de ficheiros esperadas, datas de modificação, ficheiros ou despejos da base de dados e imagens originais representativas. Se os dados estiverem no anfitrião, o problema está no acesso ou no mapeamento, não no desaparecimento dos dados. Crie um instantâneo só de leitura ou uma cópia de segurança desse estado antes de alterar a propriedade ou mover diretórios.

Se os dados antigos não forem encontrados nos caminhos esperados, procure no conjunto de armazenamento e no inventário de volumes do Docker antes de eliminar seja o que for. A decisão é binária: o estado existente é localizado e protegido, ou está realmente indisponível e o processo de recuperação passa a recorrer a uma cópia de segurança comprovadamente válida, em vez de tentar reparar as montagens.

Compare as montagens dos contentores recriados com as da stack anterior

Inspecione as montagens efetivas dos contentores recriados do servidor Immich e da base de dados, não apenas o texto do Compose que se lembra de ter editado. Um caminho relativo de bind pode ser resolvido a partir de um diretório de projeto diferente, e um projeto Compose com outro nome pode ligar um novo volume nomeado, deixando o antigo intacto, mas sem utilização.

Uma montagem falhada, alterada ou em falta pode fazer aparecer um diretório vazio dentro de um contentor, mesmo quando os dados esperados continuam a existir noutro local do anfitrião. Use as verificações de montagem de volumes do Docker para comparar Source, Destination, o tipo de montagem e a identidade do volume com nome em cada caminho persistente do Immich. Uma incompatibilidade neste ponto explica diretamente o aspeto de uma instância nova.

Corrija apenas o mapeamento de montagem incorreto e, em seguida, crie ou inicie o contentor sem remover volumes. Se os ficheiros esperados aparecerem no mesmo caminho do contentor após a alteração, deixe os dados onde estão. Se a lista de montagens estiver correta, mas o acesso continuar a falhar, mantenha o mapeamento e investigue a disponibilidade do armazenamento do anfitrião e as permissões, em vez de criar outro volume.

Verifique se o armazenamento externo foi montado antes de o Immich arrancar

Se os dados do Immich estiverem num conjunto de HDD, numa partilha NAS, numa camada de união ou noutro ponto de montagem externo, confirme que o armazenamento está realmente montado no anfitrião antes de o Docker iniciar a pilha. Um caminho como /mnt/photos pode continuar a existir como diretório local normal quando o dispositivo real está indisponível.

Os dados persistentes do Docker só sobrevivem à substituição do contentor quando o volume ou a montagem vinculada pretendidos são novamente associados corretamente. O modelo de persistência de volumes do Docker subjacente não faz aparecer automaticamente um disco do anfitrião ou uma partilha de rede em falta. Por isso, verifique o dispositivo de armazenamento e um ficheiro conhecido no anfitrião antes de testar o mesmo caminho no Immich.

Se descobrir que foram escritos ficheiros de recurso no ponto de montagem vazio enquanto o armazenamento real estava indisponível, pare o Immich antes de montar o dispositivo sobre esses ficheiros. Trate esses ficheiros separadamente, adicione uma dependência de arranque ou uma verificação do estado do ponto de montagem do armazenamento e só então reinicie a pilha. Se o armazenamento do anfitrião estiver estável e o caminho do contentor continuar ilegível, avance para a secção sobre permissões.

Verifique UID, GID e permissões dos diretórios sem reescrever tudo

Uma stack recriada pode executar um serviço com uma identidade numérica, um espaço de nomes de utilizadores ou um contexto de segurança diferente dos antigos. O resultado é diferente de uma montagem em falta: o caminho existe e os ficheiros estão visíveis no anfitrião, mas os registos do Immich mostram erros de permissão ou indicam que não é possível criar os ficheiros esperados.

Compare a propriedade numérica e os bits de permissões dos diretórios afetados no anfitrião com a identidade do utilizador dentro do contentor recriado. Teste primeiro uma leitura inofensiva e, em seguida, uma escrita reversível num local descartável na mesma montagem. Evite alterar recursivamente a propriedade de todo o arquivo de fotografias até saber que serviço precisa de acesso de escrita e que ficheiros originais devem permanecer intactos.

Corrija a menor discrepância de diretório ou identidade que explique a falha, reinicie uma vez e volte a verificar os registos. Se o acesso continuar a falhar com as montagens e permissões corretas, pare de fazer alterações ao sistema de ficheiros e verifique a ligação à base de dados, a substituição de variáveis de ambiente ou a camada de segurança que mudou com a recriação.

Voltar a ligar o estado original e validar outra recriação

Depois de ligar os caminhos antigos da base de dados e dos ficheiros multimédia e confirmar que são legíveis, inicie o Immich e procure os utilizadores, álbuns, pessoas e ficheiros representativos antigos. Não considere a reparação concluída só porque a página inicial carrega; confirme que a aplicação está a ler o estado original, em vez de uma base de dados recém-inicializada.

A distinção útil é que os contentores podem ser descartáveis, enquanto o estado da aplicação tem de permanecer num armazenamento estável, fora do ciclo de vida do contentor. Documente os nomes corrigidos das montagens e os caminhos no anfitrião e use funções de armazenamento persistente do servidor de ficheiros para manter a próxima recriação da stack ligada aos mesmos dados.

Por fim, recrie a stack mais uma vez em condições controladas e repita as verificações originais. A correção só está comprovada se a mesma base de dados e os mesmos ficheiros multimédia reaparecerem após a recriação e após o reinício do anfitrião. Se o estado antigo voltar a desaparecer, ou se a base de dados indicar corrupção em vez de erros de acesso, reverta para a cópia protegida e opte pela recuperação da base de dados/cópia de segurança, em vez de continuar a experimentar montagens.

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.