互換性のないリリース後にHome Assistantを安全にロールバックする方法

エヴァ・ウォン

IceWhale author

エヴァ・ウォン は テクニカルライター であり ZimaSpaceの常駐ティンカーでもあります。 生涯のオタクであり、 ホームラボとオープンソースソフトウェアに情熱を持っています。彼女は複雑な技術的概念をわかりやすく、 実践的なガイドに翻訳することを専門としています。エヴァはセルフホスティングは楽しくあるべきで、怖がるものではないと信じています。彼女のチュートリアルを通じて、コミュニティが ハードウェアのセットアップを解明する手助けをしています。初めてのNAS構築からDockerコンテナの習得まで。

How to Roll Back Home Assistant Safely After an Incompatible Release - Zima Store Online

古い Core バージョンに一致する更新前の復旧ポイントを使って Home Assistant をロールバックします。古いランタイムを起動すれば、新しい永続状態の移行が元に戻ると考えてはいけません。

最も安全なロールバックは、最初の修復を試みる前から始まります。更新後に失敗した状態を保持し、最後に正常だったバージョンとバックアップを特定し、互換性の問題が Core、カスタム統合、アドオン、外部データベースのどれにあるのかを判断します。以前のランタイムで復元した状態を読み取ることができ、元の家庭内の機能が再び正常に動作して初めて、ロールバックは成功したといえます。バージョン変更とデータのロールバックは、別々のボタンによる無関係な操作ではなく、1つの復旧作業です。

ダウングレードを試す前に失敗した状態を保持する

試行錯誤の最中に、更新後の設定の唯一のコピーを上書きしないでください。現在の設定、ログ、バージョン番号、データベースの場所、そして壊れた機能の正確な内容を保存します。そのコピーには、最後に正常だったバックアップ以降に加えられた新しい変更や、後で互換性の問題を理解するために必要な証拠が含まれている可能性があります。

2026年の復元に関する回帰問題では、バックアップの復元が一見成功していても、周辺の Supervisor の動作に問題があると、ランタイムが誤ったバージョンのままになる可能性が示されました。バックアップの復元と Core バージョンのロールバックに関する報告は、完了メッセージを信頼するのではなく、復元後に実際のバージョンを確認する重要な理由になります。

復旧方法が明確になるまで、設定の変更を続けないでください。更新によって任意のカスタムコンポーネント1つだけが壊れ、Home Assistant のその他の部分が安定している場合は、完全なロールバックよりも、そのコンポーネントを無効にするほうが安全な場合があります。Core を起動できない、データベースの読み込みに失敗する、または重要な自動化が使用できない場合は、ランタイムと状態を組み合わせた復旧手順に進みます。

互換性のないリリースより前の復旧ポイントを選ぶ

古い Home Assistant バージョンが正常に動作していたときに取得した、最後のバックアップを特定します。重要な自動化、ユーザー、ダッシュボード、履歴の変更のうち、失ってもよいものについて、そのバックアップのタイムスタンプと照合してください。復旧ポイントの選択は、永続状態を過去の時点に戻すことで互換性を回復するというトレードオフです。

ZimaSpace の更新前にアプリデータをスナップショットするという指針は、同じルールを事前に実践するものです。新しいソフトウェアが本番データに初めて書き込む前の、正常性が確認された状態のコピーがあれば、ランタイムのロールバックを最もクリーンに行えます。

信頼できる更新前のバックアップがない場合は、すでに移行されたデータベースをコピーし、それを古い Core イメージと組み合わせてバックアップを作ったことにしないでください。現在の状態を保持し、前方修正または管理された再構築を検討します。互換性のある状態のコピーがないロールバックは、1つの互換性のない機能を Recorder、履歴、レジストリの障害へと拡大させる可能性があります。

ランタイムと永続状態を対応するペアとして復元する

Home Assistant OS または管理対象のインストールでは、選択した復旧ポイントを復元するサポート対象の復元手順を使用し、意図した Core バージョンが実際に起動することを確認します。コンテナインストールでは、新しいリリースによって永続データが変更されている場合、イメージを戻すだけでは不十分です。対応する更新前の設定コピーも復元してください。

2025.4 から 2025.3 へのダウングレードに関する Home Assistant Core の問題では、古いランタイムが新しいデータベース構造に接続すると、Recorder、履歴、関連する統合が失敗することが記録されています。メンテナーの回答では、ロールバックにはバックアップの復元が必要であり、データベースをインプレースでダウングレードする方法ではないことが明確に示されています。

外部データベースや依存サービスについては、Home Assistant のバックアップがそれらを管理していない場合に限り、互換性のある時点まで復元します。すべてのコンテナを無条件に以前の状態へ戻さないでください。MQTT、プロキシ、無線機器は正常で変更する必要がない場合があります。実際にバージョンまたは状態の契約が変わったコンポーネントにロールバックの対象を絞ります。

Featured

ZimaCube 2 パーソナルクラウドホームNAS

ZimaCube2

自動更新を再び有効にする前に元の障害を検証する

ロールバック後、実行中の Core バージョン、ログイン、Recorder と履歴、主要な統合、自動化、ダッシュボード、重要なプロトコルごとに1台のデバイスを確認します。互換性のないリリースで失敗した操作をもう一度実行し、新たなエラーなしで正常に動作することを確認します。その後、Home Assistant を再起動し、ホストも1度再起動します。

次のリリースまたは修正をテストするまで、失敗した状態のコピーと更新に関するメモを保持してください。カスタム統合が互換性の問題を引き起こした場合は、次回の Core 更新前に、その統合が対応しているバージョンを確認します。ロールバック自体に失敗した場合は、同じ変更可能なデータベースに対してバージョンを繰り返し切り替えないでください。クリーンな復旧ポイントに戻るか、選択的な復元を伴う再構築に移行します。

通常の使用と再起動を通じて、古いバージョンと復元した状態が安定し、元の障害が解消されていれば合格です。バックアップを復元できない、古いランタイムが依然として状態を読み取れない、または重要なデータに互換性のある復旧ポイントがない場合は、エスカレーションします。その段階では、ダウングレードを繰り返すよりも、管理された前方修正または再構築のほうが安全です。