SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor ・更新日 2026-10-18

データベースはDockerで実行すべき?本番環境の注意点

Postgres、MySQL、MongoDB、RedisをDockerで運用する際のリスクを解説します。ボリューム設定、バージョンアップ、バックアップ、メモリ制限の管理が不十分だとデータ消失や障害の原因になります。本番環境で安全にコンテナ化するための運用ポイントをまとめました。

データベースは Docker で実行すべきですか、それともホストで実行すべきですか?

データベースは Docker で実行します。1 台の VPS で 1 つのアプリケーションスタックを運用する場合、コンテナ化した PostgreSQL、MySQL、MongoDB、Redis は一般的な本番環境の選択肢です。この点について議論される内容は、通常、論点がずれています。コンテナは、namespace と cgroup で囲まれた Linux プロセスであり、仮想マシンではありません。そのため、データベースとディスクの間にハイパーバイザーはありません。bind mount またはローカルの named volume を使用すれば、読み書きはホストのファイルシステムに反映されます。これは、パッケージをインストールした場合に使用されるファイルシステムと同じです。

本当のコストは運用にあります。この構成が問題ないか、遅い障害につながるかを決めるのは、次の 4 点です。データの保存場所、そのディレクトリの所有者、メジャーバージョンアップグレードの手順、そしてバックアップを実際にリストアした経験の有無です。これらを適切に管理できれば、コンテナは細部にすぎません。管理を誤ると、原因としてコンテナを責めることになります。

この判断は、サーバー上で実行するすべてのデータベースに共通します。以下の例では PostgreSQL、MySQL、MongoDB、Redis を使用し、重要な製品固有の違いについては該当箇所で説明します。

コンテナによって実際に変わること

ストレージパスは、ボリュームをマウントしている限り変わりません。同じカーネル、同じページキャッシュ、同じファイルシステムです。

実際の性能上の落とし穴は 1 つだけで、何もマウントしない場合です。ボリュームがないと、データディレクトリはコンテナの書き込み可能レイヤーに保存されます。これはイメージの上に重ねられたオーバーレイファイルシステムです。そこへの書き込みは遅く、コンテナを削除するとレイヤー全体も削除されます。「今朝、データベースが空になっていた」という問題は、ここから発生します。

実際に変わるのは次の点です。

  • ライフサイクル。docker compose down はコンテナを破棄します。ボリュームに保存されていないものはすべて失われます。
  • バージョン。イメージタグがバージョンです。データベースコンテナ内に、次の docker compose pull 後も残る apt upgrade はありません。
  • メモリの計上。cgroup の制限は、カーネルが強制する上限です。多くのデータベースのデフォルト値は、この上限に合わせて自動調整されません。MySQL 9.3 以降は、一部の設定で制限値を読み取ります。MongoDB は WiredTiger キャッシュについて制限値を読み取ろうとしますが、場合によっては読み取れない可能性があると公式ドキュメントで警告しています。PostgreSQL と Redis は読み取りません。
  • ユーザー。プロセスはコンテナ内では数値のユーザー ID で実行されます。この ID は、ホスト上では何も所有していない可能性があります。

データの保存場所がすべてを左右します

適切な選択肢は2つあり、よくある誤りが1つあります。

  • 名前付きボリューム: pgdata:/var/lib/postgresql/data。Docker は /var/lib/docker/volumes/<project>_pgdata/_data にディレクトリを作成し、イメージの entrypoint が初回起動時に所有権を設定します。通常はこれを選択します。
  • bind mount: /srv/appname/pg:/var/lib/postgresql/data。パスを自分で指定するため、権限の管理も自分で行う必要があります。
  • マウントしない。前述のとおりです。データはコンテナ内に保存されます。

