ホームNAS上で稼働中のデータベースコンテナの一貫性を保てるバックアップ方法は?

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

ホームNASやセルフホストサーバーを使うほとんどのユーザーにとって、最も安全な標準設定は、データベースの稼働中にデータベース固有の論理バックアップを作成し、そのダンプをコンテナ設定およびアプリケーションファイルと一緒に通常の方法でバックアップすることです。停止時間を許容できる場合は、コンテナを短時間停止してコピーします。データベースをフラッシュ、ロック、チェックポイント処理するなど、スナップショットに備えた場合に限り、連携されたファイルシステムスナップショットを使用してください。稼働中のデータベースボリュームをそのままコピーしても、一貫性のあるバックアップにはなりません。

「一貫性がある」とは、データベースが受け入れられる状態で復元できること

一貫性のあるバックアップとは、フォルダーツリーが完全にそろっているだけではありません。復元後、データベースエンジンが起動し、トランザクションを正しくリカバリーし、整合性チェックに合格して、アプリケーションが利用できる特定時点の状態を提示できる必要があります。Immich、Nextcloud、Paperless-ngx、Home Assistantなどのセルフホストアプリをホームサーバーで動かしている場合、データベース、アップロードデータ、設定、シークレットの整合性が取れている必要があります。

コンテナの永続化によって分かるのは、ファイルの保存場所だけです。稼働中のデータベースを安全にコピーできるわけではありません。NASのバックアップソフトウェアがボリュームを読み込んでいる間も、データベースではトランザクションが進行し、キャッシュページ、先行書き込みログ、一時ファイル、メタデータが変化している可能性があります。

方法1:ホームNASの標準設定として、データベース固有の論理ダンプを使う

論理ダンプでは、データベースエンジンにスキーマとレコードの一貫した状態を書き出させます。家庭用NAS上で動作する小規模なPostgreSQLまたはMariaDBのコンテナなら、通常はこれが最も簡単な方法です。スケジュール設定や内容の確認、オフサイトへのコピー、クリーンな代替コンテナへの復元が容易です。最新のDockerバックアップガイドでは、スケジュールされたバックアップコンテナからデータベース固有のダンプを実行する方法を紹介しています。

ダンプは、稼働中のデータボリュームの外にある専用のバックアップディレクトリに保存してください。その後、NASのバックアップジョブで、ダンプ、Composeファイル、環境テンプレート、アプリケーション設定、アップロードデータを保護します。本番環境のパスワードをダンプのファイル名や保護されていないログに含めないでください。

データベース ホームサーバーの標準設定 バックアップジョブで収集するもの
PostgreSQL ネイティブの論理ダンプ、またはデータベース固有の物理バックアップツール 必要に応じて、ダンプ、ロールまたはグローバル設定、Composeファイル、環境変数の値、アプリファイル
MariaDB/MySQL 一貫性を保つトランザクションオプションを使った、ネイティブの論理ダンプ 必要に応じて、SQLダンプ、ユーザーまたは権限設定、Composeファイル、シークレット、アプリファイル
SQLite アプリケーションのバックアップ、SQLiteのオンラインバックアップ、または正常に停止した状態でのコピー 整合性のあるデータベースコピーに、アプリケーション設定と添付ファイルを含める

方法2:ボリュームのコピー前にデータベースを短時間停止する

コンテナーを停止してコピーする方法は簡単で、物理データをすべてコピーできます。最初にアプリケーションからの書き込みを停止し、データベースを正常に停止して、プロセスの終了を確認してから、永続ボリューム全体またはバインドマウントされたデータベースディレクトリをコピーし、その後スタックを再起動します。DockerとMariaDBのガイドでは、物理ボリュームのコピーは高速だがバージョンに依存し、通常はダウンタイムを伴うと説明されています。

この方法は、数分のメンテナンスが許容され、互換性のあるデータベースバージョンで復元する小規模なホームNASに適しています。論理ダンプより移植性が低く、ボリュームが大きいとダウンタイムが長引くことがあります。物理ファイルを互換性のないエンジンバージョンに復元しないよう、バックアップと一緒にデータベースイメージのタグとストレージ構成を保管してください。

