Como saber se o Home Assistant está a utilizar o ficheiro de configuração esperado

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.

O Home Assistant está a usar o ficheiro de configuração esperado apenas quando o diretório de configuração indicado em tempo de execução, o caminho montado no anfitrião e um teste de validação controlado apontam todos para o mesmo ficheiro.

Esta confusão é comum quando /config existe dentro de um contentor, mas corresponde a um diretório diferente no anfitrião, ou quando uma montagem vinculada antiga e uma cópia editada recentemente contêm ambas configuration.yaml. Registe primeiro o caminho em tempo de execução, rastreie a respetiva montagem sem a alterar, compare a identidade e os carimbos de data/hora dos ficheiros e, em seguida, use um marcador inofensivo e reversível para confirmar que árvore de diretórios a instância em execução lê.

Registe o Diretório de Configuração Indicado pela Instância em Execução

Abra Informações do Sistema na instância do Home Assistant em execução e registe exatamente o diretório de configuração tal como é apresentado. Registe também o tipo de instalação, a versão do Core, o nome do contentor ou da VM e a hora do último reinício bem-sucedido. Isto estabelece a perspetiva em tempo de execução antes de os caminhos do anfitrião a complicarem.

As explicações da comunidade mostram porque /config pode referir-se a um caminho interno, enquanto o diretório correspondente no anfitrião varia consoante a instalação. A distinção útil é dentro ou fora do contentor, não uma localização universal no sistema de ficheiros.

Se o diretório indicado contiver o ficheiro que editou no mesmo espaço de nomes em tempo de execução, avance para a verificação do ficheiro. Caso contrário, pare de editar essa cópia. Se a interface não estiver disponível, inspecione o processo em execução ou os argumentos e as montagens do contentor, em vez de fazer suposições com base num tutorial antigo.

Rastreie o Caminho do Anfitrião através da Montagem Ativa

Inspecione o contentor em execução ou o serviço Compose e encontre a origem mapeada para o diretório de configuração em tempo de execução. Resolva os caminhos relativos a partir do diretório real do projeto Compose. Numa instalação de VM ou HAOS, distinga o caminho do sistema convidado do armazenamento visível para o hipervisor.

Um problema num projeto do Home Assistant documentou a confusão causada pela interface mostrar o caminho dentro do contentor, enquanto os dados reais do anfitrião HAOS estavam noutro local. Este caso do caminho no anfitrião versus no contentor ajuda a rastrear a montagem, não a copiar o caminho exato para outra instalação.

Compare a origem da montagem ativa com o diretório no seu editor ou partilha de ficheiros. Se forem diferentes, não os combine ainda. Preserve ambas as árvores, registe as respetivas datas de modificação e tamanhos e identifique aquela que contém o registo de entidades atual, as automatizações e a atividade recente nos registos.

Comprove a identidade do ficheiro com uma alteração controlada e segura

Antes de testar, execute a verificação da configuração no mesmo ambiente de execução e faça uma cópia de segurança da árvore ativa. Adicione um comentário inofensivo com um nome único, ou outro marcador reversível, ao ficheiro suspeito, guarde-o e confirme se o carimbo de data/hora muda no local para onde aponta a montagem em tempo de execução.

Siga o procedimento normal de validação da configuração e, se possível, recarregue apenas o domínio relevante que pode ser recarregado. Se for necessário reiniciar completamente, faça-o uma vez após a validação e inspecione o registo para verificar o ficheiro ou a integração que alterou. Reiniciar sem comprovar o caminho pode simplesmente voltar a carregar o ficheiro errado.

O artigo relacionado da ZimaSpace sobre o caminho dos dados do Home Assistant ajuda a distinguir o estado visível no frontend dos ficheiros de configuração e registo persistentes que lhe deram origem.

Corrigir a montagem e verificar a persistência

Se estiver montada a origem errada, pare o Home Assistant, preserve ambos os diretórios e corrija apenas a definição da montagem que recria o contentor. Confirme a propriedade e as permissões antes de iniciar. Não copie uma árvore mais antiga por cima de um estado mais recente, a menos que tenha escolhido explicitamente quais os dados a manter.

Após o arranque, volte a verificar o caminho de execução, a montagem, o carimbo de data/hora, a configuração e o ficheiro marcador. Um resultado positivo confirma que o ficheiro esperado é lido, que os registos atuais continuam presentes e que o mesmo mapeamento se mantém após a recriação do contentor ou o reinício do anfitrião.

Reverta para a montagem anterior se o Home Assistant arrancar vazio, perder integrações ou indicar erros de permissões. Se o mapeamento continuar ambíguo, peça ajuda indicando o tipo de instalação, o diretório de execução, a origem e o destino da montagem e uma listagem sanitizada do diretório; elimine árvores duplicadas apenas depois de confirmar a recuperação de forma independente.

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.