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

Evite a perda de configuração do Immich durante as atualizações, tratando o ficheiro Compose, os valores de ambiente, a base de dados, a biblioteca de carregamentos e as definições de montagem das bibliotecas externas como ativos 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 parecer apagar o Immich quando uma montagem bind relativa é resolvida a partir de um diretório de projeto diferente, uma alteração no ambiente nunca chega ao contentor recriado ou a nova stack arranca com uma base de dados vazia. Faça primeiro o inventário da implementação ativa, mantenha cópias versionadas fora do anfitrião e comprove uma recriação controlada antes da mudança para produção.

Capture a Implementação Ativa Antes de Cada Atualização

Exporte a configuração Compose efetiva com os segredos ocultados, registe as versões ou os digests das imagens e copie os ficheiros Compose e de ambiente para armazenamento versionado. Inspecione as montagens dos contentores em execução, em vez de presumir que o ficheiro no seu editor iniciou os contentores atuais. O requisito é cumprido quando cada caminho de execução corresponde 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 das redes e quaisquer dispositivos de aceleração de hardware. Um item em falta transforma-se mais tarde numa diferença inexplicada após a atualização.

As perguntas da comunidade sobre atualizações mostram repetidamente operadores a perder o controlo sobre a geração do Compose ou a estrutura do ambiente aplicável. A lição útil de uma discussão sobre a configuração de atualização é preservar a definição atualmente funcional antes de a traduzir.

Faça Cópias de Segurança Separadas da Base de Dados, dos Conteúdos e dos Ficheiros 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 consegue reconstruir os contentores, mas não restaurar contas, metadados, álbuns ou registos de ativos.

Utilize uma cópia de segurança com o serviço parado para obter o limite de consistência mais simples, ou coordene uma exportação da base de dados em execução com 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 proprietário dos ficheiros originais, porque os caminhos e as regras de acesso continuam a afetar o serviço restaurado.

Um procedimento de atualização para uma versão principal mantido pela comunidade salienta a preservação da base de dados, dos conteúdos, do Compose e dos dados de ambiente. Trate a sequência como experiência operacional e confirme cada passo relativamente à versão que efetivamente implementa.

Prepare a Atualização com Versões Fixadas

Leia as notas de lançamento de todas as versões ignoradas e atualize deliberadamente a definição de implementação guardada. Fixe a versão de destino, descarregue-a sem remover as imagens antigas e valide a configuração Compose renderizada. Variáveis desconhecidas, montagens vazias ou versões de serviços misturadas impedem a passagem da validação de preparação.

Quando a capacidade o permitir, 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 arranque bem-sucedido do contentor não prova que a biblioteca original esteja ligada.

O guia relacionado da ZimaSpace sobre um NAS autoalojado seguro ajuda a colocar os ficheiros de implementação e as cópias de segurança fora do único anfitrião e limite de credenciais que uma atualização pode comprometer.

Featured

ZimaCube 2 NAS Pessoal Cloud para Casa

ZimaCube2

$799.00 - $2,499.00

Buy Now

Comprove a Persistência da Configuração Após a Recriação

Antes da mudança, recrie os contentores de teste a partir dos ficheiros guardados, em vez de os reiniciar no local. 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 requisito é cumprido quando a configuração sobrevive à substituição porque reside em componentes persistentes documentados.

Após a mudança para produção, carregue um ativo de teste, execute 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 repita o processo. 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 permaneça estável durante a janela de observação.

Se a atualização já tiver arrancado vazia, pare-a antes que a integração de utilizadores ou novos carregamentos crie um estado conflituoso. Ligue novamente apenas um caminho persistente verificado ou restaure para um destino limpo. Reverta quando os utilizadores ou ativos esperados estiverem ausentes; peça assistência com o Compose efetivo sanitizado, as montagens, as versões e os carimbos temporais das cópias de segurança se a identidade continuar ambígua.