SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

Docker Composeのバックアップと安全なアップグレード方法

Docker Composeのバックアップで保存すべきComposeファイル、.env、volume、DBダンプを整理します。restoreの検証方法と、pull前に行う安全なアップグレード手順も解説します。

Docker Compose スタックのバックアップに含めるもの

Docker Compose スタックのバックアップには、4 つの独立した要素を含める必要があります。どれか 1 つでも失うと、アプリケーションは復旧できません。対象は、Compose ファイル、その横にある .env、すべてのボリュームの内容、そしてデータベース自身のクライアントで作成したデータベースダンプです。コンテナの実行中にデータベースのファイルをコピーしても、バックアップにはなりません。アップグレードでも同じ一覧を使用します。ただし、1 つルールがあります。pull の前にバックアップを取得してください。スキーマのマイグレーションは前進方向に実行されるよう作られており、多くのプロジェクトには元に戻す手段がないためです。

以下では、スタックがすでにデプロイされ、docker compose ps で稼働中であることを前提とします。例では、/srv/myapp にあるプロジェクトディレクトリと、app および db という名前のサービスを使用します。実際の環境の名前に置き換えてください。コマンドは意図的に汎用的にしています。重要な部分であるボリュームとデータベースは、アプリケーションが何であっても同じ方法で扱えるためです。

実際のスタックが保存しているデータを確認する

cd /srv/myapp
docker compose ps
docker compose config --volumes
docker volume ls --filter label=com.docker.compose.project=myapp

docker compose config --volumes は、compose ファイルで宣言されている named volume の短い名前を出力します。docker volume ls は、それらの volume がディスク上で実際に使用している名前を出力します。2 つの一覧が異なるのは、Compose が先頭にプロジェクト名を付けるためです。ファイルで db_data と記述した volume は、実際には myapp_db_data として存在します。プロジェクト名の既定値はディレクトリ名です。そのため、ディレクトリ名を変更すると、スタックは空の volume の新しいセットを参照し、以前の volume はデータを保持したまま残ります。以下の各コマンドでは、docker volume ls から実際の名前を指定する必要があります。

bind mount は、どちらの一覧にも表示されません。compose ファイルでは、コロンの左側にホスト側のパスがあるエントリが該当します。./config:/app/config。これらはホスト上の通常のディレクトリなので、通常のツールでアクセスできます。named volume は /var/lib/docker/volumes/ 配下に保存され、docker volume inspect --format '{{.Mountpoint}}' myapp_db_data で 1 つの volume の正確なパスを出力できます。スタックがどちらの方式を使用しているかによってコピー方法は変わります。bind mount と named volume の比較 で、その違いを詳しく説明しています。

次に、確認したものを 2 つのグループに分類します。一方は、再作成できない状態を保持する volume です。アップロードしたファイル、生成された鍵、データベース本体、アプリにユーザーが入力した内容などが該当します。もう一方は、サムネイルや検索インデックスなど、アプリが自動的に再構築できる派生データを保持する volume です。後者をバックアップしても、ディスク容量と復元時間が増えるだけで、メリットはありません。Redis のキャッシュ volume が最も分かりやすい例です。これを失っても、最初のリクエストが遅くなるだけです。

compose ファイルと .env ファイルをバックアップする

両方のファイルはホスト上で隣り合って配置されており、どちらも volume 内にはありません。.env にはデータベースのパスワード、アプリケーションシークレット、API トークンが保存されます。そのため、複数の volume を動作するアプリケーションに戻すために重要なファイルです。通常は .gitignore にも記載されるため、「設定は git に保存している」というバックアップ方針では、最も重要な単一ファイルが対象外になります。env ファイルにシークレットを保存する方法が適切です。その場合、バックアップにも対応する責務が生じます。

sudo install -d -m 700 -o "$USER" -g "$(id -gn)" /srv/backups/myapp
cp -a compose.yaml .env /srv/backups/myapp/
chmod 600 /srv/backups/myapp/.env

