종속 서비스에 문제가 발생해 주 서비스가 시작되지만 Home Assistant를 복구하는 방법

Home Assistant가 시작되지만 종속성이 실패하는 경우, 설치를 다시 구성하는 대신 사용할 수 없는 첫 번째 종속성을 식별할 수 있을 만큼 주 서비스를 계속 실행 상태로 유지하세요.

정상적으로 실행 중인 프로세스도 불완전한 시스템을 드러낼 수 있습니다. MQTT 엔티티를 사용할 수 없거나, 외부 데이터베이스 때문에 기록이 차단되거나, 마운트 누락으로 백업이 중단되거나, DNS 문제로 클라우드 및 로컬 엔드포인트를 확인하지 못할 수 있습니다. 가장 먼저 발생한 오류를 기록하고, Home Assistant 런타임에서 명시된 엔드포인트를 테스트한 다음, 종속 서비스부터 바깥쪽 순서로 복구하세요.

첫 번째 종속성 실패 식별

영향을 받은 통합 또는 서비스가 시작된 후 처음 발생한 오류를 기록하세요. 여기에는 종속성 이름, 엔드포인트, 예외 클래스, 재시도 간격, 타임스탬프가 포함되어야 합니다. 이후의 경고는 첫 연결, 인증, 마운트 또는 스키마 오류가 아니라 사용할 수 없는 엔티티나 설정 실패 같은 결과를 설명하는 경우가 많습니다.

기본적인 MQTT 사례는 통합을 구성하는 것과 실제로 브로커를 사용할 수 있는 것이 다르다는 점을 보여 줍니다. 해결된 브로커 사용 가능 여부의 구분은 필요한 서비스가 존재하지 않거나 실행 중이 아닐 때 클라이언트를 반복해서 변경하는 일을 막아 주므로 유용합니다.

모든 부차적 오류보다 먼저 하나의 종속성 이름이 나타난다면 해당 종속성을 복구 대상으로 삼으세요. 서로 관련 없는 여러 종속성이 동시에 실패한다면 각 통합을 개별적으로 복구하기 전에 공유 DNS, 네트워크, 스토리지 또는 자격 증명을 먼저 테스트하세요.

도달 가능성, 인증, 준비 상태를 순서대로 테스트

Home Assistant가 사용하는 동일한 컨테이너, VM 또는 호스트 네임스페이스에서 종속성 호스트 이름을 확인하고, 필요한 포트를 열고, 구성된 ID로 인증한 다음, 가능한 가장 간단한 읽기 전용 준비 상태 검사를 실행하세요. 호스트 측에서 연결된다고 해서 애플리케이션 네임스페이스나 자격 증명이 작동한다는 뜻은 아닙니다.

컨테이너 시작 순서는 애플리케이션 준비 상태와 같지 않습니다. 상태 확인으로 제어되는 종속성을 사용하면 준비되지 않은 데이터베이스나 브로커에 클라이언트가 연결을 시도하는 일을 방지할 수 있습니다. 시작 순서와 준비 상태의 차이는 실패 조건을 파악한 후에만 실제 상태 확인을 추가해야 한다는 점을 뒷받침합니다.

이름 확인에 실패하면 DNS 또는 서비스 이름을 수정하세요. 포트 연결에 실패하면 종속성 프로세스나 네트워크 경로를 복구하세요. 인증에 실패하면 값을 출력하지 않고 구성된 자격 증명의 출처를 비교하세요. 연결에는 성공했지만 준비 상태 검사에 실패하면 종속성 자체의 로그와 스토리지 상태를 확인하세요.

가장 개입이 적은 변경으로 종속성 복구

확인된 문제만 수정하세요. 누락된 마운트를 복구하거나, 브로커를 시작하거나, 데이터베이스 서비스를 복구하거나, 자격 증명 참조를 갱신하거나, 네트워크 별칭을 수정하면 됩니다. 먼저 종속성을 재시작하고 준비 상태 검사가 통과할 때까지 기다리세요. 클라이언트가 자동으로 다시 연결되지 않을 때만 Home Assistant를 한 번 재시작하세요.

핵심 서비스가 시작된 후에도 워커나 통합이 오프라인 상태로 남아 있다면 워커 준비 상태 문제 해결 절차를 사용하여 시작 지연과 지속적인 종속성 경계를 구분하세요.

종속성을 이전의 정상 상태로 되돌릴 수 없거나, 스키마 삭제, 데이터베이스 재생성 또는 자격 증명 노출이 필요한 경우 롤백하세요. 마지막으로 정상 작동이 확인된 구성을 복원하고, 더 개입적인 복구를 시도하기 전에 양쪽의 로그를 보존하세요.

-15% OFF

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

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

원래 기능 재현 및 중단 지점 정의

실패했던 정확한 기능을 다시 테스트하세요. 예를 들어 일회용 MQTT 값을 하나 게시하고 수신하거나, 최근 기록 범위를 불러오거나, 의도한 대상으로 테스트 백업을 생성하거나, 영향을 받은 자동화를 하나 실행합니다. 제어된 종속성 재시작 후에도 다시 반복하여 단순한 즉시 사용 가능 상태가 아니라 재연결이 확인되는지 점검하세요.

통과로 판단하려면 종속성 상태 확인, Home Assistant 통합 상태, 사용자에게 표시되는 기능이 모두 일치해야 합니다. 컨테이너가 실행 중이지만 엔티티를 사용할 수 없다면 복구된 것이 아닙니다. 쓰기가 실패하는데 대시보드만 정상으로 표시되어도 복구된 것이 아닙니다.

원래 기능이 두 번 통과하고 새로운 종속성 오류가 나타나지 않을 때 중단하세요. 서비스에 연결할 수 있지만 프로토콜 또는 스키마 협상이 계속 실패한다면 최초 예외, 엔드포인트 유형, 준비 상태 결과, 종속성 버전, 복구 단계를 포함하여 에스컬레이션하세요.

복구된 시작 계약 기록

어떤 구성 요소가 종속성을 관리하는지, 준비 상태 신호, 재시도 동작, 자격 증명 출처, 네트워크 이름, 스토리지 경로, 복구 순서를 문서화하세요. 다음 담당자는 장애를 다시 조사하지 않고도 프로세스 시작과 실제로 사용할 수 있는 서비스의 차이를 구분할 수 있어야 합니다.

유지 관리 시간 동안 계획된 종속성 재시작을 한 번 수행하고 Home Assistant가 기록된 범위 내에서 다시 연결되는지 확인하세요. 여전히 수동 개입이 필요하다면 종속성이 완전히 복원력 있는 상태라고 표시하지 말고 해당 제한 사항을 명시하세요.

모니터링이 종속성 실패와 기능 복구를 모두 감지할 수 있을 때만 장애를 종료하세요. 모니터링이 주 프로세스가 실행 중이라는 사실만 확인한다면 불완전한 시작 상태를 초래한 동일한 사각지대가 그대로 남습니다.