Como impedir que as cópias de segurança do Home Assistant capturem um estado inconsistente da base de dados

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.

Evite cópias de segurança inconsistentes do Home Assistant deixando a aplicação coordenar o estado da base de dados em funcionamento ou interrompendo as escritas antes de fazer uma cópia direta do sistema de ficheiros.

O caso de risco não é simplesmente «fazer uma cópia de segurança enquanto o Home Assistant está ligado»; é usar um método de cópia que capta ficheiros relacionados da base de dados e da aplicação em momentos diferentes, sem conhecer o estado das transações. As cópias de segurança integradas podem coordenar os componentes do Home Assistant, mas uma ferramenta genérica de rsync ou de snapshots pode não o fazer. Defina qual é o mecanismo responsável pela consistência, evite tarefas concorrentes que sobrecarreguem a base de dados, mantenha a cópia de segurança anterior em boas condições e comprove cada política através de um restauro isolado.

Não trate uma base de dados SQLite em funcionamento como um ficheiro estático comum

O Recorder do Home Assistant pode estar a escrever enquanto um processo genérico de cópia de segurança copia o diretório de configuração. Com SQLite, o estado confirmado pode envolver a base de dados principal e os ficheiros de journal ou WAL, pelo que capturar momentos diferentes pode criar uma cópia incompleta ou irrecuperável, mesmo que todos os nomes de ficheiro estejam no arquivo.

Um teste de cópia de segurança de SQLite em funcionamento mostrou que copiar apenas o ficheiro principal da base de dados podia omitir silenciosamente linhas confirmadas que ainda estavam no WAL, mesmo que a base de dados copiada passasse uma verificação de integridade. Esta falha de cópia com WAL é o motivo pelo qual uma cópia direta do ficheiro deve usar um snapshot compatível com a base de dados ou ocorrer apenas depois de a base de dados ter sido corretamente colocada em repouso.

Isto não significa que o Home Assistant tenha de ser sempre encerrado para fazer cópias de segurança. Significa que o mecanismo de cópia de segurança tem de saber criar um ponto de recuperação coerente. Use a cópia de segurança integrada do Home Assistant para uma instalação em execução; reserve as cópias do sistema de ficheiros com o sistema parado para migrações, arquivo offline ou ferramentas externas sem integração com reconhecimento da aplicação.

Evite tarefas de cópia de segurança ou manutenção concorrentes no mesmo período

Mesmo uma cópia de segurança com reconhecimento da aplicação pode não conseguir preparar a base de dados se outro processo mantiver bloqueios ou se o caminho de armazenamento estiver sujeito a uma pressão de manutenção invulgar. Não agende uma segunda cópia de segurança de um complemento, manutenção da base de dados, snapshot do NAS e cópia de segurança do Home Assistant para começarem todos no mesmo minuto apenas porque a casa está tranquila.

As falhas reais de cópias de segurança do Home Assistant incluem erros de preparação devido ao bloqueio da base de dados, e um utilizador identificou um conflito com outro complemento de cópias de segurança. É um sinal de prevenção: as ferramentas que se sobrepõem devem ser separadas, e o registo da aplicação deve confirmar que a fase de pré-cópia de segurança foi concluída.

Espace as janelas de manutenção e registe a duração prevista. Se uma cópia de segurança ficar regularmente à espera do Recorder, identifique primeiro o responsável pelo bloqueio ou o problema de estado da base de dados. Não aumente os tempos limite às cegas nem execute mais cópias em paralelo; mais tarefas de cópia de segurança podem agravar precisamente a contenção que está a tentar evitar.

Para cópias brutas do sistema de ficheiros, suspenda as operações do Home Assistant e preserve todo o conjunto de estado

Se a sua política exigir uma cópia direta do diretório de configuração, pare o Home Assistant de forma limpa antes de o copiar, confirme que o processo já não está a escrever e copie todo o estado necessário, em vez de selecionar apenas o ficheiro principal da base de dados. Faça as cópias de segurança de bases de dados externas segundo o respetivo método de consistência.

A comparação existente da ZimaSpace entre a cópia de segurança do Home Assistant em funcionamento e com o serviço parado traça a mesma distinção: a cópia de segurança em funcionamento, com reconhecimento da aplicação, e a cópia bruta do sistema de ficheiros são procedimentos diferentes e não devem ser combinados numa única regra.

Após a cópia, reinicie o serviço e verifique o funcionamento normal do Recorder. Se o destino da cópia de segurança for um armazenamento de rede, verifique também se o conjunto de ficheiros ficou concluído antes de o ponto de montagem de rede ser removido. Uma cópia parada interrompida a meio só é consistente no sentido restrito de que a origem estava inativa; continua a não ser um ponto de recuperação completo.

Confie na cópia de segurança apenas depois de um restauro isolado ser concluído com êxito

Crie uma instância temporária do Home Assistant ou um destino de recuperação e restaure a cópia de segurança candidata sem recorrer a ficheiros mutáveis da produção. Verifique os utilizadores existentes, os dados históricos, os painéis, as integrações, as definições de automatização e, pelo menos, um reinício. Registe o tempo de restauro e quaisquer correções manuais necessárias para tornar a instância utilizável.

Uma regressão do Home Assistant Core, específica da versão 2026.7.2, fez com que o Recorder falhasse o checkpoint WAL na fase anterior à cópia de segurança. Em seguida, o gestor de cópias de segurança excedeu o tempo limite enquanto aguardava pelo bloqueio da base de dados. Este sinal de falha na fase anterior à cópia de segurança deve ser tratado apenas como prova relativa a esse percurso afetado e como indicação de um ponto de recuperação falhado, não como prova de que todos os tempos limite de bloqueio têm a mesma causa.

A política é cumprida apenas quando um único mecanismo de cópia de segurança assegura a consistência de cada vez, a fase de preparação da base de dados é concluída, a cópia anterior comprovadamente funcional é mantida e um restauro recupera os utilizadores, o histórico, as definições e o funcionamento normal após o reinício. Se o teste de restauro falhar, preserve as provas e crie uma nova cópia de segurança suportada ou uma cópia controlada com o serviço parado antes de eliminar pontos de recuperação mais antigos.

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.