アプリデータを失わずにコンテナイメージをロールバックできますか?

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

永続データがコンテナの外部にあり、古いバージョンとの互換性が保たれていれば、アプリデータを失わずにコンテナイメージをロールバックできます。

ホームNASでは、イメージを置き換えると通常、アプリケーションの実行環境だけが再作成され、名前付きボリュームやバインドマウントにはデータベース、設定、ユーザーファイルが保持されます。危険が生じるのはスキーマの変更です。新しいイメージがデータベースを移行したり、古いイメージでは読み取れない形で設定を書き換えたりする可能性があります。ロールバックの前に、現在のマウント、イメージの識別情報、設定、シークレット、整合性のあるデータバックアップを取得してください。

イメージを変更する前に現在の状態を固定する

イメージの自動更新を停止し、現在のイメージタグ、不変のダイジェスト、コンテナ設定、環境変数、ネットワーク、ポート、マウント、再起動ポリシー、ヘルスチェックを記録します。Composeファイルまたはエクスポートした設定は、コンテナとは別に保存してください。

NASコンテナのロールバック手順では、変動するlatestタグに頼らず、以前のイメージを正常な状態で利用できるようにしておくことを推奨しています。利用可能な復旧ポイントは、特定の以前のイメージバージョンと、そのイメージを実行していた設定の組み合わせです。

新しいバージョンを停止する前に、アプリケーションと整合性のあるデータベースのバックアップまたはスナップショットを作成してください。既存のボリュームをロールバック用のコピーだと思い込まないでください。更新によって、すでにスキーマやデータに変更が加えられている可能性があります。

アプリデータが書き込み可能レイヤーの外部にあることを確認する

名前付きボリュームとバインドマウントをすべて対応付けたうえで、データベース、アップロードファイル、プラグイン、証明書、キャッシュ、設定のうち、コンテナの書き込み可能レイヤー内にしか保存されていないものを特定します。

新しいコンテナが同じ外部データ保存先に再接続した場合に限り、永続ストレージはコンテナの置き換え後も保持されます。SynoForumのイメージバージョン変更手順では、別のイメージからコンテナを再作成する前に、ボリュームデータがNASストレージに保持されていることを明示的に確認します。

重要なデータが書き込み可能レイヤーにしかない場合は、現在のコンテナを削除する前にコピーまたはエクスポートしてください。この抽出は復旧手順として扱い、バージョン指定のないコンテナをいつまでも保持する理由にしないでください。

latestを再利用せず、正確な旧イメージを指定する

最後に正常動作していたタグまたはダイジェストを取得するか特定し、イメージの参照だけを更新します。サービスを再作成する前に、アーキテクチャ、アプリケーションのエディション、必須の環境変数を確認してください。

Composeで管理するサービスをロールバックする場合、実行中のコンテナをその場で元に戻すようDockerに依頼するのではなく、以前に明示していたイメージバージョンに戻すのが一般的です。実用的なロールバックでは、Composeで固定したイメージタグを変更し、サービスを再作成します。

正体のわからない古いキャッシュ済みイメージは使用しないでください。プル後にダイジェストを記録し、別の再ビルドで同じ可変タグの下から異なるバイナリが選ばれることがないようにします。

新しいバージョンでデータベースが変更されたか確認する

ロールバック先のバージョンから現在のイメージまでのリリースノートとマイグレーションログを確認してください。元に戻せないスキーマ変更、書き換えられた設定、暗号化キーの変更、プラグインのアップグレードがないか確認します。

アプリケーションのコードとスキーマに互換性を保つ必要があるため、データベースのロールバックはイメージのロールバックより困難です。Octopusは、古いバージョンと新しいバージョンが共存したり、切り戻されたりする可能性がある場合、後方互換性のあるマイグレーションが必須だと説明しています。そのため、ロールバックの可否はバージョン間のスキーマ互換性で決まります。

古いイメージで移行後のデータベースを読み取れない場合は、新しい状態を古いコードに読み込ませるのではなく、アップグレード前のデータベースバックアップを復元してください。ロールバック自体を元に戻す必要が生じた場合に備えて、現在のデータベースは別途保存してください。

同じ永続パスを使ってサービスを再作成する

検証済みの名前付きボリュームまたはバインドマウントを維持したまま、古いイメージを使ってアプリケーションコンテナを停止し、再作成します。ボリュームを削除するコマンドやUIオプションは使用しないでください。

古いバージョンで文書化された相違が必要な場合を除き、ネットワーク名、サービスエイリアス、公開ポート、UID/GIDのマッピング、シークレット、リバースプロキシの転送先は同じ状態に保ってください。マウント先が間違っていてもコンテナの起動に成功すると、新しい空のアプリが作成され、データが失われたように見えることがあります。

ログインしたりバックグラウンドジョブを実行させたりする前に、マウント一覧とアプリケーションログを確認してください。アプリが新しいデータベースを初期化した場合は、すぐに停止し、誤った場所にインポートするのではなく、データパスを修正してください。

ロールバックを検証し、先に進める復旧手段を確保する

ログイン、データベースの読み書き、アップロード、スケジュール済みジョブ、連携機能、および管理下での再起動を一度テストします。レコードやファイルをいくつか選び、ロールバック前の一覧と比較してください。

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.