方法3:データベースと連携してすばやくスナップショットを取得する

ZFS、Btrfs、LVM、NASのスナップショット機能を使えば、大容量のデータベースボリュームをすばやく取得できますが、スナップショットはデータベースと連携して取得する必要があります。MariaDBやMySQLでは、短時間のロックまたはフラッシュが必要な場合があります。PostgreSQLでは、サポートされているバックアップまたはチェックポイントの手順が必要な場合があります。アプリケーション管理のデータベースでは、スナップショット前のフックが必要な場合があります。

データベースのスナップショットに関する解説では、データベースを凍結するか、スナップショットを原子的に取得しない限り、ディスク上の稼働中データのコピーには整合性がない可能性があると説明されています。ロックまたは静止させる時間は短くしてください。データベースを準備し、スナップショットを作成し、書き込みを再開してから、後でスナップショットをコピーします。

この方法は、データベースが頻繁な論理ダンプには大きすぎる場合や、目標復旧時点を短くしたい場合に役立ちます。一般的なホームサーバーのダンプ手順よりも、慎重なスクリプト作成と復元テストが必要です。

Dockerイメージやコンテナーのエクスポートをデータベースのバックアップとして扱わない

コンテナーイメージに含まれるのはアプリケーションの実行環境であり、稼働中の永続データが必ず含まれるわけではありません。コンテナーをエクスポートまたはコミットしても、名前付きボリュームが除外されることがあり、データベースに整合性のある復旧ポイントの作成を依頼することもありません。PostgreSQLコンテナーのバックアップに関する記事では、Dockerのsaveやcommitは、PostgreSQL固有のバックアップ手法の代わりにはならないと結論づけています。

ZimaOSまたはDockerを使うホームサーバーでは、デプロイ定義とデータ保護計画を分けて管理してください。サービスを再構築できるようにComposeファイルとイメージタグを保存し、データベースの状態を復元できるように、整合性を保つ方法でデータベースを保護してください。

書き込み中のデータベースボリュームを単純にコピーしない

NASのバックアップソフトウェアは、異なるデータベースファイルを別々の時点で読み取る場合があります。その結果、アーカイブには、あるトランザクション状態のデータファイル、別の状態のログ、さらに別の状態のメタデータが含まれることがあります。オープンソースのSQLバックアップ方式をまとめた記事では、重要な状態がまだメモリ上にある間にデータベースが変更されていると、整合性のない時点で取得される可能性があると警告しています。

一貫性を保って取得したスナップショットなら、クラッシュ後の復旧で修復できる場合もありますが、通常の再帰的なファイルコピーには原子性がありません。アプリケーションを停止できない場合は、論理ダンプ、対応する物理バックアップツール、または連携されたスナップショットを使用してください。

SQLiteコンテナは一般ファイルではなくデータベースとして扱う

多くのホームサーバーアプリは、コンパクトで導入しやすいためSQLiteを使用しています。管理者が単一の.dbファイルを見て、アプリが書き込み中でもコピーできると思い込むことがリスクです。WALモードでは、直近のコミット済みの変更がメインファイルにまだ反映されていないことがあります。実践的なSQLite復旧ガイドでは、稼働中のデータベースファイルをコピーするのではなく、オンラインバックアップ機能を使うか、正常に閉じた状態でコピーすることを推奨しています。

アプリケーションに組み込みのバックアップ機能があれば、それを使ってください。ない場合は、SQLite独自のオンラインバックアップ機能を使うか、アプリケーションを正常に停止してからデータベースディレクトリ全体をコピーしてください。ジャーナルやWALの状態を残したまま、メインのデータベースファイルだけをコピーしないでください。

ダウンタイム、データベースのサイズ、復元の移植性に応じて方法を選ぶ

