セルフホスト型データベースのアップグレードガイド:ダンプ、スナップショット、移行、ロールバック

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

安全な方法は、標準のダンプ、ストレージスナップショット、隔離された環境でのリストアリハーサル、明確に定めたロールバックポイントを用いた段階的なアップグレードを、単一のコマンドではなく、確認可能な複数のゲートとして扱うことです。

ホームサーバー上のコンテナ化されたPostgreSQLまたはMariaDBデータベースでは、論理オブジェクトや実行可能なロールバック手段を失わずに、セルフホスト型データベースをバージョンアップグレードする必要があるという実務上のリスクがあります。現在の状態と復旧ポイントを記録し、変更の少ない判定方法から始め、別の変数を変更する前に成功・失敗の結果を解釈します。ストレージが不安定になった場合、または唯一の復旧可能なコピーが危険にさらされる場合は、作業を中止します。以下の手順は、元のワークロードが正常に動作するか、証拠がエスカレーションの境界に達した場合にのみ完了となります。

バックアップ前に互換性とロールバックを定義する

データベースエンジンと正確なソースバージョン、ターゲットバージョン、アプリケーションバージョン、拡張機能またはプラグイン、文字セット、認証ルール、スケジュール済みジョブ、許容できるダウンタイムを記録します。データベースのアップグレード手順だけでなく、アプリケーションのアップグレードに関する注意事項も確認してください。アプリケーションの移行によって、旧バイナリが新しいスキーマと互換性を失うことがあります。

メジャーバージョンアップグレードでは、多くの場合、旧データディレクトリを新しいイメージにマウントするのではなく、論理ダンプとリストア、またはサポート対象の移行ツールが必要です。独立したComposeを使ったデータベースのメジャーバージョンアップグレード手順では、ComposeベースのPostgreSQLのメジャーバージョンアップグレードを順を追って解説し、旧コンテナとボリュームをターゲットから分離しておく必要がある理由を示します。

ロールバックの期限とトリガーを今すぐ決めます。トリガーには、整合性チェックの失敗、ロールの欠落、拡張機能の欠落、アプリケーションエラー、許容できないパフォーマンスなどがあります。ターゲットで本番の書き込みが始まると、逆方向のデータ移行計画をテスト済みでない限り、ロールバックはできなくなります。

独立した復旧ポイントを2つ作成する

該当する場合はグローバルオブジェクトも含め、エンジン標準の論理バックアップを実行します。その後、コマンド、バージョン、終了ステータス、マニフェスト、チェックサムを保存します。1つのデータベースダンプにサーバーレベルの依存関係がすべて含まれると思い込まず、ユーザー、権限付与、拡張機能、スキーマ、スケジュール済みジョブ、大規模オブジェクトが含まれていることを確認します。

データベースがサポートされる状態であることを確認してから、データベースボリュームの整合性のあるスナップショット、または停止状態でのコピーを作成します。論理ダンプは移植性とオブジェクト単位の検査を可能にし、ストレージコピーは旧バージョンへ正確に戻すためのポイントを保持します。どちらか一方で他方を上書きしてはいけません。

ZimaSpaceの検証チェックリストを使って、データベースバックアップの完全性チェックリストを確認してください。ダンプが読み取り可能で、ストレージのリカバリポイントが特定され、その両方がアップグレード対象のボリューム外に保存されている場合にのみ、バックアップの判定を合格としてください。

隔離された移行先で移行をリハーサルする

別のボリュームとポートで移行先データベースを起動し、必要な拡張機能をインストールして、論理バックアップを復元し、すべての警告を記録してください。Perconaの論理ダンプと復元によるアップグレード手順の解説では、ダンプと復元の手順、および予定しているPostgreSQLアップグレード経路に合ったツールを使用する必要性が取り上げられています。

復元したデータベースに、使い捨てのアプリケーションインスタンスを接続してください。ログイン、読み取り、書き込み、バックグラウンドジョブ、検索、添付ファイル、タイムゾーン、再起動をテストしてください。復元が正常終了したという終了コードだけに頼らず、行数と重要な集計値を比較してください。

拡張機能を利用できない、照合順序の変更が未解決、マイグレーションが失敗、または復元時間がメンテナンス時間枠を超える場合は、先に進まないでください。リハーサルを修正して新しいダンプを作成してください。本番環境で移行先バージョンとの非互換性を初めて発見することのないようにしてください。

書き込み先を切り替え、クリーンな状態でロールバックできるようにする

メンテナンスモードに切り替え、アプリケーションの書き込み処理とジョブを停止し、アクティブな接続がすべて切断されたことを確認してから、最終ダンプまたはサポートされている差分を作成してください。クリーンな移行先に復元し、整合性とオブジェクトを検証して、アプリケーションの接続先を更新し、依存関係の順序に従ってサービスを起動してください。

エラー率、ロック、ジョブの実行状況、バックアップ、実際のアプリケーショントランザクションを監視してください。元のボリュームとイメージダイジェストを保持したまま、旧データベースを停止して読み取り専用にしてください。同じアプリケーションIDで、両方のデータベースがそれぞれ独立して書き込みを受け付ける状態にしてはいけません。

アプリケーション、ネイティブのバックアップジョブ、再起動、新バージョンからのテスト復元がすべて成功した場合にのみ、成功と判断してください。書き込み境界を越える前にロールバックの条件に該当した場合は、アプリケーションの接続先を保存済みの旧インスタンスに戻してください。新たな書き込みが行われた後は、単純な再起動でデータを元に戻せるかのように装わず、停止して文書化された整合性調整計画に従ってください。

サポートとヒント

続きを読む

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.