Lista de verificação pré-atualização para contentores do Home Assistant e dependências

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.

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

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.