スタックが使用するすべての compose ファイルをコピーしてください。最初のファイルだけでは不十分です。-f compose.yaml -f compose.prod.yaml で起動したスタックを同じ構成で復元するには、両方のファイルが必要です。また、複数の compose ファイルのマージ方法によって、実際にコンテナへ渡される値が決まります。

.env と volume には関連する注意点があります。公式の Postgres イメージは、空のデータディレクトリを初期化するときにだけ POSTGRES_PASSWORD を読み取ります。後からこの値を変更しても、データベース内のパスワードは変更されません。先月の volume を今日の .env と一緒に復元すると、両方のファイルを確認した限りでは正しく見えても、アプリケーションは FATAL: password authentication failed for user "appuser" で接続に失敗します。.env と volume は、同じ時点のものを同じバックアップにまとめて保管してください。

データベース固有のクライアントでダンプする

データベースサーバーは、常にファイルへ書き込みます。サーバーの実行中に取得した tar の /var/lib/postgresql/data では、書き込み前のページと書き込み後のページが混在するため、アーカイブ内に復元できない時点の組み合わせが含まれます。ダンプツールは単一のトランザクション内を読み取るため、ファイルには一貫した1つの時点の状態が保存されます。この違いにより、バックアップと単なるコピーが分かれます。

docker compose exec -T db sh -c \
  'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
  > /srv/backups/myapp/db-$(date +%F).dump

-T はそのままにしてください。これは TTY の割り当てを無効にします。TTY を接続すると、Docker がシェルへ出力を渡す途中で出力ストリームを変換するため、バイナリダンプが破損します。復元に失敗するまで、その問題には気付きません。シングルクォートも重要です。これによりホストのシェルが $POSTGRES_USER を展開せず、コンテナ内のシェルが展開します。その際、compose ファイルがコンテナ内に設定した値を使用します。-Fc は custom format で書き込みます。この形式は処理中に圧縮され、後から pg_restore で必要なオブジェクトだけを取り出せます。

ロールとそのパスワードは特定のデータベースの外部に保存されるため、これらも取得します。

docker compose exec -T db sh -c 'pg_dumpall -U "$POSTGRES_USER" --globals-only' \
  > /srv/backups/myapp/globals.sql

続いて、ファイルがエラーメッセージではなくダンプであることを確認します。

ls -lh /srv/backups/myapp/
head -c 5 /srv/backups/myapp/db-$(date +%F).dump

custom format のダンプは、5バイトの PGDMP で始まります。0バイトのファイル、または pg_dump: で始まるファイルは、コマンドが失敗したことを示します。シェルはコマンドの実行前に出力ファイルを作成するため、ダンプに失敗しても、もっともらしい名前とタイムスタンプのファイルが残ります。これは、最も一般的なサイレントバックアップ失敗です。

MariaDB または MySQL ではクライアントが変わりますが、基本的な形は同じです。

docker compose exec -T db sh -c \
  'mariadb-dump -u root -p"$MARIADB_ROOT_PASSWORD" --single-transaction --databases "$MARIADB_DATABASE"' \
  > /srv/backups/myapp/db-$(date +%F).sql

--single-transaction は、書き込みをブロックせずに InnoDB テーブルの一貫したダンプを作成します。MySQL イメージではコマンドが mysqldump で、変数は MYSQL_ROOT_PASSWORD と MYSQL_DATABASE です。MariaDB イメージでは、11.0 以降、mysqldump という互換名が削除されています。そのため、それを呼び出す古いスクリプトは失敗し、代わりに mariadb-dump が必要です。コマンドラインで指定したパスワードは、ダンプの実行中、コンテナのプロセス一覧から見えることにも注意してください。

