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

Eva Wong

IceWhale author

Eva Wong é a Redatora Técnica e e entusiasta residente na ZimaSpace. Uma geek de longa data com paixão por homelabs e software de código aberto, ela é especialista em traduzir conceitos técnicos complexos em guias acessíveis e práticos . Eva acredita que o auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ela capacita a comunidade adesmistificar configurações de hardware , desde a construção do seu primeiro NAS até dominar os contêineres Docker., from building their first NAS to mastering Docker containers.

How to Tell Whether Home Assistant Is Using the Expected Configuration File

O Home Assistant está a utilizar apenas o ficheiro de configuração esperado quando o diretório de configuração indicado pelo runtime, o caminho do anfitrião montado 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 antiga e uma cópia editada recentemente contêm ambas configuration.yaml. Registe primeiro o caminho do runtime, rastreie a montagem sem a alterar, compare a identidade e os carimbos de data e hora dos ficheiros e, em seguida, utilize um marcador inofensivo e reversível para provar qual a árvore que a instância em execução lê.

Registar 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 apresentado. Registe também o tipo de instalação, a versão do Core, o nome do contentor ou da máquina virtual e a hora do último reinício bem-sucedido. Isto estabelece a perspetiva do runtime antes de os caminhos do anfitrião complicarem a análise.

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

Se o diretório indicado contiver o ficheiro que editou dentro do mesmo espaço de nomes do runtime, avance para a prova do ficheiro. Se não contiver, 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 tentar adivinhar com base num tutorial antigo.

Rastrear 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 do runtime. Resolva os caminhos relativos a partir do diretório real do projeto Compose. Numa instalação numa máquina virtual ou HAOS, distinga o caminho do convidado do armazenamento visível para o hipervisor.

Um problema do projeto Home Assistant documentou a confusão em que a interface apresentava o caminho dentro do contentor, enquanto os dados reais do anfitrião HAOS estavam noutro local. Esse caso de caminhos entre anfitrião e contentor reforça a necessidade de rastrear a montagem, em vez de copiar o respetivo 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 una ainda. Preserve ambas as árvores, registe as respetivas horas de modificação e tamanhos e identifique qual contém o registo de entidades atual, as automações e a atividade recente dos registos.

Provar a Identidade do Ficheiro com uma Alteração Controlada e Segura

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

Utilize o procedimento normal de validação da configuração e, quando possível, recarregue apenas o domínio relevante que suporte recarregamento. Se for necessário um reinício completo, reinicie uma vez após a validação e inspecione o registo à procura do ficheiro ou da integração que alterou. Um reinício sem prova do caminho pode simplesmente voltar a carregar o ficheiro errado.

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

-15% OFF

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

Single board computer zimaboard2

Corrigir a Montagem e Verificar a Persistência

Se a origem errada estiver montada, pare o Home Assistant, preserve ambos os diretórios e corrija apenas a definição de montagem que recria o contentor. Confirme o proprietário e as permissões antes de iniciar. Não copie uma árvore mais antiga sobre um estado mais recente sem ter escolhido explicitamente quais os dados que devem prevalecer.

Após o arranque, repita o caminho do runtime, a montagem, o carimbo de data e hora, a verificação da configuração e o teste do marcador. Um resultado bem-sucedido prova que o ficheiro esperado é lido, que os registos atuais permanecem presentes e que o mesmo mapeamento sobrevive à recriação de um contentor ou ao reinício do anfitrião.

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