詳細なトレードオフは別のテーマであり、bind mount と名前付きボリュームの比較で説明しています。データベースについて簡潔に言えば、ホスト上のパスを把握する明確な理由がない限り、名前付きボリュームを使用してください。bind mount を使用する場合は、/srv/appname/pg のような安定した場所に配置します。git clean がアクセスできるプロジェクトディレクトリ内は避けてください。

ネットワークストレージの使用には注意が必要です。NFS(network file system)や、ロックと fsync の動作をテストしていないその他のネットワークマウントには、データベースのデータディレクトリを配置しないでください。PostgreSQL は、NFS について hard オプションを使用したマウントを必須要件として定めています。また、NFS サーバーでは sync export オプションを強く推奨しています。このオプションがない場合、クライアント上の fsync がサーバーのディスクに到達する保証がないためです。データベースは、成功した fsync によってバイト列が安定したストレージに書き込まれたとみなします。この前提が誤っていると、数週間後に破損が発生します。

ボリュームが見えなくなる前に、ボリューム名を固定する

Compose はボリュームに <project>_<volume> という名前を付け、プロジェクト名はデフォルトでディレクトリ名になります。そのため、ボリュームの識別情報は、何気なく変更されることがあるディレクトリ名に依存します。

/srv/app を /srv/app-old に移動するか、compose ファイルの pgdata キーの名前を変更すると、次回の docker compose up -d で新しい空のボリュームが作成されます。Postgres はそのボリュームに新しいクラスタを初期化します。コンテナは正常で、アプリケーションも起動しますが、すべてのテーブルが消えます。古いボリュームは古い名前でディスク上に残っています。これは幸いな点です。

docker volume ls
docker volume inspect app_pgdata

この問題が起きないように、名前を固定します。プロジェクト名とボリューム名を明示的に設定します。

name: myapp

services:
  db:
    image: postgres:17
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:
    name: myapp_pgdata

既存のボリュームにデータが残っている場合は、データベースを停止してからコピーします。

docker compose stop db
docker run --rm -v app_pgdata:/from -v myapp_pgdata:/to alpine sh -c 'cp -a /from/. /to/'
docker compose start db

データベースの実行中にコピーすると、書き込み中のファイルが不完全な状態でコピーされます。先に停止してください。

データディレクトリの所有者

公式の Postgres、MySQL、MongoDB イメージは、権限のない数値ユーザー ID でサーバーを実行します。デフォルトのタグでは 999 で、Postgres の -alpine タグでは 70 です。コンテナが root で起動すると、entrypoint はデータディレクトリの所有権をそのユーザーに変更してから、権限を降格します。そのため、空の bind mount は通常、最初から機能します。

compose ファイルで user: を設定した瞬間に失敗します。この場合、entrypoint に修正に必要な権限が残っていないためです。Postgres はこのことを明確に示します。

initdb: error: could not change permissions of directory "/var/lib/postgresql/data": Operation not permitted

誤った mode で存在するデータディレクトリでは、別のメッセージが表示されます。このメッセージは、修正に chmod を使い、chown は使わないことを示すため、見分ける価値があります。

FATAL:  data directory "/var/lib/postgresql/data" has invalid permissions
DETAIL:  Permissions should be u=rwx (0700) or u=rwx,g=rx (0750).

MongoDB の entrypoint も同じ方法で所有権を修正します。そのため、この lock file エラーは修正できなかったことを意味します。通常は user: が設定されているか、mount が root からの chown を拒否しています。

Unable to create/open the lock file: /data/db/mongod.lock (Permission denied). Ensure the user executing mongod is the owner of the lock file and has the appropriate permissions.

修正するには、ホスト側のディレクトリを名前ではなく数値 ID の所有者に chown します。

sudo chown -R 999:999 /srv/appname/pg
sudo chmod 700 /srv/appname/pg
ls -ldn /srv/appname/pg

