Antes de atualizar o Home Assistant Container, registe o contrato do contentor em execução, verifique uma cópia de segurança fora do contentor, confirme que as dependências estão prontas e preserve uma imagem de reversão testada.
A configuração persistente poderá sobreviver à recriação do contentor, ao passo que rádios USB, serviços de base de dados, modos de rede, segredos, integrações personalizadas ou contentores complementares poderão não sobreviver. Elabore a lista de verificação com base na implementação atual exata, não num exemplo genérico de compose. Não transfira e reinicie até conseguir localizar a cópia de segurança fora do contentor, confirmar que há espaço livre suficiente e restaurar a referência da imagem anterior.
Registe o contrato do contentor em execução
Registe o digest ou a versão exatos da imagem do Home Assistant, os argumentos do contentor, o modo de rede, as portas publicadas, as variáveis de ambiente, a política de reinício, o fuso horário, as opções de segurança, a verificação de estado, os caminhos montados e os mapeamentos de dispositivos. Exporte a definição atual do compose ou da orquestração e compare-a com o contentor em execução para detetar divergências.
As migrações de contentores dependem muitas vezes de mais do que o diretório de configuração visível. Um relato comunitário sobre a migração do Home Assistant OS para contentores destaca as definições separadas do Zigbee2MQTT, do broker e da stack, mostrando por que motivo é necessário inventariar a stack completa de contentores.
PASS significa que outro administrador conseguiria recriar o contentor atual a partir do registo, sem ter de adivinhar. FAIL significa que uma montagem, um dispositivo, um segredo ou um comando só existe no estado de execução. Harmonize o ficheiro de implementação antes de atualizar; caso contrário, a reversão poderá recriar um ambiente diferente.
Verifique a cópia de segurança fora do contentor
Crie a cópia de segurança planeada, copie-a ou guarde-a fora do sistema de ficheiros do contentor e, de preferência, fora do mesmo domínio de falha do anfitrião. Registe a data e hora e o tamanho. Confirme que inclui a configuração persistente, os registos de armazenamento ocultos, os segredos necessários para o restauro e qualquer cópia de segurança da base de dados externa necessária à arquitetura escolhida.
Uma discussão sobre restauros em Docker recomenda explicitamente manter as cópias de segurança fora do contentor e copiar a cópia mais recente antes de remover a instância antiga. Essa regra das cópias de segurança fora do contentor impede que a substituição do contentor elimine a única cópia de recuperação.
PASS significa que o ficheiro é legível no ambiente de recuperação e que o seu conteúdo ou um restauro de teste foi verificado. FAIL significa que a cópia de segurança só existe no volume que está a ser alterado ou depende de credenciais não documentadas. Não avance com a atualização até que a recuperação seja independente do novo contentor.
Verifique as dependências da base de dados, do armazenamento e do rádio
Registe o motor e a versão da base de dados, as versões do broker e da bridge, os caminhos dos dispositivos USB, o estado do firmware de rádio, os endereços de rede, os nomes DNS e o estado de cada serviço complementar obrigatório. Verifique o espaço livre atual para as camadas da imagem, o trabalho de migração da base de dados, os registos e a cópia para reversão.
Um processo prático de atualização de contentores alerta para o facto de a migração do esquema da base de dados poder atrasar a disponibilidade da API e de reiniciar repetidamente poder interromper o progresso. A sequência em uma atualização do Docker com possibilidade de reversão permite definir um período de observação da migração antes de alterar a imagem em execução.
APROVADO significa que todas as dependências estão em bom estado, acessíveis, compatíveis com a versão de destino e incluídas no plano de reversão. REPROVADO significa que uma ligação de rádio é instável, uma base de dados já está em mau estado ou o espaço livre é escasso. Corrija primeiro a situação de base para não atribuir à atualização uma falha preexistente.
Analise as integrações personalizadas e os riscos da versão
Enumere as integrações personalizadas, os recursos da interface, os temas, as automatizações que chamam serviços obsoletos e os componentes complementares com versões fixas. Verifique se são mantidos e compatíveis com a versão de destino. Não desative nada por predefinição; identifique antes qual o componente opcional que pode ser isolado primeiro caso o arranque falhe.
Os utilizadores do Home Assistant que planeiam atualizar o Docker costumam verificar os passos de cópia de segurança e reversão antes de alterar uma versão em execução há muito tempo. Uma discussão sobre a preparação para atualizar um contentor ilustra por que motivo a imagem antiga e os dados persistentes devem continuar disponíveis em conjunto.
APROVADO significa que os riscos de compatibilidade conhecidos têm uma ordem de isolamento definida e que nenhum impede o controlo local essencial. REPROVADO significa que é necessário um componente personalizado sem manutenção e não testado. Adie a atualização, teste a imagem de destino numa cópia ou aceite um modo degradado documentado antes de agendar a indisponibilidade de produção.
Defina o critério de aprovação da atualização e o motivo para reverter
Registe a ordem exata de paragem, os passos para obter a imagem e recriar o contentor, os sinais de migração esperados, a lista de verificação de validação, o período máximo de indisponibilidade e o comando de reversão. Preserve o digest da imagem antiga e não altere manualmente os dados persistentes durante o período de observação do primeiro arranque. Escolha uma janela de manutenção em que esteja disponível o controlo manual local.
Use a lista de verificação para uma migração segura do ZimaSpace para incluir rádios, armazenamento, definições de rede, integrações e uma alternativa de contingência testada, para além do próprio contentor.
Avance apenas quando todas as verificações anteriores forem aprovadas. Após a atualização, verifique os registos, o Recorder, as integrações essenciais, uma automatização local, uma via remota, a criação de uma cópia de segurança e um segundo reinício. Reverta se os erros de migração se repetirem, se o controlo essencial exceder o limite de indisponibilidade ou se o novo contentor não conseguir reproduzir o funcionamento registado.
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...



