Home Assistantコンテナと依存関係のアップグレード前チェックリスト
Home Assistantコンテナをアップグレードする前に、稼働中コンテナの契約情報を取得し、コンテナ外のバックアップを検証し、依存関係の準備状況を確認し、テスト済みのロールバック用イメージを保持します。
永続化された設定はコンテナの再作成後も残る可能性がありますが、USB無線ドングル、データベースサービス、ネットワークモード、シークレット、カスタムインテグレーション、補助コンテナは残らないことがあります。チェックリストは一般的なCompose例ではなく、現在の正確なデプロイメントから作成してください。バックアップをコンテナ外で確認でき、必要な空き容量を確保し、以前のイメージ参照を復元できるようになるまで、イメージの取得や再起動を行わないでください。
稼働中コンテナの契約情報を記録する
Home Assistantイメージの正確なダイジェストまたはバージョン、コンテナ引数、ネットワークモード、公開ポート、環境変数、再起動ポリシー、タイムゾーン、セキュリティオプション、ヘルスチェック、マウントパス、デバイスマッピングを記録します。現在のComposeまたはオーケストレーション定義をエクスポートし、稼働中のコンテナと比較して差分を確認します。
コンテナの移行では、目に見える設定ディレクトリ以外にも依存することがよくあります。Home Assistant OSからコンテナへ移行した事例では、別個のZigbee2MQTT、ブローカー、スタック定義が取り上げられており、完全なコンテナスタックを棚卸しする必要性が分かります。
PASSとは、別の管理者が記録だけを使い、推測せずに現在のコンテナを再作成できる状態です。FAILとは、マウント、デバイス、シークレット、またはコマンドが実行時の状態にしか存在しない状態です。アップグレード前にデプロイメントファイルを調整してください。そうしないと、ロールバック時に異なる環境が再作成される可能性があります。
コンテナ外のバックアップを検証する
予定しているバックアップを作成し、コンテナのファイルシステム外、できれば同じホストの障害ドメイン外へコピーまたは保存し、タイムスタンプとサイズを記録します。永続化された設定、非表示のストレージ記録、復元に必要なシークレット、選択したアーキテクチャで必要となる外部データベースのバックアップが含まれていることを確認します。
Dockerの復元に関する議論では、バックアップをコンテナ外に保管し、古いインスタンスを削除する前に最新のバックアップをコピーすることが明確に推奨されています。このコンテナ外バックアップの原則により、コンテナの置き換えで唯一の復旧用コピーが削除されるのを防げます。
PASSとは、復旧環境からファイルを読み取ることができ、内容またはテスト復元が検証済みである状態です。FAILとは、バックアップが変更対象のボリューム内にしか存在しない、または文書化されていない認証情報に依存している状態です。復旧が新しいコンテナから独立するまで、アップグレードを中止してください。
データベース、ストレージ、無線依存関係を確認する
データベースエンジンとバージョン、ブローカーとブリッジのバージョン、USBデバイスパス、無線ファームウェアの状態、ネットワークアドレス、DNS名、必要な各補助サービスの健全性を記録します。イメージレイヤー、データベース移行処理、ログ、ロールバック用コピーに必要な現在の空き容量を確認します。
実用的なコンテナ更新手順では、データベーススキーマの移行によってAPIの準備完了が遅れる可能性や、再起動を繰り返すと処理が中断される可能性が警告されています。ロールバックを考慮したDocker更新の手順では、稼働中のイメージに触れる前に移行の観察期間を定義することが推奨されています。
PASSとは、すべての依存関係が正常で、到達可能で、対象リリースと互換性があり、ロールバック計画に含まれている状態です。FAILとは、無線経路が不安定、データベースがすでに不健全、または空き容量に余裕がない状態です。アップグレード前から存在する障害をアップグレードのせいにしないため、まずベースラインを修復してください。
カスタムインテグレーションとリリースのリスクを確認する
カスタムインテグレーション、フロントエンドリソース、非推奨サービスを呼び出すオートメーション、バージョン固定された補助コンポーネントを一覧にします。保守状況と対象バージョンとの互換性を確認します。原則として何も無効化せず、起動に失敗した場合に最初に分離できるオプションコンポーネントを特定してください。
Dockerのアップグレードを計画するHome Assistantユーザーは、長期間稼働しているバージョンを変更する前に、バックアップとロールバックの手順を確認することが一般的です。コンテナ更新の準備に関する議論は、古いイメージと永続データを一緒に利用できる状態にしておく必要性を示しています。
PASSとは、既知の互換性リスクに分離の順序があり、重要なローカル制御を妨げるものがない状態です。FAILとは、保守されていないカスタムコンポーネントが必要で、テストされていない状態です。延期するか、コピーに対して対象イメージをテストするか、または本番停止を予定する前に、文書化された機能低下モードを受け入れてください。
アップグレードの実施条件とロールバックのトリガーを定義する
正確な停止順序、イメージの取得と再作成の手順、予想される移行シグナル、検証チェックリスト、最大停止時間、ロールバックコマンドを記述します。古いイメージのダイジェストを保持し、初回起動の観察期間中は永続データを手動で変更しないでください。現地で手動制御できる状態を確保したメンテナンス時間帯を選びます。
ZimaSpaceの安全な移行チェックリストを使用し、コンテナ自体だけでなく、無線、ストレージ、ネットワーク設定、インテグレーション、テスト済みのフォールバックも含めて確認します。
前述のすべての条件に合格した場合のみ進めてください。アップグレード後は、ログ、Recorder、重要なインテグレーション、1つのローカルオートメーション、1つのリモート経路、バックアップの作成、2回目の再起動を確認します。移行エラーが繰り返される、重要な制御の停止時間が上限を超える、または新しいコンテナで記録した契約情報を再現できない場合は、ロールバックしてください。
おすすめ商品
サポートとヒント
もっと読む
Home AssistantはWi-Fiでは動作するが、イーサネットまたはVPNでは接続できない
各ネットワーク経路を個別にテストし、インターフェースとルーティングの状態を確認して、直接IP接続と検出による接続を区別したうえで、失敗したレイヤーだけを修復します。
保護されていないデータを残さずにHome Assistantを廃止する方法
交換またはアーカイブを証明し、すべての信頼パスを無効化し、データを保持する各デバイスをサニタイズして、文書化された保護済みのリカバリコピーのみを保持する。
ホームサーバー上のHome Assistantで自動更新を利用すべきですか？
家庭への影響、互換性リスク、観察期間、復旧準備の状況を考慮して、手動更新、通知のみ、または段階的な自動更新を選択してください。
