ユーザー、履歴、設定を失わずにHome Assistantのデータを移行する方法

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

完全なアプリケーション状態を保持してHome Assistantのデータを移行し、移行先が十分な検証に合格するまで、古いインスタンスには手を加えずに残してください。

ユーザーや設定は、目に見えるYAMLファイルだけではありません。また、ダッシュボードをコピーしても履歴は復元されません。移行時には、Home Assistantの設定ディレクトリまたは対応するバックアップ、履歴が必要な場合はRecorderデータベース、隠しストレージ、シークレット、カスタムコンポーネント、およびそれらに関連する実行環境固有のデバイスやネットワークのマッピングを保持する必要があります。最も安全な手順は、棚卸し、整合性のあるコピー、隔離環境での起動、検証の順に進め、その後で移行元を廃止することです。

移行前に永続データと外部依存関係を確認する

Containerインストールでは、よく知られたファイルをいくつか選ぶのではなく、マウントされたHome Assistantの設定ディレクトリ全体を復旧の基本単位として扱ってください。.storage内の隠し状態、認証データ、インテグレーションのレジストリ、ダッシュボード、自動化、デフォルトのRecorderデータベースは、いずれもそのパスの下に保存されている場合があります。外部のMariaDB、MQTT、Zigbeeゲートウェイ、シークレットストア、NASマウントは、別途一覧に記載する必要があります。

Home Assistantのコンテナ移行ガイドでは、ファイルごとに状態を再構築するよりも、設定ディレクトリ全体を移行するほうが安全である理由を説明し、ファイルシステムをそのままコピーする前に古いコンテナを停止することの重要性を強調しています。

移行元と移行先のパス、所有者のUID/GID、データベースの場所、USBまたはシリアルデバイス、ネットワークモード、公開ポート、外部サービス、現在のHome Assistantのバージョンを記載したマニフェストを作成してください。依存関係がひとつでも文書化されていない場合は、古いインスタンスを削除しないでください。新しいホストで、その依存関係を文書化された情報から再現できるようになるまで、移行の準備は整っていません。

データのコピー前に整合性のあるロールバックポイントを作成する

インストール環境が対応している場合は、組み込みのバックアップ機能か、アプリケーションの状態を考慮した別の方法を使ってください。Containerのデータをそのままコピーする場合は、稼働中の設定データベースと関連ファイルをコピーする前に、Home Assistantを停止してください。稼働中に単純コピーすると、アプリケーションのファイルを異なる時点で取得してしまう可能性があります。これは、制御された移行とは正反対です。

Home Assistantのバックアップ機能の刷新により、インストール方法をまたいだ復元に対応しました。そのため、対応するバックアップは実行環境を切り替える際の確かな移行手段となります。インストール方法をまたいだバックアップの復元から得られる実践的な教訓は、アプリケーションの状態を継続性の基準として保ちながら、新しい実行環境に切り替えられることです。

コピーを2つ用意します。1つは移行前の状態をそのまま保った復旧ポイント、もう1つは移行に使う作業用コピーです。唯一の正常なソースコピーを新しいHome Assistantインスタンスで起動しないでください。移行先で移行処理が行われたり、新しいレジストリ状態が書き込まれたりしても、旧バージョンと旧ホストに戻れるクリーンな手段を確保しておく必要があります。

ランタイム固有のハードウェアとネットワークのマッピングを別途再構築する

アプリケーションデータを復元しても、ホストのデバイスパスが自動的に再作成されるわけではありません。ZigbeeやZ-WaveのUSBコーディネーターは別のデバイス名で認識される場合があり、Bluetoothへのアクセス方法が変わったり、ホストネットワークの変更によってデバイス検出に影響が出たり、外部データベースやMQTTブローカーの接続先アドレスが変わったりすることがあります。インテグレーションが利用できないからといってデータ消失と判断する前に、これらの接続を明示的に再構築してください。

ContainerからHAOSへの独立した移行ガイドでは、Home Assistant Coreの状態を復元しても、MQTT、Zigbee2MQTT、Node-REDなどのサイドカーサービスは自動的に再作成されないことが示されています。また、サイドカーの再マッピングを含む移行手順では、Recorderの履歴の継続性、USBコーディネーターへのアクセス、ロールバック手段として旧スタックを停止したまま維持することも確認します。

管理されたLAN経由で移行先を起動し、意図的に分離していない限り、同じ無線機器、Webhook、クラウドアカウント、自動化を使う2つのインスタンスを同時に稼働させないでください。Home Assistantのインスタンスを2つ同時に動かすと、アクションが重複して実行されたり、同じコーディネーターを奪い合ったりして、データ移行が正しくても失敗したように見えることがあります。

切り替え前にユーザー、履歴、設定、デバイス制御を検証する

既存の非管理者アカウントでログインし、管理者アカウントを確認します。移行前の期間を含む過去のグラフを開き、インテグレーションを点検し、代表的な自動化を実行して、重要なプロトコルごとに1台のデバイスを確認します。その後、Home Assistantを再起動し、移行先ホストも再起動して、通常のライフサイクルイベント後も復旧した状態が維持されることを確かめます。

関連するZimaSpaceの解説Home Assistantの永続データの役割では、移行時に重要となる復旧範囲について説明しています。永続性のあるID、設定、履歴は、キャッシュや一時ファイルとは別に扱う必要があります。

ローカルテストに合格してから、DNS、プロキシ、またはリモートアクセスを切り替えてください。旧ホストの電源は切った状態で、通常の使用サイクルを少なくとも1回完了するまで復旧可能な状態にしておきます。ユーザー、履歴、設定、自動化、無線機器、外部サービス、バックアップの作成、再起動がすべて想定どおりに動作してから、旧ホストを撤去してください。最初にダッシュボードが表示されたというだけでは、ロールバック手段を消去する十分な根拠にはなりません。

サポートとヒント

続きを読む

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.