Como evitar a perda da configuração do Immich durante as atualizações

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 a perda de configuração do Immich durante as atualizações, tratando o ficheiro Compose, os valores do ambiente, a base de dados, a biblioteca de carregamentos e as definições dos pontos de montagem das bibliotecas externas como recursos persistentes separados que têm de ser capturados e restaurados em conjunto.

Um contentor pode ser substituído; a configuração que o rodeia, não. Uma atualização pode dar a impressão de apagar o Immich se um ponto de montagem associado a um caminho relativo for resolvido a partir de um diretório de projeto diferente, se uma alteração ao ambiente nunca chegar ao contentor recriado ou se a nova pilha arrancar com uma base de dados vazia. Faça primeiro o inventário da implementação ativa, guarde cópias com controlo de versões fora do anfitrião e valide uma recriação controlada antes da migração para produção.

Registe a implementação ativa antes de cada atualização

Exporte a configuração efetiva do Compose com os segredos ocultos, registe as versões ou os resumos das imagens e copie os ficheiros Compose e de ambiente para armazenamento com controlo de versões. Inspecione os pontos de montagem em execução em vez de presumir que o ficheiro no editor iniciou os contentores atuais. O teste é bem-sucedido se cada caminho em execução corresponder a uma localização conhecida no anfitrião.

Registe os caminhos das bibliotecas externas, as definições do proxy inverso, o URL de aprendizagem automática, os valores de ligação à base de dados, a identidade do utilizador e do grupo, os nomes da rede e quaisquer dispositivos de aceleração de hardware. A falta de um elemento nesta lista transforma-se mais tarde numa diferença inexplicável após a atualização.

As dúvidas da comunidade sobre atualizações mostram repetidamente que os operadores perdem de vista qual a geração do Compose ou disposição do ambiente aplicável. A lição útil de uma discussão sobre a configuração da atualização é preservar a definição atual em funcionamento antes de a converter.

Faça cópias de segurança separadas da base de dados, dos ficheiros multimédia e de implementação

Faça uma cópia de segurança nativa da base de dados, além de uma cópia de segurança ou instantâneo do sistema de ficheiros da biblioteca de carregamentos e do diretório de implementação. Registe as horas de início e conclusão, os tamanhos dos arquivos e as somas de verificação. Uma cópia de segurança que contenha apenas YAML do Compose permite reconstruir os contentores, mas não restaurar contas, metadados, álbuns ou registos de recursos.

Utilize uma cópia de segurança com o serviço parado para obter a forma mais simples de garantir a consistência, ou coordene uma exportação da base de dados em funcionamento e um instantâneo do armazenamento, documentando a relação entre ambos. Mantenha as bibliotecas externas no inventário, mesmo que o Immich não seja responsável pelos ficheiros originais, porque os caminhos e as regras de acesso continuam a afetar o serviço restaurado.

Um procedimento de atualização entre versões principais mantido pela comunidade salienta a importância de preservar a base de dados, os ficheiros multimédia, a configuração Compose e os dados do ambiente. Considere a sequência como uma experiência operacional e confirme cada passo com base na versão que vai efetivamente implementar.

Preparar a atualização com versões fixas

Leia as notas de lançamento de todas as versões intermédias e atualize deliberadamente a definição de implementação guardada. Fixe a versão de destino, transfira-a sem remover as imagens antigas e valide a configuração Compose apresentada. Variáveis desconhecidas, pontos de montagem vazios ou versões de serviço incompatíveis reprovam a fase de preparação.

Se houver capacidade disponível, restaure a cópia de segurança numa stack de teste isolada, com portas diferentes e sem acesso de escrita à produção. Inicie-a na versão de destino e inspecione as migrações, os utilizadores, os caminhos de armazenamento e as tarefas em segundo plano. O simples facto de um contentor iniciar com êxito não comprova que a biblioteca original está associada.

O guia relacionado do ZimaSpace para um NAS autoalojado seguro ajuda a guardar os ficheiros de implementação e as cópias de segurança fora dos limites do anfitrião e das credenciais que uma atualização pode afetar.

Comprovar a persistência da configuração após a recriação

Antes da transição, recrie os contentores de teste a partir dos ficheiros guardados, em vez de os reiniciar tal como estão. Verifique os utilizadores, as definições do servidor, os modelos de armazenamento, as bibliotecas, as tarefas, o acesso através do proxy e os valores efetivos do ambiente. O teste é bem-sucedido quando a configuração sobrevive à substituição porque reside em componentes persistentes documentados.

Após a transição para produção, carregue um recurso de teste, faça uma pesquisa, abra um original e crie uma nova cópia de segurança da base de dados. Reinicie a stack e o anfitrião e, em seguida, repita os passos. Mantenha a versão antiga, a cópia de segurança e a definição de implementação até que a carga de trabalho normal se mantenha estável durante o período de observação.

Se a atualização já tiver começado sem os dados, pare-a antes que o processo de configuração inicial ou novos carregamentos criem um estado conflituoso. Volte a associar apenas um caminho persistente verificado ou restaure os dados num destino limpo. Reverta a atualização se os utilizadores ou recursos esperados estiverem em falta; se a identidade continuar ambígua, peça assistência, partilhando uma configuração Compose efetiva sanitizada, os pontos de montagem, as versões e as datas e horas das cópias de segurança.

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.