Como transferir os dados do Home Assistant sem perder utilizadores, histórico ou definições

Mova os dados do Home Assistant preservando o estado completo da aplicação e mantendo a instância antiga intacta até a substituta passar por uma validação completa.

Os utilizadores e as definições não estão apenas nos ficheiros YAML visíveis, e o histórico não é recriado copiando um painel. Uma migração deve preservar o diretório de configuração do Home Assistant ou uma cópia de segurança suportada, a base de dados do Recorder quando o histórico for importante, o armazenamento oculto, os segredos, os componentes personalizados e os mapeamentos de dispositivos e rede específicos do ambiente de execução associados. A sequência mais segura é inventário, cópia consistente, arranque isolado, validação e, só depois, desativação da origem.

Faça o inventário do estado persistente e das dependências externas antes da mudança

Numa instalação em Container, trate todo o diretório de configuração do Home Assistant montado como a unidade central de recuperação, em vez de selecionar apenas alguns ficheiros conhecidos. O estado oculto em .storage, os dados de autenticação, os registos das integrações, os painéis, as automações e a base de dados predefinida do Recorder podem estar todos nesse caminho. MariaDB externa, MQTT, gateways Zigbee, armazenamento de segredos ou montagens NAS devem ser listados separadamente.

Um guia de migração de contentores do Home Assistant mostra por que razão uma mudança de todo o diretório de configuração é mais segura do que reconstruir o estado ficheiro a ficheiro e salienta que o contentor antigo deve ser parado antes de uma cópia direta do sistema de ficheiros.

Crie um manifesto com o caminho de origem, o caminho de destino, o proprietário UID/GID, a localização da base de dados, os dispositivos USB ou série, o modo de rede, as portas publicadas, os serviços externos e a versão atual do Home Assistant. Se alguma dependência não estiver documentada, não elimine a instância antiga. A migração só está pronta quando o novo anfitrião conseguir reproduzir essa dependência com base em informação escrita.

Crie um ponto de reversão consistente antes de copiar os dados

Utilize a cópia de segurança integrada ou outro método compatível com a aplicação quando a sua instalação o suportar. Se estiver a efetuar uma cópia direta de um Container, pare o Home Assistant antes de copiar a base de dados de configuração ativa e os ficheiros relacionados. Uma cópia simples efetuada com o sistema em funcionamento pode capturar ficheiros da aplicação em momentos diferentes, o que é precisamente o oposto de uma migração controlada.

A reformulação das cópias de segurança do Home Assistant alargou o suporte à reposição entre métodos de instalação, tornando uma cópia de segurança suportada uma fronteira sólida de portabilidade ao mudar de ambiente de execução. A lição prática da reposição de cópias de segurança entre instalações é que o ambiente de execução pode mudar, enquanto o estado da aplicação continua a ser a fronteira de continuidade.

Guarde duas cópias: um ponto de recuperação pré-mudança intocado e uma cópia de trabalho utilizada na migração. Não permita que a nova instância do Home Assistant seja iniciada utilizando a única cópia de origem válida. Se o destino efetuar uma migração ou gravar novo estado dos registos, ainda terá de dispor de um caminho limpo de regresso à versão e ao anfitrião antigos.

Recrie separadamente os mapeamentos de hardware e rede específicos do ambiente de execução

Os dados da aplicação não recriam automaticamente os caminhos dos dispositivos no anfitrião. Os coordenadores USB Zigbee ou Z-Wave podem surgir com um nome de dispositivo diferente, o acesso Bluetooth pode variar, a rede do anfitrião pode alterar a descoberta e as bases de dados externas ou os brokers MQTT podem ser resolvidos através de endereços diferentes. Recrie explicitamente essas interfaces antes de interpretar uma integração indisponível como perda de dados.

Um guia independente sobre a migração de Container para HAOS mostra que a reposição do estado do Home Assistant Core não recria automaticamente serviços auxiliares como MQTT, Zigbee2MQTT ou Node-RED. A sua sequência de migração com remapeamento de serviços auxiliares verifica também a continuidade do histórico do Recorder, o acesso ao coordenador USB e uma pilha antiga parada, mas intacta, como caminho de reversão.

Inicie o destino numa rede local controlada e evite executar ambas as instâncias com os mesmos rádios, webhooks, contas na nuvem ou automações, salvo se as tiver isolado deliberadamente. Duas instâncias ativas do Home Assistant podem enviar ações duplicadas ou disputar o mesmo coordenador, fazendo com que uma migração de dados correta pareça estar avariada.

Featured

ZimaCube 2 NAS Pessoal Cloud para Casa

ZimaCube2

$799.00 - $2,499.00

Buy Now

Valide os utilizadores, o histórico, as definições e o controlo dos dispositivos antes da mudança

Inicie sessão com uma conta existente que não seja de administrador, confirme uma conta de administrador, abra gráficos históricos anteriores à mudança, inspecione as integrações, acione automações representativas e verifique um dispositivo de cada protocolo importante. Em seguida, reinicie o Home Assistant e reinicie o anfitrião de destino para provar que o estado recuperado sobrevive aos eventos normais do ciclo de vida.

A explicação relacionada da ZimaSpace sobre as funções dos dados persistentes do Home Assistant fornece uma fronteira de recuperação útil: a identidade, a configuração e o histórico duradouros devem ser tratados de forma diferente dos ficheiros de cache ou temporários durante uma mudança.

Altere o DNS, o proxy ou o acesso remoto apenas depois de os testes locais serem concluídos com êxito. Mantenha o anfitrião antigo desligado, mas recuperável, durante pelo menos um ciclo normal de utilização. Só o desative quando os utilizadores, o histórico, as definições, as automações, os rádios, os serviços externos, a criação de cópias de segurança e um reinício funcionarem conforme esperado; um primeiro carregamento bem-sucedido do painel não é prova suficiente para eliminar o caminho de reversão.