SQLite には固有の注意点があります。データベースは1つのファイルですが、最近のトランザクションが、その隣にある別の -wal ファイルに残っている場合があります。そのため .db だけをコピーすると、最新の書き込みが欠落したデータベースになります。イメージにクライアントが含まれている場合、sqlite3 /data/app.db ".backup '/data/app-backup.db'" によってアプリケーションの実行中に一貫したコピーを作成できます。含まれていない場合は、コンテナを停止し、.db ファイルを -wal および -shm の関連ファイルと一緒にコピーします。

データベースがスタック内ではなくホスト上で実行されている場合は、docker compose exec プレフィックスなしで同じコマンドを使用できます。次回の再構築の前に、Docker またはホスト上でデータベースを実行する方法も確認してください。

ボリュームを取得する

名前付きボリュームには、手作業で編集すべきホスト側のパスがありません。そのため、一時的なコンテナにマウントし、そこからアーカイブします。

docker run --rm \
  -v myapp_uploads:/data:ro \
  -v /srv/backups/myapp:/backup \
  alpine:3 tar czf /backup/uploads.tar.gz -C /data .

ヘルパーコンテナは、ボリュームを /data に読み取り専用で、バックアップディレクトリを /backup にマウントし、アーカイブをホスト側へ書き出します。--rm により、tar が終了するとすぐにヘルパーが削除されます。:ro は重要です。tar コマンドを入力し間違えても、ソースを破損させられないためです。-C /data . によって、復元先が正しくなります。ボリュームのルートからの相対パスとして、すべてのパスを保存するためです。代わりに tar czf /backup/uploads.tar.gz /data とすると、すべてのパスの先頭に data/ が付きます。その結果、復元時にボリューム内へ /data/data が作成され、アプリからは空のディレクトリに見えます。コンテナ内で tar を root として実行したため、アーカイブの所有者は root です。問題になる場合は sudo chown "$USER" /srv/backups/myapp/uploads.tar.gz を実行してください。復元したファイルをアプリが読み取れない場合は、PUID と PGID がファイル所有者を決める仕組みも確認してください。

名前付きボリュームごとに 1 回実行します。バインドマウントにはコンテナは不要です。tar czf /srv/backups/myapp/config.tar.gz -C /srv/myapp/config . でホスト上から同じ処理を実行できます。

アプリを停止する必要があるかどうかを、ボリュームごとに判断します。アプリがボリューム内のファイルを書き換えている最中に tar を実行すると、書き込み途中のファイルを取得する可能性があります。アップロードディレクトリのように、ファイルを 1 回書き込んだ後は読み取りだけを行う場合、このリスクは小さいです。それ以外では、コピー中だけ docker compose stop app で対象サービスを停止し、その後 docker compose start app を実行してください。stop はコンテナとボリュームをそのまま残します。この用途に適した動作です。どちらかを入力する前に、down と stop の違いを確認しておく価値があります。

データベースボリュームの tar を、データベースのバックアップとして扱わないでください。バックアップはダンプです。停止したデータベースのボリュームアーカイブは、迅速な再構築に使える手段にすぎません。

作業手順

  1. compose ファイルと .env をバックアップディレクトリにコピーします。
  2. データベースが稼働している間にダンプを取得します。
  3. ボリュームの内容をその場で変更する場合は、アプリコンテナを停止します。
  4. 各 named volume と各 bind mount ディレクトリをアーカイブします。
  5. 停止したものを再起動し、docker compose ps で確認します。
  6. スタックが使用しているイメージタグとダイジェストを記録します。
  7. バックアップディレクトリ全体をこのサーバーの外部へコピーします。

手順 7 は、後回しにされがちです。

サーバー外部にコピーを保管する

スタックと同じディスク上にあるバックアップは、自分の操作ミスからは保護できますが、それ以外の障害からは保護できません。ボリュームの障害、サーバーの削除、アカウントの紛失が1つ発生するだけで、2つのコピーを同時に失います。ディレクトリは、この VPS ではないストレージへ、スケジュールに従ってコピーし、保持ポリシーを設定してください。VPS からの restic バックアップでは、リポジトリの設定、保持用フラグ、チェックコマンドを説明しているため、ここでは繰り返しません。