ls -ldn は名前ではなく数値を表示するため、999 999 が表示されるはずです。Postgres の -alpine イメージでは、代わりに 70:70 を使い、70 70 が表示されることを確認します。ホスト上の postgres という名前のアカウントと、イメージ内の postgres という名前のアカウントは無関係です。カーネルが比較するのは数値であり、名前はそれぞれの側で別々に解決されます。PUID と PGID がホストのユーザーをコンテナに割り当てる仕組みでは、この対応関係を詳しく説明しています。rootless Docker または user namespace remapping を使用すると数値はさらに変わるため、999 と決めつけず、実行中のコンテナから ID を確認してください。

named volume を使えば、初回起動時に Docker が空のディレクトリを作成して entrypoint が所有権を設定するため、この問題全体を回避できます。

アップグレード: イメージタグの変更を伴うパッケージアップグレード

ホストでは、apt upgrade によりマイナーバージョンを順に更新できます。ディストリビューションがデータベースのメジャーバージョンを自動的に変更することはありません。変更を選択した場合も、2 つのバージョンのバイナリを同時にインストールできます。これはまさに pg_upgrade に必要な動作です。

コンテナでは、タグがバージョンを表します。そのため、アップグレードは 1 行の編集で済みます。マイナーアップグレードは簡単ですが、メジャーアップグレードには手順が必要です。

postgres:16 を postgres:17 に変更して docker compose up -d を実行すると、コンテナはすぐに終了します。

PostgreSQL Database directory appears to contain a database; Skipping initialization
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.

データが破損したわけではありません。新しいバイナリは、メジャーバージョン間で変更される、ディスク上の古いカタログ形式を読み取れません。タグを postgres:16 に戻せば、再び起動します。このロールバックが、コンテナによるアップグレードで得られる唯一の明確な利点です。

サポートされている方法は、ダンプとリストアです。PostgreSQL では、新しいクライアントでダンプを取得することが推奨されています。そのため、新しいイメージから、compose ネットワーク上で稼働中の古いサーバーに対して実行します。

docker run --rm --network myapp_default -e PGPASSWORD="$POSTGRES_PASSWORD" \
  postgres:17 pg_dumpall -h db -U postgres > /srv/backups/all.sql
ls -lh /srv/backups/all.sql
tail -n 2 /srv/backups/all.sql

ファイルは最低でも数十キロバイトのサイズになり、末尾に PostgreSQL database cluster dump complete と記された行が含まれているはずです。数百バイト程度のファイルは、ダンプに失敗したことを示します。そのままでは、何も保存されていないボリュームを削除することになります。確認後にのみ、次を実行します。

docker compose down
docker volume rm myapp_pgdata
# edit the compose file: image: postgres:17
docker compose up -d db
docker compose exec -T db psql -U postgres -f /dev/stdin < /srv/backups/all.sql

postgres:18 でもう 1 つ変更が必要です。18 以降では、公式イメージは /var/lib/postgresql 配下のバージョン別ディレクトリ(18 の場合は /var/lib/postgresql/18/docker)にデータを保存し、/var/lib/postgresql にボリュームを宣言します。/var/lib/postgresql/data にマウントされたままのボリュームを使用すると、コンテナは Error: in 18+, these Docker images are configured to store database data で始まるエラーを出して終了します。18 以降に移行する場合は、マウント先を pgdata:/var/lib/postgresql に変更します。この投稿にある /var/lib/postgresql/data パスは、17 以前のバージョン用です。

他のデータベースエンジンでは動作が異なります。

  • MySQL 8 は起動時に独自のデータディクショナリを更新するため、マイナータグの更新は通常、再起動だけで済みます。リリース系列をまたいで更新する場合は、事前にリリースノートを確認し、どちらの場合も先にダンプを取得してください。
  • MariaDB では、新しいバージョンでサーバーが起動した後に mariadb-upgrade を実行する必要があります。
  • MongoDB は一度に 1 つのメジャーバージョンずつアップグレードする必要があります。各段階の後、次に進む前に feature compatibility version を設定します。バージョンを飛ばすと、mongod は起動を拒否し、featureCompatibilityVersion を示す UPGRADE PROBLEM 行をログに出力します。MongoDB 7.0 以降では、コマンドに明示的な確認フラグが必要です: db.adminCommand({ setFeatureCompatibilityVersion: "8.0", confirm: true })。
  • Redis は古いスナップショットファイルを問題なく読み込めますが、新しいファイルは読み込めません。そのため、アップグレードは再起動で済みますが、ダウングレードではデータの読み込みに失敗することがあります。

