Home Assistant가 예상한 구성 파일을 사용하고 있는지 확인하는 방법

에바 왕

IceWhale author

에바 왕 는 기술 작가 그리고 이자 ZimaSpace의 상주 장인입니다. 평생을 기술에 열정을 가진 사람으로서 홈랩과 오픈소스 소프트웨어에 열정을 가지고 있으며,복잡한 기술 개념을 쉽게 이해할 수 있는 실습 가이드로 번역하는 데 전문성을 가지고 있습니다.에바는 셀프 호스팅이 어렵지 않고 재미있어야 한다고 믿습니다. 그녀의 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 신비를 풀도록돕고 있습니다. 첫 NAS 구축부터 Docker 컨테이너 마스터링까지.

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

Home Assistant가 예상한 구성 파일을 사용하는 것은 실행 시 보고된 구성 디렉터리, 마운트된 호스트 경로, 통제된 검증 테스트가 모두 동일한 파일을 가리킬 때뿐입니다.

이러한 혼동은 컨테이너 내부에 /config가 존재하지만 호스트의 다른 디렉터리에 매핑되어 있거나, 이전 바인드 마운트와 새로 편집한 복사본에 모두 configuration.yaml이 들어 있을 때 흔히 발생합니다. 먼저 실행 시 경로를 기록하고, 변경 없이 마운트를 추적한 다음, 파일의 식별 정보와 타임스탬프를 비교하고, 안전하고 되돌릴 수 있는 표시를 사용해 실행 중인 인스턴스가 어느 트리를 읽는지 확인하세요.

실행 중인 인스턴스에서 보고하는 구성 디렉터리 기록

실행 중인 Home Assistant 인스턴스에서 시스템 정보를 열고 표시된 구성 디렉터리를 정확히 기록하세요. 설치 유형, Core 버전, 컨테이너 또는 VM 이름, 마지막으로 성공한 재시작 시간도 기록하세요. 이렇게 하면 호스트 경로 때문에 혼란이 생기기 전에 실행 환경의 관점을 확립할 수 있습니다.

커뮤니티 설명을 보면 설치 방식에 따라 /config가 내부 경로를 가리키면서 해당 호스트 디렉터리는 달라질 수 있는 이유를 알 수 있습니다. 중요한 구분은 하나의 보편적인 파일 시스템 위치가 아니라 컨테이너 내부와 외부입니다.

보고된 디렉터리에 동일한 실행 네임스페이스 안에서 편집한 파일이 있으면 파일 확인을 계속하세요. 없다면 해당 복사본의 편집을 중단하세요. UI를 사용할 수 없다면 오래된 튜토리얼을 보고 추측하지 말고 실행 중인 프로세스 또는 컨테이너의 인수와 마운트를 확인하세요.

활성 마운트를 통해 호스트 경로 추적

실행 중인 컨테이너 또는 Compose 서비스를 검사하여 실행 시 구성 디렉터리에 매핑된 소스 경로를 찾으세요. 실제 Compose 프로젝트 디렉터리를 기준으로 상대 경로를 해석하세요. VM 또는 HAOS 설치에서는 게스트 경로와 하이퍼바이저에서 확인할 수 있는 스토리지를 구분하세요.

Home Assistant 프로젝트 이슈에는 UI에 컨테이너 내부 경로가 표시되지만 실제 HAOS 호스트 데이터는 다른 위치에 있었던 혼동 사례가 기록되어 있습니다. 이 호스트와 컨테이너 간 경로 사례는 다른 설치 환경에 정확히 같은 경로를 복사하기보다 마운트를 추적해야 한다는 점을 보여 줍니다.

활성 마운트 소스와 편집기 또는 파일 공유에서 사용하는 디렉터리를 비교하세요. 서로 다르면 아직 병합하지 마세요. 두 트리를 모두 보존하고 수정 시간과 크기를 기록한 다음, 현재 엔터티 레지스트리, 자동화, 최근 로그 활동이 어느 트리에 있는지 확인하세요.

안전하게 통제된 변경을 수행해 파일 동일성 확인

테스트하기 전에 동일한 실행 환경에서 구성 검사를 수행하고 활성 트리를 백업하세요. 의심되는 파일에 무해하고 고유한 주석 또는 되돌릴 수 있는 다른 표시를 추가하고 저장한 다음, 실행 시 마운트가 가리키는 위치에서 타임스탬프가 변경되는지 확인하세요.

일반적인 구성 검증 절차를 사용한 다음, 가능하면 관련된 다시 로드 가능한 도메인만 다시 로드하세요. 전체 재시작이 필요한 경우 검증 후 한 번만 재시작하고, 변경한 파일 또는 통합 구성 요소가 로그에 나타나는지 확인하세요. 경로를 확인하지 않은 재시작은 단순히 잘못된 파일을 다시 읽는 결과가 될 수 있습니다.

관련 ZimaSpace 문서인 Home Assistant의 데이터 경로는 화면에 표시되는 프런트엔드 상태와 이를 생성한 영구 구성 및 레지스트리 파일을 구분하는 데 도움이 됩니다.

-15% OFF

ZimaBoard 2 - 당신의 큰 아이디어를 위한 미니 홈 서버

Single board computer zimaboard2

마운트를 수정하고 지속성 확인

잘못된 소스가 마운트되어 있다면 Home Assistant를 중지하고 두 디렉터리를 모두 보존한 다음, 컨테이너를 다시 생성하는 마운트 정의만 수정하세요. 시작하기 전에 소유자와 권한을 확인하세요. 어떤 데이터가 우선할지 명시적으로 결정하지 않았다면 이전 트리로 최신 상태를 덮어쓰지 마세요.

시작한 후 실행 시 경로, 마운트, 타임스탬프, 구성 검사, 표시 테스트를 반복하세요. 통과 결과는 예상한 파일이 읽히고, 현재 레지스트리가 계속 존재하며, 동일한 매핑이 컨테이너 한 번의 재생성 또는 호스트 재시작 후에도 유지된다는 것을 입증합니다.

Home Assistant가 빈 상태로 시작하거나 통합 구성 요소를 잃거나 권한 오류를 보고하면 이전 마운트로 되돌리세요. 매핑이 여전히 불분명하면 설치 유형, 실행 시 디렉터리, 마운트 소스와 대상, 민감한 정보가 제거된 디렉터리 목록을 포함해 문제를 제기하세요. 중복 트리는 복구가 독립적으로 확인된 후에만 삭제하세요.