restic はパイプからダンプを直接読み取ることもできます。これにより、平文のデータベースをディスクに保存せずに済みます。

docker compose exec -T db sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
  | restic backup --stdin --stdin-filename db.dump

使用するツールに関係なく、スケジュールは systemd timer または cron job に登録し、ジョブの失敗を確認できる場所へ報告させてください。出力先のないバックアップスクリプトは、誰にも発見されないまま6か月間停止し続ける可能性があります。

バックアップが機能することをリストア訓練で確認する

誰もリストアしたことのないバックアップは、仮説にすぎません。以下の訓練では、稼働中のスタックとは別に第2のスタックへリストアします。そのため、本番環境はサービスを提供し続け、入力した内容が本番環境へ到達することもありません。

仕組みの鍵はプロジェクト名です。Compose はディレクトリ名からプロジェクト名を取得し、作成するすべてのコンテナとボリュームに付与します。バックアップを新しいディレクトリへコピーすると、リストアしたスタックには自動的に専用のボリュームが作成されます。

sudo install -d -m 700 -o "$USER" -g "$(id -gn)" /srv/myapp-restore
cd /srv/myapp-restore
cp /srv/backups/myapp/compose.yaml /srv/backups/myapp/.env .

コピーした compose ファイルを編集し、公開するホストポートが稼働中のスタックと競合しないようにします。8080:8080 の代わりに 18080:8080 を設定するか、コピー先の .env でポートを設定している変数を変更します。その後、何も起動せずにコンテナと空のボリュームを作成します。

docker compose create
docker volume ls --filter label=com.docker.compose.project=myapp-restore

2つ目のコマンドでは、本番環境と同じボリューム名の先頭に myapp-restore_ が付いていることを確認できます。ボリュームへデータを投入し、データベースだけを起動してダンプをロードします。

docker run --rm -v myapp-restore_uploads:/data -v /srv/backups/myapp:/backup \
  alpine:3 tar xzf /backup/uploads.tar.gz -C /data
docker compose up -d db
docker compose exec -T db sh -c \
  'pg_restore -U "$POSTGRES_USER" -d "$POSTGRES_DB" --clean --if-exists' \
  < /srv/backups/myapp/db-2026-08-16.dump

--clean --if-exists は各オブジェクトを再作成する前に削除するため、リストアを繰り返し実行できます。これを指定しない場合、すでにテーブルが存在するデータベースへ2回目のロードを行うと pg_restore: error: could not execute query: ERROR: relation "users" already exists で停止します。

続いて残りを起動し、ユーザーと同じ手順で確認します。

docker compose up -d --wait
docker compose exec -T db sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -c "\\dt"'
docker compose logs --tail=50

docker compose up -d --wait は、すべてのサービスが running または healthy になるまで待機します。いずれかのサービスがその状態にならない場合は、ゼロ以外の終了ステータスで終了します。そのため、この手順をスクリプト化できます。サービスが healthy にならない場合は、docker compose ps -a で、すでに終了したサービスを含む状態を確認できます。通常の docker compose ps では終了済みのサービスは表示されません。Compose のヘルスチェックでは、この列が何を参照しているかを説明しています。その後、別のポートでアプリを開き、実際のアカウントでログインします。1件のレコードを書き込み、ボリュームに保存されているファイルを1つ開きます。この2つが証拠です。ダンプがリストアされ、ボリュームもリストアされ、両者の内容が一致していることを確認できます。ログインページが表示されることだけを確認する訓練では、データについて何も確認できません。

訓練に合格したら、環境を削除します。

docker compose down -v

-v が正しいフラグになるのはここだけです。本番用ディレクトリで同じコマンドを実行すると、保護しようとしているボリュームが削除されます。