一般的な原則は次のとおりです。コンテナではダウングレードは簡単になりますが、アップグレードが簡単になるわけではありません。

データベースコンテナが終了コード 137 で終了するのはなぜですか?

カーネルの out of memory (OOM) killer がコンテナを強制終了したためです。137 は 128 にシグナル 9 を加えた値です。

docker compose ps --all
docker inspect myapp-db-1 | grep -i oomkilled
journalctl -k | tail -n 20

docker compose ps --all は Exited (137) を表示します。--all がない場合、Compose は実行中のコンテナだけを一覧表示します。そのため、停止したデータベースは出力に表示されません。inspect の行には "OOMKilled": true と表示され、カーネルログには対応するエントリが記録されます。

Memory cgroup out of memory: Killed process 4711 (postgres) total-vm:2170416kB

OOMKilled から分かるのは、OOM killer がコンテナ内のプロセスを終了したことだけです。コンテナ自身の制限が原因だったことを示すのは Memory cgroup out of memory プレフィックスです。ホスト全体のメモリ不足の場合は、代わりに Out of memory: Killed process がログに記録されます。その場合、対処すべき場所はコンテナではなくホストです。

仕組みは次のとおりです。意外に思われるかもしれません。コンテナ内でも、free と /proc/meminfo はホストの総メモリを報告し続けます。cgroup の制限によって、この値は変わりません。PostgreSQL はこの値から設定を決めません。shared_buffers のデフォルトは 128MB で、それより大きい値は、利用者またはチューニングガイドが選択した値です。MySQL の innodb_buffer_pool_size のデフォルトも 128M です。問題は、ホストが報告する値を基準に設定を決めた場合に始まります。PostgreSQL の公式ガイダンスでは、システムメモリの 25% を shared_buffers の開始値として推奨しています。そのため、16 GB のホストに 2 GB の制限を設定すると、このルールでは 4 GB になります。ホスト自体に負荷がかかるよりはるか前に、cgroup がデータベースを終了させます。一部のエンジンでは、一部のデフォルト値について制限値を読み取るようになりました。MySQL 9.3 以降が該当し、MongoDB も検出できる場合は WiredTiger キャッシュに制限値を使用します。ただし、どちらもすべての設定をその値から決めるわけではありません。また、MongoDB の公式ドキュメントでは検出に失敗する場合があると説明されています。したがって、メモリ制限だけでは不十分です。データベースが使用できるメモリ量も指定する必要があります。

  • PostgreSQL: shared_buffers を設定し、work_mem に注意します。work_mem は各 sort または hash 操作に適用されます。各接続はこれらを複数同時に実行できるため、余裕のある値に 50 接続を掛けると、起動時ではなく負荷時にコンテナが終了する原因になります。
  • MySQL と MariaDB: デフォルトが 128M の innodb_buffer_pool_size を設定します。9.3 より前の MySQL では、コンテナ内で innodb_dedicated_server を無効にします。これはマシンのメモリからバッファプールのサイズを決めるため、ここでいうマシンのメモリはホストのメモリだからです。9.3 以降では、MySQL はコンテナの制限値を読み取り、innodb_dedicated_server のサイズをその値から決めます。それでも、バッファプールのサイズを明示するほうが予測しやすい設定です。
  • MongoDB: WiredTiger のキャッシュサイズを明示的に設定します。MongoDB は検出できる場合、コンテナの制限値を使用します(hostInfo はそれを memLimitMB として報告します)。ただし、場合によっては検出できない可能性があると公式ドキュメントで警告しており、--wiredTigerCacheSizeGB または --wiredTigerCacheSizePct をコンテナのメモリより小さい値に設定するよう案内しています。
  • Redis: maxmemory のデフォルトは無制限です。そのため、Redis は cgroup に停止させられるまでメモリを使い続けます。maxmemory をコンテナの制限より十分小さい値に設定し、maxmemory-policy を選択します。