ホームNASの状況 最適な開始方法 主なトレードオフ
小規模なデータベース、毎日のバックアップ、容易な移行 論理ダンプ データベースの増加に伴い、ダンプにかかる時間が長くなる
小規模なデータベース、メンテナンス時間を確保できる 正常に停止してから物理ボリュームをコピー ダウンタイムとバージョン互換性が必要
大規模なデータベース、短いバックアップ時間 データベースと連携したスナップショットまたはネイティブの物理バックアップ より複雑なフック、保持ポリシー、復元テスト
エクスポート機能を内蔵したSQLiteアプリ アプリケーションのエクスポートまたはSQLiteのオンラインバックアップ アプリ固有の自動化が必要な場合がある
データベースとアップロードファイルを含むメディアまたはドキュメントアプリ データベースの整合性を保ったバックアップと、同期されたファイルバックアップ データベースとファイルのタイムスタンプを同じ復旧時点にそろえる必要がある

セルフホストアプリケーション全体をバックアップする。データベースだけでは不十分

実用的な復旧用パッケージには、データベースのバックアップ、Docker Compose ファイル、イメージのバージョン、環境変数または復旧可能なシークレット一式、リバースプロキシの設定、アプリケーションの設定、アップロードファイル、暗号化キーを含める必要があります。SQL ダンプだけをバックアップすると、レコードは復元できても、アプリが写真、ドキュメント、サムネイル、証明書、保存先のパスを見つけられないことがあります。

ホームサーバーの復旧計画については、バインドマウントと名前付きボリュームに関する ZimaSpace ガイドで、保存場所を見えるようにすることが復旧に役立つ理由と、それでもアプリケーション整合性のあるデータベースバックアップの代わりにはならないことを説明しています。

新しいコンテナへの復元で方法を検証する

新しいプロジェクト名、異なるホストポート、一時的なデータディレクトリを使って、分離されたテスト環境を作成します。ダンプまたはスナップショットを復元してデータベースを起動し、整合性チェックを実行してから、アプリのテストコピーを接続します。ユーザー、レコード、添付ファイル、最近のトランザクションが存在することを確認してください。

リカバリーポイントとリカバリー時間の両方を測定しましょう。論理ダンプに整合性があっても復元に時間がかかりすぎる場合は、移植可能な復旧手段として維持し、より高速な整合性のあるスナップショットを追加してください。停止中のボリュームコピーがすばやく復元できても、同じデータベースバージョンでしか使えない場合は、移行用の代替手段として論理ダンプも残しましょう。

よくある質問

ボリュームをコピーする前にデータベースコンテナを一時停止するだけで十分ですか?

一般的には不十分です。一時停止するとプロセスは止まりますが、データベースがポータブルなバックアップに適した状態を正しくディスクへ書き込んだことの証明にはなりません。データベース標準のダンプ、正常なシャットダウン、または文書化された静止化とスナップショットの手順を使いましょう。

NAS のスナップショットだけで PostgreSQL または MariaDB のバックアップとして十分ですか?

スナップショットがアトミックで、データベースがサポートする整合性確保の手順と連携している場合に限ります。連携なしで取得したスナップショットはクラッシュ整合性しかない可能性があり、アトミックでないファイルコピーはさらに問題になることがあります。

SQLite ベースのホームサーバーアプリでは、何をバックアップすべきですか?

利用できる場合は、アプリのエクスポート機能または SQLite のオンラインバックアップを使いましょう。また、メインの .db ファイルだけがアプリ全体だと思い込まず、アプリの設定、Compose ファイル、シークレット、添付ファイル、データベースを含むディレクトリも保存してください。

最終的な推奨

ホームNAS上のほとんどの PostgreSQL および MariaDB コンテナでは、スケジュールされた論理ダンプを標準のバックアップ方法にしましょう。短時間の停止を許容できる場合は、停止した状態でボリュームをクリーンにコピーし、データベースのサイズが大きい場合やリカバリーポイントの許容範囲が厳しい場合は、整合性を保ったスナップショットまたはデータベース標準の物理バックアップツールを使いましょう。どの方法を選んでも、信頼する前に新しいコンテナへ復元してください。

サポートとヒント

続きを読む

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.