Compose スタックをアップグレードする方法

使用中のバージョンから目的のバージョンまでの各バージョンのリリースノートを読み、breaking と migration という語を検索します。複数のメジャーバージョンをまたぐアップグレードに対応していないプロジェクトは、リリースノートにその旨を記載しています。また、実行を拒否する migration は、スキーマの一部をすでに変更した後で初めてそのことを通知する場合があります。

変更する前に、現在の実行状態を記録します。

docker compose images
docker image inspect --format '{{index .RepoDigests 0}}' postgres:16.4

docker compose images には、各サービスが現在使用しているイメージとタグが表示されます。イメージを正確に指定できるのは digest だけです。タグはいつでも別のイメージを指すように変更できるためです。

上のセクションで作成したバックアップを取得し、サーバーの外部へコピーします。patch release の場合も同様にします。準備を怠るのは、低コストで済むアップグレードです。

次に、compose ファイルでバージョンを固定します。latest はバージョンではないためです。

services:
  db:
    image: postgres:16.4

image: postgres:latest では、docker compose pull がそのタグが現在指しているものを取得します。そのため、昨日実行していたものを指定する方法がありません。タグを固定すると、アップグレードは 1 行の編集になります。その内容は git diff で確認でき、もう 1 回編集すれば元に戻せます。アプリケーションイメージも同じ方法で固定し、プロジェクトのリリースページから正確なバージョンを指定します。

イメージを取得して再作成します。

docker compose pull
docker compose up -d --wait

docker compose up -d はファイルと実行中のコンテナを比較し、イメージまたは設定が変更されたサービスだけを再作成します。named volume には変更を加えないため、新しいコンテナは既存のデータを使用して起動します。これがこの作業の目的です。同時にリスクでもあります。新しいバージョンの初回起動時に、通常はスキーマ migration が実行されるためです。

実行状況を監視します。

docker compose ps -a
docker compose logs -f --tail=100 app

通常の docker compose ps では、実行中のコンテナだけが表示されます。そのため、失敗したコンテナは一覧から消えます。-a を指定すると、失敗したコンテナも一覧に残ります。exited (1) またはその他の 0 以外のコードが STATUS 列に表示され、理由はログの末尾に記録されます。migration のエラーはそこには明確に表示されますが、それ以外の場所では確認できません。ログが落ち着いたら、ログインしてアプリを 1 分ほど操作します。

docker compose pull が no space left on device で停止する場合、通常の原因は古いイメージレイヤーです。未使用の Docker イメージを削除する と空き容量を確保できます。削除はアップグレードが正常に動作することを確認した後に行い、事前には行わないでください。高速なロールバックでは、古いイメージレイヤーを使用するためです。

アップグレードに失敗した場合のロールバック方法

ケースは2つあり、必要な対応量は大きく異なります。新しいバージョンでスキーマが変更されていなければ、ロールバックは1行で済みます。compose ファイルの古いタグに戻し、docker compose up -dを実行します。コンテナは置き換えられますが、ボリュームはそのまま残り、古いコードで書き込んだデータを読み取れます。

新しいバージョンでスキーマが移行された場合、古いコードでは読み取れなくなります。マイグレーションは前方移行を前提に記述されており、ダウングレード用スクリプトを提供していないプロジェクトがほとんどです。そのため、古いバージョンは起動しても、名前を変更または削除されたカラムに対する最初のクエリで失敗し、ERROR: column "avatar_url" does not existのようなエラーが発生します。復旧には、pull 前に取得したダンプを使います。古いタグに戻し、データベースボリュームを取り外して空の状態で作り直し、ダンプを復元してから起動します。そのダンプがなければ、復旧する方法はまったくありません。だからこそ、pull の前にバックアップを取得します。