Postgres は自身の側でもこのイベントを記録します。ログには次の 2 行が表示されます。

LOG:  server process (PID 123) was terminated by signal 9: Killed
LOG:  terminating any other active sessions due to crash of another server process

1 つのバックエンドが強制終了されると、共有メモリが不整合になっている可能性があるため、ほかのすべてのバックエンドも再起動する必要があります。これはアプリケーションにとって静かなイベントではなく、接続ストームになります。Docker Compose でメモリ制限を設定するでは、構文と mem_limit 形式と deploy.resources 形式の違いを説明しています。

これらの問題がホスト上で消えるわけではありません。場所が移るだけです。cgroup がない場合、データベースはホスト上のほかのすべてのプロセスとリソースを競合します。ホストの OOM killer はスコアに基づいて対象を選ぶため、sshd が終了させられる可能性もあります。データベースを予測可能な形で終了させる制限のほうが、ログインできなくなるホストの OOM より運用しやすくなります。

バックアップ: 内部では dump、外部へバックアップ

稼働中のデータベースのデータディレクトリをコピーしてバックアップしないでください。サーバーが書き込み中に取得したファイル単位のコピーは不完全なコピーになり、復元時になって初めて問題が判明します。

確実な方法は2つあります。データベース固有のツールで稼働中に dump を取得し、その dump をバックアップする方法です。もう1つは、コンテナを停止して volume を停止状態でコピーする方法です。

docker compose exec -T db pg_dump -U postgres -Fc appdb > /srv/backups/appdb.dump
docker compose exec -T db mysqldump -u root -p"$MYSQL_ROOT_PASSWORD" --single-transaction --all-databases > /srv/backups/mysql.sql
docker compose exec -T db mongodump --archive --gzip --db appdb > /srv/backups/appdb.archive.gz
docker compose exec -T redis redis-cli BGSAVE

-Tが重要です。これがないと、docker compose execがコマンドに端末を接続でき、端末層が出力ストリームに復帰改行を追加します。すると、テキスト dump は復元時に不自然なエラーになり、バイナリ dump は単純に破損します。バックアップ時には何も報告されず、1か月後に大きなエラーとして発覚します。

--single-transactionにより、mysqldumpはサーバー全体をロックせずに InnoDB テーブルの一貫したスナップショットを取得できます。

これらのコマンドは、それぞれ1つのファイルを書き出します。これらはバックアップシステムではありません。保持期間の管理、外部へのコピー、検証がないためです。3つすべてを実行するツールに dump ディレクトリを渡してください。VPS からの restic バックアップはそのためのものです。バックアップするのは/srv/backupsであり、/var/lib/docker/volumesではありません。

次に復元を実行してください。一度も復元していないバックアップは、バックアップとはいえません。

docker compose exec -T db createdb -U postgres restore_test
docker compose exec -T db pg_restore -U postgres -d restore_test < /srv/backups/appdb.dump
docker compose exec -T db psql -U postgres -d restore_test -c '\dt'

\dtには、アプリケーションのテーブルが一覧表示されるはずです。結果が空、またはDid not find any relations.の場合、dump の内容が想定と異なります。完了したらrestore_testを削除してください。

すべてを削除するコマンド

docker compose down -v.

