호환되지 않는 릴리스 후 Home Assistant를 안전하게 롤백하는 방법

이전 Core 버전과 일치하는 업데이트 전 복구 지점으로 Home Assistant를 롤백하세요. 이전 런타임을 실행한다고 해서 최신 영구 상태 마이그레이션이 되돌려진다고 가정하지 마세요.

가장 안전한 롤백은 첫 번째 복구 시도 전에 시작됩니다. 업데이트 후 문제가 발생한 상태를 보존하고, 마지막으로 정상 작동한 버전과 백업을 확인한 다음, 호환성 문제가 Core, 사용자 지정 통합, 애드온 또는 외부 데이터베이스 중 어디에 있는지 판단하세요. 이전 런타임이 복원된 상태를 읽을 수 있고 기존 가정 내 기능이 다시 정상 작동할 때만 롤백이 성공한 것입니다. 버전 변경과 데이터 롤백은 서로 무관한 두 개의 버튼이 아니라 하나의 복구 작업입니다.

다운그레이드를 시도하기 전에 문제가 발생한 상태를 보존하세요

실험하는 동안 업데이트 후 구성의 유일한 사본을 덮어쓰지 마세요. 현재 구성, 로그, 버전 번호, 데이터베이스 위치, 그리고 정확히 어떤 기능이 고장 났는지를 저장하세요. 해당 사본에는 마지막 정상 백업 이후 적용된 새로운 변경 사항과 나중에 호환성 문제를 파악하는 데 필요한 증거가 포함될 수 있습니다.

2026년에 발생한 복원 회귀 문제는 겉보기에는 백업 복원이 성공한 것처럼 보여도 주변 Supervisor 동작에 문제가 있으면 런타임이 잘못된 버전으로 남을 수 있음을 보여 주었습니다. 백업 복원 및 Core 버전 롤백에 관한 보고서는 완료 메시지를 그대로 믿지 말고 복원 후 실제 버전을 확인해야 하는 이유를 잘 보여 줍니다.

복구 경로를 파악할 때까지 구성 변경을 중단하세요. 업데이트로 선택적인 사용자 지정 구성 요소 하나만 고장 났고 Home Assistant의 나머지 부분이 안정적이라면 전체 롤백보다 해당 구성 요소를 비활성화하는 편이 안전할 수 있습니다. Core를 시작할 수 없거나 데이터베이스를 불러오지 못하거나 중요한 자동화 기능을 사용할 수 없다면 런타임과 상태를 함께 복구하는 경로로 진행하세요.

호환되지 않는 릴리스 이전의 복구 지점을 선택하세요

이전 Home Assistant 버전이 정상적으로 실행되던 시점에 생성된 마지막 백업을 확인하세요. 해당 백업의 타임스탬프를, 잃어도 되는 중요한 자동화, 사용자, 대시보드 또는 기록 변경 사항과 비교하세요. 복구 지점 선택은 영구 상태를 과거 시점으로 되돌려 호환성을 복원하는 대신 일부 변경 사항을 잃을 수 있는 절충입니다.

ZimaSpace의 업데이트 전에 앱 데이터를 스냅샷하라는 안내는 같은 원칙을 예방 차원에서 설명한 것입니다. 새 소프트웨어가 운영 데이터에 처음 기록하기 전에 정상 작동이 확인된 상태 사본이 있으면 런타임 롤백을 가장 깔끔하게 수행할 수 있습니다.

신뢰할 수 있는 업데이트 전 백업이 없다면 이미 마이그레이션된 데이터베이스를 복사해 이전 Core 이미지와 조합하여 억지로 만들지 마세요. 현재 상태를 보존하고 정방향 수정 또는 통제된 재구축을 검토하세요. 호환되는 상태 사본이 없는 롤백은 하나의 호환성 문제를 Recorder, 기록 또는 레지스트리 오류로 확대할 수 있습니다.

런타임과 영구 상태를 한 쌍으로 복원하세요

Home Assistant OS 또는 관리형 설치 환경에서는 선택한 복구 지점과 해당 버전을 복원하는 지원 복원 경로를 사용하고, 의도한 Core 버전이 실제로 시작되는지 확인하세요. 컨테이너 설치에서는 최신 릴리스가 영구 데이터를 변경했다면 이미지 되돌리기만으로는 충분하지 않습니다. 이에 대응하는 업데이트 전 구성 사본도 함께 복원하세요.

Home Assistant Core의 2025.4에서 2025.3으로 다운그레이드하는 문제에 관한 이슈에서는 이전 런타임이 더 최신 데이터베이스 구조와 만났을 때 Recorder, 기록 및 관련 통합이 실패하는 현상이 문서화되었습니다. 유지 관리자는 롤백은 백업 복원에 의존한다고 명시했으며, 데이터베이스를 현재 위치에서 다운그레이드하는 경로는 제공되지 않는다고 설명했습니다.

Home Assistant 백업이 외부 데이터베이스를 관리하지 않는 경우에만 외부 데이터베이스와 종속 서비스를 호환되는 지점으로 복원하세요. 모든 컨테이너를 무작정 이전 버전으로 되돌리지 마세요. MQTT, 프록시 및 라디오는 정상일 수 있으므로 그대로 유지하고, 버전 또는 상태 계약이 실제로 변경된 구성 요소에 롤백을 집중하세요.

Featured

ZimaCube 2 개인용 클라우드 홈 NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

자동 업데이트를 다시 활성화하기 전에 원래 오류를 확인하세요

롤백 후 실행 중인 Core 버전, 로그인, Recorder/기록, 주요 통합, 자동화, 대시보드 및 각 핵심 프로토콜의 장치 하나를 확인하세요. 호환되지 않는 릴리스에서 실패했던 동작을 다시 수행하여 새로운 오류 없이 정상 작동하는지 확인하세요. 그런 다음 Home Assistant를 재시작하고 호스트도 한 번 재부팅하세요.

다음 릴리스 또는 수정 사항을 테스트할 때까지 문제가 발생한 상태의 사본과 업데이트 기록을 보관하세요. 사용자 지정 통합이 호환성 문제의 원인이었다면 다음 Core 업데이트 전에 지원되는 버전을 확인하세요. 롤백 자체가 실패한다면 동일한 변경 가능한 데이터베이스에 대해 버전을 반복해서 번갈아 적용하지 마세요. 깨끗한 복구 지점으로 돌아가거나 필요한 항목만 선택적으로 복원하는 재구축으로 전환하세요.

이전 버전과 복원된 상태가 일상적인 사용 및 재부팅 후에도 안정적으로 유지되고 원래 오류가 사라졌다면 통과입니다. 백업을 복원할 수 없거나 이전 런타임이 여전히 상태를 읽지 못하거나 중요한 데이터에 호환되는 복구 지점이 없다면 문제를 확대 처리하세요. 이 단계에서는 반복적인 다운그레이드 시도보다 통제된 정방향 수정 또는 재구축이 더 안전합니다.