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

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