通常の down は、コンテナとネットワークを削除します。-v は、その Compose ファイルで宣言された名前付きボリュームに加え、それらのコンテナに接続されたすべての匿名ボリュームも削除します。確認プロンプトは表示されず、元に戻すこともできません。これは self-hosted データベースが破壊される最も一般的な原因です。通常は、無関係な問題のトラブルシューティング中に、フォーラムの回答に従って実行してしまうことで発生します。

影響範囲を抑える方法は 4 つあります。

  • データベースのボリュームを external: true として宣言します。Compose は自身が所有していないボリュームを削除しないため、-v からそのボリュームに到達できません。docker volume create myapp_pgdata で 1 回作成します。
  • 通常の再起動には docker compose stop と docker compose start を使用します。Compose における down と stop の違い で、それぞれが削除する対象を説明しています。
  • ダンプは、Compose が管理するすべてのボリュームの外側にあるホストパスへ保存します。
  • 重要なデータを保持する stack に、トラブルシューティングの回答から -v を貼り付けて実行してはいけません。

データベースのポートを公開しない

この行により、データベースがパブリックインターネットに公開されます。

    ports:
      - "5432:5432"

すべてのインターフェースで待ち受ける設定です。Docker は、ファイアウォールの input ルールがパケットを確認する前に、宛先を書き換えてポートを公開します。ufw のルールは input chain にあるため、ufw deny 5432 はまったく機能しません。Docker の公開ポートが ufw をバイパスする理由で、chain の通過順序を確認できます。

同じ compose project 内のアプリケーションは、compose network 上で service name を使ってデータベースに接続できます。そのため、公開ポートは不要です。このブロックを削除してください。ホスト上のクライアントから接続する場合は、loopback のみにバインドします。

    ports:
      - "127.0.0.1:5432:5432"

実際に待ち受けているポートを確認します。

sudo ss -ltnp | grep 5432

127.0.0.1:5432 であれば適切です。0.0.0.0:5432 の場合は、誰でもパスワードを試せます。

どこで何を実行するか

1 台の VPS で 1 つのアプリケーションを運用する場合。 コンテナを使用します。名前を固定した名前付きボリュームを割り当て、ポートは公開しません。メモリ上限を設定し、データベース側にも対応する設定を適用します。毎晩、ホスト上のパスへダンプを取得し、restic で収集します。VPS にクリーンな Docker 環境を構築するから始め、スタックは 1 つの compose ファイルにまとめてコミットします。データベースのバージョンを git でレビュー可能な行として管理できる点が大きな利点です。

1 台のホストで複数のサービスを運用する場合。 コンテナを使用し、アプリケーションごとに 1 つのデータベースを用意します。すべてのアプリケーションで 1 つの共有サーバーを使う構成にはしません。共有サーバーでは、すべてのアプリケーションが 1 つのアップグレードスケジュールに依存し、1 つの暴走したクエリが全アプリケーションの障害になります。各コンテナに個別のメモリ上限を設定し、問題のあるクエリをそれを発行したアプリケーション内に封じ込めます。小規模な Postgres インスタンスを複数運用するほうが、ディスクコストは少し増えますが、調整作業は大幅に減ります。

データベース自体が製品である場合。 ベンダーのパッケージリポジトリからホストにインストールするか、マネージドサービスを利用します。pg_upgrade ではバイナリの 2 つのメジャーバージョンを同時にインストールする必要があります。これはパッケージで実現できますが、単一バージョンのイメージでは実現できません。WAL(先行書き込みログ)のアーカイブを使用したレプリケーションとポイントインタイムリカバリは、データベースがマシンとディスクを専有しているほうが、どちらも容易です。03:00 に自分へ通知が届くシステムには、堅実な方法を選択します。

アプリケーションが小規模な場合。 サーバーデータベースを使わない構成を検討します。1 台の VPS 上で単一の書き込み元を持つ Web アプリケーションでは、VPS の本番環境で SQLite を使用するほうが適していることがよくあります。この場合、バックアップ対象は 1 つのファイルで、アップグレード経路はライブラリのバージョン更新になります。