Postgres のメジャーバージョン変更は、この問題が最も顕著に現れるケースです。ロールバック時ではなく、アップグレード時に失敗するため、混乱しやすい点にも注意してください。メジャーリリースではシステムテーブルの配置が変わることが多く、各データディレクトリには作成元のメジャーバージョンが記録されています。そのため、ユーザーデータのファイル形式自体はほとんど変わらなくても、別のメジャーバージョンのサーバーはそのデータディレクトリを開けません。postgres:16.4をpostgres:17.2に変更し、docker compose up -dを実行すると、新しいサーバーは起動を拒否します。

FATAL:  database files are incompatible with server
DETAIL:  The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.2.

イメージはpg_upgradeを自動的には実行しません。Compose スタック内で最も簡単な手順は、ダンプ、置き換え、復元です。古いバージョンを起動したままダンプを取得し、docker compose downを実行してデータベースボリュームを削除し、新しいタグを設定します。続いて、docker compose createで空のデータディレクトリを作成し、データベースを起動してダンプを復元し、残りのサービスを起動します。新しいタグが18以降の場合は、ボリュームのマウント先も変更します。PostgreSQL 18以降では、公式イメージは/var/lib/postgresql/18/dockerのようなバージョン固有のディレクトリにデータを保存し、そのボリュームは/var/lib/postgresqlであり、/var/lib/postgresql/dataではありません。新しいメジャーバージョンで実際のトラフィックを1日処理するまで、古いダンプを保持してください。同じメジャーバージョン内のマイナーアップグレード、たとえば16.4から16.9への更新では、これらの作業は不要です。マイナーリリースではダンプと復元が必要なく、コンテナをそのまま起動できるためです。

VPS のスナップショットはバックアップですか?

スナップショットはバックアップの代わりではなく、補完するものです。両者は異なる方法で失敗します。スナップショットはハイパーバイザー上でディスク全体をコピーするため、バックアップし忘れた部分も含め、マシン全体を数分で元に戻せます。そのため、特定の用途に適しています。アップグレードでサーバーが壊れ、20 分前の状態に戻したい場合です。

それ以外の用途には適していません。復元単位がマシン全体なので、削除したテーブル 1 つを復旧するには、サーバー全体をどこかに復元して、その中からテーブルを取り出す必要があります。保持期間も通常は短いです。コピーは通常、サーバーと同じプロバイダーアカウントに保存されるため、アカウントを失うとサーバーとスナップショットを同時に失います。また、稼働中のマシンのスナップショットでは、データベースが書き込み途中の状態になる可能性があります。そのため、データベースは初回起動時にクラッシュリカバリを実行し、処理中だったトランザクションは失われます。

両方を使用してください。スナップショットは、アップグレード作業中に変更を元に戻すための手段です。ダンプは、アカウントを削除されても残るコピーです。スナップショットとバックアップの違いでは、それぞれが実際にどの障害をカバーするかを説明しています。同じバックアップディレクトリがあれば、スタックを新しい VPS に移行する作業も、記憶を頼りに再構築するのではなく、定型的な手順として実行できます。

発生する問題と確認できる内容

down の volumes フラグ。 docker compose down -v はファイルで宣言された名前付きボリュームを削除し、Compose は Volume myapp_db_data Removed と表示して確認します。取り消しはできません。通常の docker compose down では、ボリュームはそのまま残ります。長い形式の docker compose down --volumes を入力し、破壊的なフラグを明示的に指定するようにしてください。

マジック文字列がないダンプ。 pg_restore: error: did not find magic string in file header は、そのファイルがアーカイブではないことを示します。よくある原因は docker compose exec に -T がないことです。TTY が接続されていると、ストリームがシェルに渡る途中で変換され、バイナリダンプが破損するためです。-T を指定してダンプを取り直し、head -c 5 で先頭 5 バイトを確認してください。

