Docker Compose実践｜Webアプリ+DB+リバースプロキシの本番構成を作る

第6章のクロージング。6-1〜6-5 で学んだ要素を全部乗せした実戦構成を組みます。題材は「ブラウザ → nginx → FastAPI → PostgreSQL」の典型3層。

目次

1. 構成図
2. ディレクトリ構成
3. .env を作る
4. アプリのコード（FastAPI最小）
5. アプリのDockerfile
6. nginx設定
7. compose.yml 完成形
8. 起動してブラウザ確認
9. 日常操作
10. まとめ

1. 構成図

2. ディレクトリ構成

myapp/
├── compose.yml
├── .env                        ← DB_PASSWORD など
├── .env.example                ← Gitに入れる雛形
├── .gitignore                  ← .env を除外
├── nginx/
│   └── default.conf
└── app/
    ├── Dockerfile
    ├── main.py
    └── requirements.txt

3. .env を作る

# .env
DB_PASSWORD=s3cret_change_me
APP_PORT=80

# .env.example（Git コミットするひな形）
DB_PASSWORD=put-your-password-here
APP_PORT=80

# .gitignore
.env

4. アプリのコード（FastAPI最小）

# app/main.py
import os
import psycopg
from fastapi import FastAPI

app = FastAPI()
DATABASE_URL = os.environ["DATABASE_URL"]

@app.get("/")
def root():
    return {"message": "Hello from FastAPI 🎉"}

@app.get("/health")
def health():
    return {"status": "ok"}

@app.get("/dbcheck")
def dbcheck():
    with psycopg.connect(DATABASE_URL) as conn:
        with conn.cursor() as cur:
            cur.execute("SELECT version();")
            version = cur.fetchone()[0]
    return {"postgres": version}

# app/requirements.txt
fastapi==0.115.0
uvicorn[standard]==0.32.0
psycopg[binary]==3.2.3

5. アプリのDockerfile

# app/Dockerfile
FROM python:3.12-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

EXPOSE 8000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

6. nginx設定（リバースプロキシ）

# nginx/default.conf
server {
    listen 80;

    location / {
        proxy_pass http://app:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

ここでの http://app:8000 の「app」は、Compose が自動で名前解決するサービス名（5-1／5-2 で学んだ仕組み）。

7. compose.yml 完成形

# compose.yml
services:
  proxy:
    image: nginx:1.27
    ports:
      - "${APP_PORT}:80"
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on:
      - app
    networks:
      - frontend-net
    restart: unless-stopped

  app:
    build: ./app
    environment:
      DATABASE_URL: postgres://postgres:${DB_PASSWORD}@db:5432/postgres
    depends_on:
      db:
        condition: service_healthy
    networks:
      - frontend-net
      - backend-net
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"]
      interval: 10s
      timeout: 3s
      retries: 5
      start_period: 10s

  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - pgdata:/var/lib/postgresql/data
    networks:
      - backend-net
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 3s
      retries: 10
      start_period: 10s

volumes:
  pgdata:

networks:
  frontend-net:
  backend-net:

8. 起動してブラウザ確認

# 構成検証
docker compose config -q

# 一括起動（ビルドも）
docker compose up -d --build

# 状態確認
docker compose ps
# proxy: Up ... 0.0.0.0:80->80/tcp
# app:   Up ... (healthy)
# db:    Up ... (healthy)

ブラウザで http://localhost/ を開くと：

/dbcheck にアクセスすると PostgreSQL のバージョン文字列が返ります：

9. 日常操作

# コード変更後の再デプロイ
docker compose up -d --build app

# アプリのログを追跡
docker compose logs -f app

# DB に psql で入る
docker compose exec db psql -U postgres

# 単発マイグレーション
docker compose run --rm app python -c "print('migrate here')"

# 完全停止
docker compose down

# 完全リセット（DBデータも消える！）
docker compose down -v

10. まとめ

第6章をクリアしたあなたは、以下ができるようになりました：

参考リンク

• Compose（公式） — 本章全体の一次情報源。
• FastAPI 公式 — サンプルで使ったWebフレームワーク。
• Docker Hub: postgres — 環境変数・初期化スクリプト配置の公式仕様。

Dockerの基礎を動画で体系的に学びませんか？

実務で使う基礎だけを3時間に凝縮。環境構築から丁寧に解説しています。

クーポン割引で講座を見る →