Como restaurar o Home Assistant após uma atualização falhada do contentor

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.

Uma atualização falhada do contentor do Home Assistant deve, em geral, ser tratada como um problema de substituição do ambiente de execução, não como motivo para criar uma nova instalação. Se o diretório de anfitrião montado em /config estiver intacto, a forma mais segura de recuperar é preservar esse estado, verificar o mapeamento do volume, iniciar uma imagem fiável e testar a instalação existente antes de restaurar uma cópia de segurança mais antiga.

O passo perigoso é deixar um novo contentor arrancar com um caminho de anfitrião errado ou vazio. O Home Assistant poderá então apresentar o processo de integração inicial como se a configuração tivesse desaparecido, embora o estado original ainda exista noutro local do disco. Primeiro, impeça alterações, identifique o diretório de configuração de referência e não elimine o contentor ou diretório antigo até a instância recuperada ter sido testada com sucesso.

Impeça novas gravações e encontre o caminho real de /config

Pare o contentor com falhas e inspecione a definição de execução que o criou. Confirme que diretório de anfitrião ou volume com nome está mapeado para /config e, em seguida, inspecione essa localização para encontrar os seus ficheiros YAML, .storage, componentes personalizados, segredos e base de dados.

Um caso de recuperação da comunidade após uma atualização do Docker revelou que uma instância “novinha em folha” do Home Assistant se devia, na verdade, a o contentor estar a apontar para a pasta de configuração errada. Os dados persistentes não tinham sido apagados; simplesmente, o ambiente de execução de substituição não os estava a montar corretamente.

Copie ou crie uma captura do diretório de configuração atual antes de alterar permissões, caminhos ou ficheiros da base de dados. Mesmo um estado parcialmente danificado é uma pista valiosa e pode conter automatizações ou credenciais mais recentes do que a última cópia de segurança.

Recrie o ambiente de execução sem recriar a instalação

Utilize o mesmo modo de rede, fuso horário, mapeamentos de dispositivos, acesso a rádio USB, privilégios ou capacidades e montagem de anfitrião /config que o contentor funcional utilizava antes da atualização. A imagem pode ser substituída; são essas definições de execução e os dados persistentes que determinam se o serviço regressa como a mesma instância do Home Assistant.

A persistência do contentor depende da montagem no anfitrião, não do sistema de ficheiros do contentor. Um exemplo de Home Assistant Container monta um volume persistente do anfitrião diretamente em /config, pelo que recriar o ambiente de execução não recria a configuração da casa. Se esse mapeamento mudar durante uma atualização, um contentor de substituição pode parecer novo, enquanto o estado original continua a existir noutro local.

Não copie o sistema de ficheiros do contentor antigo para a imagem nova. Recrie a implementação a partir de uma definição Compose ou run documentada e volte a ligar explicitamente o estado persistente.

Reverta a imagem antes de restaurar um estado anterior

Se a montagem da configuração estiver correta, mas a nova versão do Home Assistant não iniciar ou deixar de funcionar uma integração crítica, teste a imagem anterior que se sabe estar funcional com o mesmo /config preservado. Assim, pode distinguir entre «ambiente de execução novo incompatível com o estado atual» e «estado danificado».

O fluxo de trabalho atual do Home Assistant Container separa explicitamente a imagem do estado persistente: faça primeiro uma cópia de segurança, transfira a imagem pretendida, recrie o contentor e utilize uma etiqueta de imagem específica de uma versão anterior quando for necessário fazer uma reversão. Esse é o limite de recuperação a preservar: substitua o ambiente de execução mantendo intacto o caminho de configuração autoritativo.

Ao reverter para uma versão anterior, lembre-se de que algumas atualizações migram estruturas de dados. Utilize uma cópia de segurança feita antes da migração se a versão anterior não conseguir ler com segurança o estado já atualizado pela versão mais recente. Não alterne repetidamente entre versões usando a única cópia dos dados persistentes.

Restaure uma cópia de segurança apenas quando o estado atual não for fiável

Utilize uma cópia de segurança quando a configuração persistente estiver em falta, corrompida, parcialmente substituída ou já não for compatível com a versão que consegue executar em segurança. Sempre que possível, restaure para um destino isolado ou limpo, para poder comparar o estado recuperado com a cópia danificada.

Mantenha a palavra-passe de encriptação ou o kit de emergência necessário para abrir a cópia de segurança fora do anfitrião que falhou. Uma cópia de segurança que só exista no mesmo disco ou que não possa ser desencriptada não permite recuperar os dados.

O exemplo da ZimaSpace de separar a recuperação do Home Assistant do próprio anfitrião de armazenamento reforça a mesma regra: os dados da aplicação precisam de um caminho de restauro independente, não apenas de um disco ativo espelhado.

Valide o Contentor Recuperado Antes de Eliminar Qualquer Elemento

  • Confirme que os utilizadores, painéis, integrações, automatizações, auxiliares e áreas esperados estão presentes.
  • Verifique o caminho de um dispositivo local e o de um dispositivo sem fios, caso utilize Zigbee, Z-Wave ou Bluetooth.
  • Verifique se há erros de base de dados ou de migração no Recorder.
  • Reinicie o contentor recuperado e confirme que o mesmo estado é restaurado.
  • Mantenha a etiqueta da imagem antiga, uma cópia da configuração e a última cópia de segurança conhecida como funcional até esta segunda inicialização ser concluída com êxito.

Se a imagem antiga funcionar com a configuração original, a atualização falhada deveu-se sobretudo a um problema do ambiente de execução/versão. Se todas as imagens falharem com o mesmo estado, avance para a reparação da configuração ou o restauro de uma cópia de segurança. Se um contentor novo só funcionar com um /config vazio, não considere a nova configuração como «resolvida» até perceber o que impede a recuperação no estado persistente.

Perguntas frequentes

Devo eliminar o contentor do Home Assistant que falhou antes de investigar o problema?

Não. Pare primeiro o contentor e preserve a respetiva definição de execução e o caminho da configuração montada. Pode criar um contentor de substituição sem eliminar o que falhou, mantendo disponíveis as informações necessárias para reverter enquanto confirma o novo ambiente de execução.

Porque é que o Home Assistant apresenta o ecrã de configuração inicial após uma atualização?

A razão mais comum, específica dos contentores, é o novo ambiente de execução não encontrar o caminho original /config. Verifique a montagem no anfitrião antes de concluir que a configuração foi apagada ou de restaurar uma cópia de segurança antiga por cima de um estado mais recente.

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.