FAQ

本番データベースを Docker で実行しても安全ですか?

単一サーバーのアプリケーションスタックであれば安全です。コンテナは、namespace と cgroup で隔離された Linux プロセスです。そのため、volume をマウントすれば、パッケージからインストールした場合と同じホストのファイルシステムへデータベースが書き込みます。リスクは速度ではなく、運用に関するものです。volume 名が固定されていないこと、bind mount の所有者が誤った user id になっていること、復元を一度もテストしていないこと、そして docker compose down -v が該当します。この 4 つを解消すれば、コンテナで問題ありません。データベースが主なワークロードで、pg_upgrade、レプリケーション、または point-in-time recovery が必要な場合は、ホストへのインストールに移行してください。

データベースのデータには bind mount と named volume のどちらを使うべきですか?

ホスト上のパスを把握する必要がある明確な理由がない限り、named volume を使ってください。Docker がディレクトリを作成し、初回起動時に image の entrypoint が所有権を設定するため、権限の問題は発生しません。明示的な name: で volume を固定するか、external: true として指定してください。指定しないと、プロジェクトディレクトリの名前を変更したときに、新しい空の volume と空のデータベースが暗黙的に作成されます。ホストのディレクトリを、image が実行する numeric user id に対して chown すれば、bind mount でも問題ありません。公式の Postgres、MySQL、MongoDB image のデフォルト tag では 999、Postgres の -alpine tag では 70 です。ls -ldn で確認してください。ls -l は、その番号に対するホスト側の名前を表示しますが、その名前はコンテナ内では意味を持ちません。

docker compose down -v は何を削除しますか?

通常の down と同様にコンテナと network を削除します。さらに -v は、その compose ファイルで宣言されたすべての named volume と、これらのコンテナに接続されたすべての anonymous volume を削除します。データベースも削除対象です。確認プロンプトは表示されず、復元もできません。external: true と指定された volume は削除されません。これが、データベースの volume を external として指定する主な理由です。通常の再起動には、docker compose stop と docker compose start を使用してください。

Docker で PostgreSQL を新しい major version にアップグレードするにはどうすればよいですか?

dump と restore を行います。postgres:16 を postgres:17 に変更して再起動すると、FATAL: database files are incompatible with server が発生し、DETAIL 行に両方の version が表示されます。新しい binary は古い catalog layout を読み取れないためです。データが破損したわけではありません。古い tag に戻せば起動します。稼働中の古いコンテナに対して新しい version の client を使用し、pg_dumpall を取得してください。ファイルが PostgreSQL database cluster dump complete で終わっていることを確認し、新しい tag を空の volume で起動して dump を読み込みます。postgres:18 以降は、その volume を /var/lib/postgresql にマウントし、/var/lib/postgresql/data にはマウントしないでください。同じ major version 内の minor upgrade では、pull と再起動だけで済みます。

データベースコンテナが終了コード 137 で終了するのはなぜですか?

137 は 128 に signal 9 を加えた値であるため、プロセスが強制終了されています。docker inspect <container> | grep -i oomkilled を実行してください。true の値は、OOM killer がコンテナ内のプロセスを終了したことを示します。通常は、コンテナが独自の cgroup memory limit に達したことが原因です。一般的な原因は、ホスト向けに設定した memory 設定を使用していることです。コンテナ内のツールはホスト全体の memory を報告するため、16 GB 用の buffer が 2 GB のコンテナ内に収まろうとします。shared_buffers と work_mem を設定するか、innodb_buffer_pool_size を設定して、コンテナに割り当てた limit に合わせてください。journalctl -k で対応する Memory cgroup out of memory 行を確認し、kernel が終了させたプロセスと、原因がホスト全体の Out of memory kill ではなくコンテナの limit であることを確認します。

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