変更されないパスワード。 リストア後の FATAL: password authentication failed for user "appuser" は、.env とデータディレクトリが異なる時点のものであることを示します。イメージがこのパスワードを設定するのは、空のデータディレクトリを作成するときだけです。そのため、後から .env を編集しても、データベース内部は変わりません。一致する .env をリストアするか、ALTER USER でデータベース内のパスワードを変更してください。

2 つ目の空のボリューム。 Docker は必要に応じてボリュームを作成します。そのため、s がない状態で docker run -v myapp_upload:/data を実行すると、新しく空のボリュームに書き込み、成功したと報告します。docker volume ls を実行すると、2 つの名前が表示され、そのうち 1 つには何も入っていません。ボリューム名は記憶で入力せず、docker volume ls からコピーしてください。

本番環境を対象にしたリストア。 /srv/myapp-restore ではなく /srv/myapp でリストアコマンドを実行すると、バックアップで稼働中のデータを上書きします。どちらの環境でもコマンドは同じに見えます。各リストアコマンドの前に pwd を確認し、検証作業は専用のディレクトリで行ってください。

FAQ

docker compose down でデータは削除されますか?

いいえ。docker compose down はコンテナとデフォルトネットワークを削除しますが、名前付きボリュームと bind mount には影響しません。docker compose down -v はファイルで定義した名前付きボリュームを削除するため、この操作は元に戻せません。bind mount はホスト上のディレクトリなので、Compose が削除することはありません。バックアップ中にサービスだけを停止し、それ以外を変更したくない場合は、代わりに docker compose stop を使用してください。

pg_dump を実行せずに Postgres のデータディレクトリをコピーできますか?

コンテナを停止している場合に限り可能です。サーバーの実行中はファイルが変更されるため、コピーに異なる時点の内容が混在し、復元しても再現できない状態になることがあります。ファイル単位のコピーは、1 つの Postgres メジャーバージョンにも依存するため、別のバージョンでは起動できません。コンテナを停止し、ボリュームをアーカイブしてから再度起動してください。ただし、そのコピーは唯一のバックアップではなく、迅速な再構築手段として扱います。移植性のあるコピーであり、実際に復元に使用するのはダンプです。

Compose で Postgres を新しいメジャーバージョンにアップグレードするにはどうすればよいですか?

タグを変更するだけでは不十分です。新しいサーバーは古いデータディレクトリでの起動を拒否し、The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.2 をログに出力します。古いバージョンを実行したまま pg_dump を実行し、続いて docker compose down を実行します。その後、データベースボリュームを削除して新しいタグを設定し、docker compose create を実行して空のボリュームを作成します。データベースを起動し、ダンプを復元してください。新しいバージョンが実際のネットワークトラフィックを処理するまで、古いダンプを保持します。

バックアップはどのくらいの頻度で実行し、どのくらいの期間保持すべきですか?

やり直してもよい作業量に合わせて間隔を決めます。個人または小規模チームの構成では、毎晩のバックアップが適しています。さらに、アップグレードの直前には手動バックアップを 1 回追加します。保持期間については、すぐには気付かなかった障害をカバーできるだけの履歴を残してください。金曜日に破損したテーブルが見つかった場合、木曜日の夜のコピーでは役に立たないためです。restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune は妥当な開始方針です。スケジュールにかかわらず、四半期に 1 回はそのバックアップから復元してください。これを実行するまでは、バックアップではなくファイルを保持しているだけです。

バックアップを取得するために、スタック全体を停止する必要がありますか?

通常は必要ありません。データベースダンプはサーバーの実行中でも整合性が保たれるため、データベースを停止する必要はありません。問題になるのはボリュームです。アプリが uploads ディレクトリのようなファイルを追加するだけなら、実行中のアーカイブでも十分安全です。ファイルをその場で書き換える場合は、コピーの間だけ docker compose stop app でそのサービスを停止し、完了後に再度起動してください。データベースを稼働させたままアプリだけを停止する方法が、通常は確保できる最短の安全な停止時間です。

この記事は役に立ちましたか?