コンテナのアップデートに失敗した後、Home Assistantを復元する方法

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

Home Assistantコンテナのアップデートに失敗した場合、通常は新規インストールを作成する理由ではなく、実行環境を置き換える問題として扱うべきです。ホストにマウントされた /config ディレクトリが無事なら、その状態を保持し、ボリュームのマッピングを確認して、正常に動作することがわかっているイメージを起動し、古いバックアップを復元する前に既存のインストールをテストするのが最も安全な復旧方法です。

危険なのは、新しいコンテナを誤ったホストパス、または空のパスを使って起動することです。その場合、元の状態がディスク上の別の場所に残っているにもかかわらず、Home Assistant に設定が消えたかのような初期設定画面が表示されることがあります。まず変更を止め、正しい設定ディレクトリを特定してください。復旧したインスタンスの動作を確認するまでは、古いコンテナやディレクトリを削除しないでください。

新たな書き込みを止めて、実際の /config パスを特定する

失敗したコンテナを停止し、そのコンテナを作成した実行環境の定義を確認してください。ホスト上のどのディレクトリまたは名前付きボリュームが /config にマッピングされているかを確かめ、その場所に YAML ファイル、.storage、カスタムコンポーネント、シークレット、データベースがあるか確認してください。

Dockerのアップグレード後のコミュニティによる復旧事例では、「新規」のHome Assistantインスタンスが現れた原因は、実際にはコンテナが誤った設定フォルダを参照していたことでした。永続データは消去されておらず、置き換え後の実行環境が正しくマウントできていなかっただけでした。

所有者、パス、データベースファイルを変更する前に、現在の config ディレクトリをコピーまたはスナップショットしてください。一部が壊れた状態でも貴重な手がかりとなり、最後のバックアップより新しいオートメーションや認証情報が含まれていることがあります。

インストールを作り直さずに実行環境を再構築する

更新前に動作していたコンテナと同じネットワークモード、タイムゾーン、デバイスマッピング、USB無線機器へのアクセス権限、特権またはケイパビリティ、ホスト側の /config マウントを使用してください。イメージは置き換え可能です。サービスが同じ Home Assistant インスタンスとして復旧するかどうかは、これらの実行時設定と永続データによって決まります。

コンテナの永続性は、コンテナのファイルシステムではなく、ホスト側のマウントによって決まります。Home Assistant Container の例では、永続的なホストボリュームを /config に直接マウントします。そのため、ランタイムを再作成しても家庭内の設定は作り直されません。アップデート時にこのマッピングが変わると、置き換えたコンテナは初期状態に見えても、元の状態は別の場所に残っていることがあります。

古いコンテナのファイルシステムを新しいイメージにコピーしないでください。文書化された Compose または実行定義からデプロイメントを再作成し、永続状態を明示的に再接続します。

古い状態を復元する前にイメージをロールバックする

設定のマウントが正しいにもかかわらず、新しい Home Assistant バージョンが起動しない、または重要なインテグレーションが壊れる場合は、保持している同じ /config に対して、以前正常に動作していたイメージをテストしてください。これにより、「新しいランタイムが現在の状態と互換性がない」のか、「状態自体が破損している」のかを切り分けられます。

現在の Home Assistant Container のワークフローでは、イメージと永続状態が明確に分離されています。まずバックアップを取り、対象のイメージを取得してコンテナを再作成し、ダウングレードが必要な場合は特定の旧イメージタグを使用します。維持すべき復旧の境界はここです。権威ある設定パスを保持したまま、ランタイムを置き換えます。

ロールバックする際は、一部のアップグレードでデータ構造が移行されることを覚えておいてください。新しいバージョンでアップグレード済みの状態を古いバージョンで安全に読み取れない場合は、移行前に取得したバックアップを使用してください。永続データの唯一のコピーに対して、バージョンを何度も切り替えないでください。

現在の状態が信頼できない場合にのみバックアップを復元する

永続設定が欠落、破損、一部上書きされた場合や、安全に実行できるバージョンと互換性がなくなった場合は、バックアップを使用してください。可能であれば、分離された環境またはクリーンな移行先に復元し、復旧した状態と破損したコピーを比較できるようにします。

バックアップを開くための暗号化パスワードまたは緊急用キットは、故障したホストの外に保管してください。同じディスクにしか存在しないバックアップや、復号できないバックアップでは復旧できません。

Home Assistantの復旧をストレージホスト自体から切り離すZimaSpaceの例も、同じ原則を裏付けています。アプリケーションの状態には、稼働中のディスクをミラーリングするだけでなく、独立した復元手段が必要です。

削除する前に復旧したコンテナを検証する

  • 想定しているユーザー、ダッシュボード、インテグレーション、自動化、ヘルパー、エリアが揃っていることを確認してください。
  • Zigbee、Z-Wave、Bluetoothを使用している場合は、ローカル接続のデバイスパスと無線接続のデバイスパスをそれぞれ1つ確認してください。
  • Recorderでデータベースまたは移行のエラーを確認してください。
  • 復旧したコンテナを再起動し、同じ状態が戻ることを確認してください。
  • 2回目の起動が成功するまで、古いイメージタグ、設定のコピー、最後に正常動作したバックアップを保管してください。

元の設定を使って古いイメージが動作するなら、アップデートの失敗は主にランタイムまたはバージョンの問題です。同じ状態でどのイメージも失敗するなら、設定の修復またはバックアップの復元に進んでください。空の /config を使った場合に限り新しいコンテナが動作するなら、永続状態の何が復旧を妨げているのか把握するまで、新規セットアップを「修復済み」として受け入れないでください。

よくある質問

トラブルシューティングの前に、失敗したHome Assistantコンテナを削除すべきですか?

いいえ。まず停止し、実行時の定義とマウントされた設定パスを保持してください。失敗したコンテナを削除せずに新しいコンテナを作成できるため、新しいランタイムを検証する間もロールバックに必要な情報を残せます。

アップデート後にHome Assistantの初期設定画面が表示されるのはなぜですか?

最も一般的なコンテナ固有の原因は、新しいランタイムから元の /config パスが見えていないことです。設定が消去された、あるいは新しい状態に古いバックアップを復元したと決めつける前に、ホスト側のマウントを確認してください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.