読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第3節 Docker Composeで組み合わせる

3.4 起動の待ち合わせ

docker compose up のあと、api のログに次のように表示されることがあります。

api-1  | psycopg.OperationalError: connection failed: Connection refused

depends_on: - db は、db のコンテナを先に起動する、という順番だけを決めます。PostgreSQLは、コンテナが起動してから接続を受け付けるまで、数秒かかります。その間に api が接続しようとすると、断られます。

データベースが接続を受け付けるようになるまで待つには、db に「準備ができたか」を確かめる方法(healthcheck)を書き、api の depends_on で、その結果を待つよう指定します。

services:
  db:
    image: postgres:17
    # (environment と volumes は 3.1 と同じ)
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U renshu -d komorebi"]
      interval: 5s
      timeout: 3s
      retries: 10

  api:
    build: ./reservation-api
    # (env_file と ports は 3.1 と同じ)
    depends_on:
      db:
        condition: service_healthy

pg_isready は、PostgreSQLが接続を受け付けるかを確かめるコマンドです。5秒ごとに確かめ、成功すると db は healthy という状態になり、そのあとで api が起動します。

docker compose ps
NAME                 SERVICE   STATUS                    PORTS
komorebi-app-api-1   api       Up 3 seconds              127.0.0.1:8000->8000/tcp
komorebi-app-db-1    db        Up 12 seconds (healthy)   5432/tcp
解答
  1. 残る
  2. 残る。down はコンテナを消しますが、ボリュームは残ります。同じ名前のボリュームが、新しいコンテナにつながります
  3. 残らない。-v でボリュームも消え、空のデータベースが作られます。表を作る移行(alembic upgrade head)から、やり直しになります

17 / 36