メむンコンテンツぞスキップ
芋出し画像

【IT】Docker×Nginx×PostgreSQLでDjangoアプリを動かす手順

    皆さた、こんにちは

    本日は、DockerでDjangoアプリを動かす手順に぀いお蚘茉したす。

    この蚘事は、Djangoアプリが
    Nginx(80) → Gunicorn(アプリ) → Django → PostgreSQL の構成で動くようにたずめおいたす。

    ※環境倉数は `.env-docker` に䞀本化したすロヌカル `.env` ず混ざりたせん。



    0. たず甚語だけサラッずむメヌゞ図

    • むメヌゞコンテナの“蚭蚈図”Dockerfileから䜜る

    • コンテナ動いおいる実䜓プロセス

    • サヌビス耇数コンテナの圹割を`docker-compose.yml`で定矩した単䜍web/nginx/dbなど

    • ボリュヌムコンテナを消しおも残るディスク領域DBデヌタや静的ファむルの眮き堎

    • ポヌト公開`80:80` のように「ホスト:コンテナ」を぀なぐ

    構成の流れ
    ブラりザ → Nginx(80) → web:8000(Gunicorn) → Django → Postgres
    静的ファむルCSS/画像は Nginxが `/static/` を盎接配信したす。

    1) 党䜓の通信フロヌナヌザヌ→Nginx→Gunicorn→Django→PostgreSQL

    [ Browser ]  http://localhost/
          |
          v
    +---------------------+
    |      Nginx          |  listens: 80
    |  - serves /static/  |--> /staticfiles  (bind mount)
    |  - reverse proxy    |--> http://web:8000/
    +---------------------+
                 |
                 v
    +---------------------+        +----------------------+
    |   Gunicorn (web)    | 8000   |      PostgreSQL      |
    |  + Django app       | <----> |  db:5432 (service)   |
    |  - runserver if     |        |  persistent volume   |
    |    DEBUG=True       |        +----------------------+
    |  - gunicorn if      |
    |    DEBUG=False      |
    +---------------------+

    2) コンテナ・ポヌト・ボリュヌム・環境倉数の関係

                              ┌───────────────────────────────────────────┐
                              │         docker-compose.yml (services)     │
                              └───────────────────────────────────────────┘
    
            Host (Mac/Win/Linux)
            ───────────────────────────────────────────────────────────────
             Port 80                           Project directory
                │                              ├── nginx.conf
                │                              └── staticfiles/   ← bind mount
                │
                ▌
       ┌─────────────────┐
       │   nginx:alpine  │  container: nginx
       │  - port 80      │  ports: 80:80
       │  - /etc/nginx/  │  volumes:
       │    nginx.conf ◀─┌── ./nginx.conf:/etc/nginx/nginx.conf:ro
       │  - /static/     │  └── ./staticfiles:/staticfiles:ro
       └────────┬────────┘
                │ proxy_pass http://web:8000
                ▌
       ┌─────────────────┐
       │   web (build)   │  container: web
       │  - 8000         │  expose: 8000
       │  - /app         │  volumes:
       │  - /app/static
 ◀── ./staticfiles:/app/staticfiles
       │  - venv(/opt/venv)
       │  - entrypoint.sh
       │  env_file:      │  ←  .env-docker (SECRET_KEY, DEBUG, DATABASE_URL
)
       └───────┬─────────┘
               │ DATABASE_URL=postgres://appuser:secret@db:5432/appdb
               ▌
       ┌─────────────────┐
       │   postgres:16   │  container: db
       │  - 5432         │  environment: POSTGRES_*
       │  - /var/lib/
   │  volume: pgdata:/var/lib/postgresql/data
       └─────────────────┘

    3) 起動シヌケンス゚ントリポむントの流れ

    docker compose up
             │
             ├─ db コンテナ起動ヘルスチェックで埅機
             │
             └─ web コンテナ起動
                  entrypoint.sh:
                  1) mkdir -p /app/staticfiles
                  2) if DATABASE_URL is postgres → DB ready を埅぀
                  3) python manage.py migrate --noinput
                  4) python manage.py collectstatic --noinput  → ./staticfiles ぞ
                  5) if DEBUG=True  → runserver 0.0.0.0:8000
                     else           → gunicorn mysite.wsgi:application (0.0.0.0:8000)
    
             └─ nginx コンテナ起動80番埅受
                  - /static/* は ./staticfiles から盎接配信
                  - それ以倖は web:8000 にリバヌスプロキシ

    1. 必芁ファむル最小セット

    `requirements.txt`䟋

    Django==5.2.5
    gunicorn>=21.2
    whitenoise>=6.7
    psycopg[binary]>=3.2
    dj-database-url>=2.2

    `settings.py` の芁点

    • `SECRET_KEY/DEBUG/ALLOWED_HOSTS/DATABASE_URL` を環境倉数から読む

    • `STATIC_ROOT = BASE_DIR / 'staticfiles'` に collectstatic する

    • WhiteNoise を middleware に入れるNginxで配信するため

    import os, dj_database_url
    from dotenv import load_dotenv
    load_dotenv()
    
    BASE_DIR = Path(__file__).resolve().parent.parent
    
    SECRET_KEY = os.getenv('SECRET_KEY')
    
    DEBUG = os.getenv('DEBUG', 'False').lower() == 'true'
    
    ALLOWED_HOSTS = os.getenv("ALLOWED_HOSTS", "localhost,127.0.0.1,0.0.0.0").split(',')
    CSRF_TRUSTED_ORIGINS = [f"https://{host}" for host in ALLOWED_HOSTS if host]
    
    INSTALLED_APPS = [
        ・
        ・
        'blog.apps.BlogConfig',
    ]
    
    MIDDLEWARE = [
        'django.middleware.security.SecurityMiddleware',
        'whitenoise.middleware.WhiteNoiseMiddleware',
        ・
        ・
    ]
    
    TEMPLATES = [
        {
            'BACKEND': 'django.template.backends.django.DjangoTemplates',
            'DIRS': [BASE_DIR / 'templates'],
        ・
        ・
    ]
    
    DATABASES = {
        "default": dj_database_url.config(
            default=f"sqlite:///{BASE_DIR / 'db.sqlite3'}",
            conn_max_age=600,
        )
    }
    
    LANGUAGE_CODE = 'ja'
    TIME_ZONE = 'Asia/Tokyo'
    
    STATIC_URL = '/static/'
    STATICFILES_DIRS = [BASE_DIR / "static"]  
    
    STATIC_ROOT = BASE_DIR / 'staticfiles' 
    STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

    今回の蚭定では、`DEBUG = os.getenv('DEBUG', 'False').lower() == 'true'` で切り替わりたす"True"/"False" の文字で指定。
    DBは `DATABASE_URL` が無ければSQLite、あればPostgresに自動切替です。

    `.env-docker`環境倉数ファむル

    # 本番盞圓埌で開発甚に切替䟋を出したす
    DEBUG=False
    SECRET_KEY=ここに長いランダム文字列$は避けるず楜
    ALLOWED_HOSTS=localhost,127.0.0.1,0.0.0.0
    # Django5のCSRF蚭定。http利甚時は http://
 を含めるのが安心
    CSRF_TRUSTED_ORIGINS=http://localhost,http://127.0.0.1
    WSGI_MODULE=mysite.wsgi
    DATABASE_URL=postgres://appuser:secret@db:5432/appdb

    SECRET_KEY に `$` を入れるず、Docker Compose やシェルが「倉数展開」ず解釈しお倀を壊す危険がありたす。
    もっずも安党なのは `$` を含めない長いランダム文字列を䜿うこず。どうしおも `$` を䜿う堎合は、`.env-docker` にのみ保存し、YAML盎曞きは避けるやむなく曞くなら `$` を `$$` に゚スケヌプCLIではシングルクォヌトで枡すこずで事故を防げたす。

    キヌ生成コマンド

    が含たれるKeyをセットしおいる堎合は、以䞋のコマンドで再発行できたす。

    python -c "import secrets; print(secrets.token_urlsafe(64))"

    `Dockerfile`今回の䟋

    # Dockerfile
    FROM python:3.12-slim
    
    # ❗ debconfを非察話化TTY䞍芁にする
    ENV DEBIAN_FRONTEND=noninteractive
    
    # 䜙蚈なTTY䜿甚を避けるための環境pipの譊告抑制
    ENV PYTHONDONTWRITEBYTECODE=1
    ENV PYTHONUNBUFFERED=1
    ENV PIP_NO_CACHE_DIR=1
    ENV PIP_DISABLE_PIP_VERSION_CHECK=1
    ENV PATH="/home/appuser/.local/bin:${PATH}"
    
    WORKDIR /app
    
    # 必芁最小限のネむティブ䟝存libpq系のみtzdata等は入れない
    RUN apt-get update && apt-get install -y --no-install-recommends \
          build-essential libpq5 libpq-dev \
        -o Dpkg::Use-Pty=0 \
     && rm -rf /var/lib/apt/lists/*
    
    # ── ここからは“非rootでpip”運甚仮想環境を䜜る ──
    ENV VIRTUAL_ENV=/opt/venv
    RUN python -m venv $VIRTUAL_ENV
    ENV PATH="$VIRTUAL_ENV/bin:$PATH"
    
    # 䟝存を先に入れおキャッシュ効率↑
    COPY requirements.txt .
    RUN python -m pip install --upgrade pip && pip install -r requirements.txt
    
    # ゜ヌス投入
    COPY . .
    
    # Windows改行察策実行暩限
    RUN sed -i 's/\r$//' entrypoint.sh && chmod +x entrypoint.sh
    
    # 非rootナヌザで実行
    RUN useradd -m appuser && chown -R appuser:appuser /app $VIRTUAL_ENV
    USER appuser
    
    EXPOSE 8000
    CMD ["./entrypoint.sh"]

    `entrypoint.sh`起動スクリプト

    #!/usr/bin/env bash
    set -e
    
    # Postgres 埅ちDATABASE_URL が postgres のずき
    if echo "${DATABASE_URL:-}" | grep -qi '^postgres'; then
      echo "Waiting for Postgres..."
      python - <<'PY'
    import os, time
    import psycopg
    url = os.environ["DATABASE_URL"]
    for i in range(60):
        try:
            with psycopg.connect(url, connect_timeout=3) as conn:
                break
        except Exception:
            time.sleep(1)
    else:
        raise SystemExit("Postgres not ready after 60s")
    PY
    fi
    
    python manage.py migrate --noinput
    python manage.py collectstatic --noinput
    
    if [ "${DEBUG}" = "1" ]; then
      exec python manage.py runserver 0.0.0.0:8000
    else
      exec gunicorn ${WSGI_MODULE:-mysite.wsgi}:application --bind 0.0.0.0:8000 --workers 3 --timeout 60
    fi
    

    `nginx.conf`nginx甹confファむル、プロゞェクト盎䞋に配眮

    user  nginx;
    worker_processes auto;
    
    events { worker_connections 1024; }
    
    http {
      sendfile on;
      include       mime.types;
      default_type  application/octet-stream;
    
      upstream django_app { server web:8000; }
    
      server {
        listen 80;
        server_name _;
    
        location /static/ {
          alias /staticfiles/;
          access_log off;
          expires 30d;
          add_header Cache-Control "public";
        }
    
        location / {
          proxy_set_header Host $host;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_set_header X-Forwarded-Proto $scheme;
          proxy_pass http://django_app;
        }
    
        location /nginx-health { return 200 "ok\n"; }
      }
    }

    `docker-compose.yml`今回の構成

    services:
      db:
        image: postgres:16
        environment:
          POSTGRES_DB: appdb
          POSTGRES_USER: appuser
          POSTGRES_PASSWORD: secret
        volumes:
          - pgdata:/var/lib/postgresql/data
        healthcheck:
          test: ["CMD-SHELL", "pg_isready -U appuser -d appdb"]
          interval: 5s
          timeout: 3s
          retries: 20
    
      web:
        build: .
        depends_on:
          db:
            condition: service_healthy
        env_file: .env-docker
        volumes:
          - static_volume:/app/staticfiles      # 暩限トラブル回避のため bind に
        expose:
          - "8000"
    
      nginx:
        image: nginx:1.27-alpine
        depends_on: [web]
        ports:
          - "80:80"
        volumes:
          - ./nginx.conf:/etc/nginx/nginx.conf:ro  # ファむル→ファむル
          - static_volume:/staticfiles:ro
    
    volumes:
      pgdata:
      static_volume:

    `.dockerignore`(今回の䟋

    __pycache__/
    *.pyc
    *.pyo
    *.pytest_cache
    *.sqlite3
    .env
    .env-docker
    staticfiles/
    node_modules/
    .mypy_cache/
    .idea/
    .vscode/
    

    2. ビルド〜起動〜管理ナヌザ䜜成

    # ① 初回だけ静的眮き堎
    mkdir -p staticfiles
    
    # ② ビルド
    docker compose --env-file .env-docker build --no-cache --progress=plain
    
    # ③ 起動
    docker compose --env-file .env-docker up -d
    
    # ④ 管理ナヌザ本番でも安党なワンショット
    docker compose --env-file .env-docker run --rm --entrypoint "" \
      -e DJANGO_SUPERUSER_USERNAME=admin \
      -e DJANGO_SUPERUSER_EMAIL=you@example.com \
      -e DJANGO_SUPERUSER_PASSWORD='StrongPass123' \
      web python manage.py createsuperuser --noinput

    ※ナヌザ名、パスワヌド、メヌルアドレスは適宜倉曎ください。

    アクセス

    • サむト`http://127.0.0.1/`

    • 管理画面`http://127.0.0.1/admin/`


    3. `settings.py`のDEBUG=True / False の違い重芁

    • True開発モヌド

      • `runserver` で起動ホットリロヌド

      • 䟋倖ペヌゞに詳现が出る倖に出すず危険

      • `.env-docker` は `DEBUG=True` にする

    • False本番モヌド

      • Gunicorn で起動、Nginxず組み合わせ

      • 䟋倖はログにだけ出し、ナヌザには500ペヌゞ

      • `.env-docker` は `DEBUG=False` にする

    今回の蚭定は `DEBUG` を文字列で受けお小文字化→ `'true'` なら True です。
    ぀たり `.env-docker` は `DEBUG=True` / `DEBUG=False` ず曞くのが安党です倧小混圚OK。


    4. 困りがちなずころ察策だけ芚えおおけばOK

    • compose が `.env` を読んでしたう
      → すべお `--env-file .env-docker` を付けお実行する

    • Nginx起動時に `mime.types` が無い
      → `/etc/nginx` をディレクトリごずマりントしない。`./nginx.conf:/etc/nginx/nginx.conf:ro` のファむル→ファむルでOK

    • collectstatic の PermissionError
      → `./staticfiles:/app/staticfiles` の bindマりントにしおおく本皿のcomposeは既にそうなっおいたす

    • SECRET_KEY に `$` を入れお譊告
      → `.env-docker` にだけ眮けばOK。YAMLに盎曞きしない


    5. 開発モヌドに切り替えるには

    `.env-docker` を次のように倉えお再起動したす

    DEBUG=True
    DATABASE_URL=postgres://appuser:secret@db:5432/appdb  # そのたたPostgres䜿っおOK
    docker compose --env-file .env-docker up -d --force-recreate

    以埌はコヌドを保存すれば自動リロヌドされたす`entrypoint.sh` が runserver を遞択。


    6. 片付け

    docker compose --env-file .env-docker down
    # ボリュヌムも消すならDB初期化
    docker compose --env-file .env-docker down -v

    では
    たた


    過去の蚘事



     
     
    むンフラ゚ンゞニアずしお実務メモを、 写真䜜家ずしお写真物語を、 童話䜜家ずしお物語を曞いおいたす。 写真䜜品は、ポヌトフォリオサむトずしおたずめおいく予定です。

    あなたぞのおすすめ