Quando deve reconstruir o Home Assistant em vez de o reparar?

Reconstrua o Home Assistant apenas quando o estado persistente atual já não for uma fonte de recuperação fiável e uma restauração conhecida como válida não conseguir repor a instalação em funcionamento. A maioria das falhas deve primeiro ser classificada como problema de execução, integração, configuração, base de dados, armazenamento ou rede, e corrigida na camada mais pequena possível.

Uma reinstalação não é automaticamente uma reconstrução. Substituir uma imagem de contentor pode deixar /config intacto, enquanto uma verdadeira reconstrução cria um novo estado da aplicação e implica restaurar ou recriar integrações, dispositivos, painéis, auxiliares e automatizações. Tome essa decisão com base no estado da configuração, não na frustração causada pelo sintoma atual.

Utilize Três Ações Diferentes: Reparar, Restaurar, Reconstruir

Reparar mantém a configuração atual e corrige o componente que falhou. Restaurar substitui um estado danificado ou incompatível por uma cópia de segurança conhecida como válida. Reconstruir começa com uma instalação limpa do Home Assistant e depois importa ou recria apenas o estado em que decidiu deliberadamente confiar.

Esta distinção evita que um problema do contentor ou do pacote se transforme numa perda de dados desnecessária. Se os utilizadores, áreas, dispositivos e automatizações atuais ainda estiverem presentes, uma instalação nova pode destruir mais informação válida do que aquela que consegue reparar.

Anote qual das três ações está a executar antes de alterar ficheiros. Esta simples indicação torna mais difícil passar acidentalmente de uma reparação para uma reposição destrutiva.

Repare Primeiro Quando o Estado Persistente Ainda É Coerente

A reparação é adequada quando o Home Assistant abre a instância esperada, o diretório de configuração está preenchido e o erro pode ser associado a uma integração específica, alteração de YAML, componente personalizado, ficheiro de base de dados, montagem ou definição de execução.

O Modo de Segurança e o Modo de Recuperação existem precisamente porque muitas falhas de arranque podem ser isoladas sem abandonar a configuração. Um guia de recuperação atual recomenda ler o erro exato de arranque, utilizar o Modo de Segurança para isolar código personalizado e utilizar o Modo de Recuperação como caminho mínimo de reparação antes de reconstruir.

Desative ou atualize uma integração personalizada, corrija uma entrada de configuração inválida, repare o caminho de armazenamento ou reverta a versão de execução e, em seguida, volte a testar. Não reponha toda a instalação enquanto a falha estiver circunscrita.

Repare a Base de Dados Apenas Se Valer a Pena Guardar o Histórico

A corrupção do Recorder pode parecer grave porque os registos ficam cheios de erros da base de dados, mas a base de dados do Recorder não é o mesmo que a configuração completa do Home Assistant. Se a configuração e as integrações atuais estiverem intactas, uma nova base de dados de histórico pode, por vezes, ser menos arriscada do que uma reconstrução completa da aplicação.

Quando o histórico é importante, um guia prático de recuperação demonstra como parar o Home Assistant e utilizar as ferramentas de recuperação do SQLite para reconstruir uma base de dados danificada do Home Assistant num novo ficheiro.

Trabalhe apenas com cópias, preserve a base de dados original corrompida e aceite que a recuperação pode ser parcial. Uma reparação falhada do histórico não deve tornar-se motivo para eliminar automatizações e integrações saudáveis.

-15% OFF

ZimaBoard 2 - Mini Servidor Doméstico para a Sua Grande Ideia

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Restaure Quando uma Cópia de Segurança Válida For Mais Segura do Que Continuar a Reparar

Restaure quando a falha tiver começado após uma atualização ou edição identificável e tiver uma cópia de segurança testada anterior a essa alteração. Muitas vezes, isto é mais rápido e seguro do que reverter manualmente dezenas de ficheiros migrados ou parcialmente alterados.

Um guia de restauração do Home Assistant, utilizado há muito tempo, recomenda corrigir primeiro a causa da falha e depois restaurar uma cópia de segurança copiada para fora do sistema que falhou. Restaurar sem remover a fonte de alimentação com problemas, o problema do disco, a montagem incorreta ou o ambiente de execução incompatível limita-se a recriar o incidente.

Mantenha o estado danificado até o sistema restaurado passar nos testes. Pode conter automatizações, segredos ou alterações de configuração recentes que precisam de ser comparados ou recuperados seletivamente.

Reconstrua Quando o Estado e os Elementos de Recuperação Já Não Forem Fiáveis

Uma reconstrução limpa torna-se razoável quando o diretório de configuração está em falta ou extensivamente corrompido, várias cópias de segurança falham os testes de restauração, a definição do ambiente de execução é desconhecida ou as reparações repetidas deixam a instalação num estado não documentado que não pode ser reproduzido.

A reconstrução também pode ser a opção mais limpa ao abandonar uma implementação mal estruturada — por exemplo, quando uma configuração importante está presa dentro de um contentor descartável — desde que exporte primeiro todos os elementos de estado fiáveis que conseguir.

O guia de automação local da ZimaSpace salienta a capacidade de recuperação como um requisito essencial de uma plataforma doméstica inteligente. Uma reconstrução só é bem-sucedida quando a nova instalação é mais fácil de salvaguardar, restaurar e operar do que o estado abandonado.

Utilize uma Tabela de Decisão Antes de Eliminar o Estado Antigo

Não elimine a configuração antiga, a base de dados ou o conjunto de cópias de segurança até o caminho escolhido ter sobrevivido a um reinício e a um ciclo normal de utilização doméstica.

Perguntas Frequentes

Reinstalar o contentor do Home Assistant conta como uma reconstrução?

Não. Se o contentor substituto voltar a ligar-se ao mesmo diretório persistente /config, substituiu o ambiente de execução, mantendo o mesmo estado da instalação. Uma reconstrução começa com um estado novo ou abandona deliberadamente o estado antigo.

Devo reconstruir o Home Assistant porque a base de dados do Recorder está corrompida?

Normalmente, não. O histórico do Recorder pode ser reparado, restaurado ou substituído separadamente do resto do Home Assistant. Reconstrua toda a instalação apenas quando a configuração e o estado de recuperação — e não apenas o histórico — já não forem fiáveis.