アプリスタック全体を置き換えずに、コンテナを1つだけ復元できますか?

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

設定、永続データ、依存関係の範囲がスタックの残りから明確に分離されていれば、1つのコンテナを独立して復元できます。

家庭用NASでは、画面に表示されるコンテナは通常、破棄しても問題ありませんが、アプリの状態はバインドマウント、名前付きボリューム、別のデータベース、シークレット、プロキシルート、共有ネットワークにまたがる場合があります。そのため、安全な単一サービスの復元とは、コンテナIDをそのまま元に戻すことではありません。影響を受けるサービスを停止し、そのサービスが所有する状態だけを復元し、既知の定義から再作成したうえで、共有依存関係と正常な隣接コンテナに変更がないことを確認することです。

停止する前に復元対象を定義する

失敗したサービスを正確に特定し、そのサービスが所有するオブジェクトをすべて列挙します。対象には、Composeサービス名、イメージタグまたはダイジェスト、環境変数ファイル、シークレット、バインドマウント、名前付きボリューム、公開ポート、ネットワークエイリアス、スケジュール済みジョブ、リバースプロキシのラベルが含まれます。

Dockerのボリューム復元ガイドでは、データボリュームを独立してバックアップおよび復元できるため、コンテナの実行環境と永続ストレージを分けて扱います。実践的な手順では、実行中のコンテナだけを唯一の復旧対象とせず、コンテナとボリュームを別々に復元する方法を紹介しています。

アプリが共有データベースやボリュームに書き込む場合、復元対象にはその共有依存関係も含まれ、安全に隔離できなくなることがあります。所有関係が明確になるまでは、何も上書きせずに作業を止めてください。

正常なスタックと失敗したサービスの状態を記録する

現在のComposeファイル、解決済みの環境変数、イメージダイジェスト、マウント一覧、ネットワークへの参加状況、ヘルス状態、直近のログをエクスポートまたは保存します。復元による影響範囲を明確にするため、隣接するどのサービスが正常かも記録します。

Composeのサービス単位の操作では、すべてを再起動せず、名前を指定したサービスだけを対象にできます。Linux Handbookの単一サービスの手順では、1つのComposeサービスとスタック全体への操作を区別しています。また、設定を変更した場合は単純な再起動ではなく、コンテナの再作成が必要だと説明しています。

失敗したサービスだけ、自動更新と再起動ループを無効にします。整合性を保つために連携した停止が必要な場合を除き、データベースと共有インフラストラクチャは稼働させたままにします。

まず隔離された場所にデータを復元する

選択したバックアップは、稼働中のパスに直接上書きせず、一時ディレクトリまたは新しいボリュームに復元します。ファイル数、所有者、タイムスタンプ、データベースダンプのメタデータ、アプリケーションのバージョンを、破損した状態と比較します。

ボリュームバックアップのプロジェクトでは、一時的な単発コンテナを使ってターゲットボリュームをマウントし、データを再投入する方法を説明しています。これにより、本番サービスが書き込みを行う前に隔離されたボリューム復元経路を作成できます。

データベースでは、利用可能な場合は必ずアプリケーション対応のダンプまたは復元方法を使用してください。稼働中のデータベースをファイルシステム上でコピーした場合、クラッシュ整合性が得られるにすぎないことがあり、古いコンテナを削除した後に復旧できなくなる可能性があります。

マウントを切り替える前に、分離したコピーを検証してください。バックアップを読み取れない場合や、そのスキーマが使用予定のイメージと一致しない場合は、現在の状態を保持し、別の復旧ポイントを選んでください。

元の識別情報を維持して、失敗したサービスのみを再作成する

保存したCompose定義からサービスを再作成します。その際、同じプロジェクト名、外部ネットワーク、サービスエイリアス、ポート、シークレット、UID/GIDマッピング、検証済みの永続パスを維持してください。

データを正しく復元しても、所有権やセキュリティラベルが実行時のユーザーと一致しなくなっていると、マウントへのアクセスに失敗することがあります。Rocky Linuxのコンテナ事例では、データを再コピーするのではなく、所有権とセキュリティコンテキストを確認して、ボリュームにアクセスできない問題を解決しました。

ボリュームを削除したり、スタック全体を対象とするpruneコマンドを実行したりせずに、サービスを起動します。マイグレーション、スキャン、バックグラウンドジョブによって復元データが変更される前に、実際に適用されるマウント設定を確認してください。

依存先を復元せずに再接続する

復元したコンテナから、データベース、キャッシュ、IDプロバイダー、オブジェクトストレージ、プロキシネットワークへのDNS名前解決とTCP接続をテストします。復旧した設定で定義されているものと同じサービス名と認証情報を使用してください。

共有依存先が正常な状態を保っている場合、アプリケーションが接続できないという理由だけで、その依存先を復元または置き換えないでください。ネットワークエイリアスの欠落、シークレットのローテーション、スキーマの不一致、データベース名の誤りによって、正常な依存先が利用不能に見えることがあります。

復元したアプリのバージョンとデータベースのバックアップで必要な場合にのみ、マイグレーションを実行してください。取り消せないマイグレーションの前に依存先をバックアップし、アプリが空のデータベースを初期化しようとした場合は中止してください。

トラフィックを戻す前に単一サービスの境界を検証する

ログイン、読み取り、書き込み、アップロード、スケジュール済みジョブ、API呼び出し、プロキシ経由のアクセス、制御された再起動をそれぞれテストします。隣接するコンテナの再起動回数、ログ、ポート、データのチェックサムを、復元前に取得した記録と比較します。

ZimaSpaceの永続的なコンテナ状態のマッピングガイドでも、同じ復旧原則を説明しています。想定上のコンテナシェルではなく、状態の所有者を復元してください。

復元が完了したと言えるのは、復旧したサービスが意図したデータと依存先を使用し、正常なスタックの他のメンバーが変更されておらず、再作成しても同じ結果が得られる場合だけです。共有状態を分離できない場合は、部分的なロールバックを無理に行わず、スタック全体を協調して復元する手順にエスカレーションしてください。

サポートとヒント

続きを読む

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.