DockerだけでDjango開発環境を作る（Python・MySQLインストール不要）【AIと一緒に作るDjangoブログ入門 #1】

~/myblog/
├ myblog/          ← プロジェクト設定（settings.py・urls.py等）
├ docker/          ← Nginx設定ファイル
│  └ nginx.dev.conf
├ staticfiles/     ← 静的ファイル置き場（CSS・JS・画像）
├ media/           ← アップロード画像置き場
├ manage.py        ← Djangoの操作コマンド
├ .env             ← 環境変数（GitHubにあげない）
├ .dockerignore    ← Dockerに含めないファイルの設定
├ Dockerfile       ← Dockerの設定
├ docker-compose.yml
└ requirements.txt

mkdir -p ~/myblog
mkdir -p ~/myblog/docker
mkdir -p ~/myblog/staticfiles
mkdir -p ~/myblog/media
cd ~/myblog

touch ~/myblog/.dockerignore

.env
.git
__pycache__
*.pyc

touch ~/myblog/Dockerfile

# ベースイメージにPython 3.12を使用
FROM python:3.12

# コンテナ内の作業ディレクトリを/app に設定
WORKDIR /app

RUN groupadd --gid 1000 app && \
    useradd --uid 1000 --gid app --shell /bin/bash --create-home app

# requirements.txtをコンテナにコピー
COPY requirements.txt .

# パッケージをインストール（キャッシュなしで軽量化）
RUN pip install --no-cache-dir -r requirements.txt

# プロジェクトのコードを全てコンテナにコピー
# --chown でコピー時に所有権を app ユーザーに変更
COPY --chown=app:app . .

# 書き込みが必要なディレクトリを app 所有で用意
RUN mkdir -p /app/logs /app/staticfiles /app/media && \
    chown -R app:app /app

# 以降のコマンドは非rootの app ユーザーで実行
# gunicorn は 0.0.0.0:8000 で listen するが、ポート >1024 なので非rootでOK
USER app

touch ~/myblog/requirements.txt

# Django本体
django==6.0.5

# 本番用Webサーバー
gunicorn==26.0.0

# MySQLクライアント
mysqlclient==2.2.8

# 環境変数管理
django-environ==0.13.0

# 静的ファイル配信
whitenoise==6.12.0

# 画像処理
Pillow==12.2.0

# Markdown → HTML 変換（第6章で使用）
markdown==3.10.2

# コードハイライト（第6章で使用）
pygments==2.20.0

# 画像の自動リサイズ・サムネイル生成（第6章で使用）
django-imagekit==6.1.0

touch ~/myblog/.env

# Django設定
SECRET_KEY=django-insecure-your-secret-key-here
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1

# データベース設定
MYSQL_DATABASE=myblog
MYSQL_USER=blog_user
MYSQL_PASSWORD=blogpassword
MYSQL_ROOT_PASSWORD=rootpassword
DATABASE_URL=mysql://blog_user:blogpassword@db:3306/myblog

touch ~/myblog/docker-compose.yml

services:

  # Nginx（Webサーバー）
  nginx:
    image: nginx:latest
    volumes:
      - ./docker/nginx.dev.conf:/etc/nginx/nginx.conf:ro
      - ./staticfiles:/app/staticfiles
      - ./media:/app/media
    ports:
      - "80:80"
    depends_on:
      web:
        condition: service_started   # webが起動したらNginxも起動する

  # Django（アプリケーションサーバー）
  web:
    build: .
    command: gunicorn myblog.wsgi:application --bind 0.0.0.0:8000 --reload
    volumes:
      - .:/app
      - ./staticfiles:/app/staticfiles
      - ./media:/app/media
    env_file:
      - .env
    depends_on:
      db:
        condition: service_healthy   # dbがhealthyになるまで待つ

  # MySQL（データベース）
  db:
    image: mysql:8.0
    env_file:
      - .env
    volumes:
      - mysql_data:/var/lib/mysql
    ports:
      - "3306:3306"
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      retries: 5
      timeout: 5s

volumes:
  mysql_data:

command: gunicorn myblog.wsgi:application --bind 0.0.0.0:8000 --reload

db が起動（healthy）
　↓
web が起動（started）
　↓
nginx が起動

touch ~/myblog/docker/nginx.dev.conf

events {
    worker_connections 1024;
}

http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    server {
        listen 80;
        server_name localhost;

        # 静的ファイル（CSS・JS・画像）の配信
        location /static/ {
            alias /app/staticfiles/;
        }

        # アップロードされた画像の配信
        location /media/ {
            alias /app/media/;
        }

        # それ以外のリクエストはDjangoに転送
        location / {
            proxy_pass http://web:8000;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
}

cd ~/myblog
docker compose run --rm web django-admin startproject myblog .

~/myblog/
├ myblog/      ← プロジェクト設定フォルダ（自動生成）
├ manage.py    ← Djangoの操作コマンド（自動生成）
└ ...

from pathlib import Path
import environ

# BASE_DIRを先に定義する
BASE_DIR = Path(__file__).resolve().parent.parent

env = environ.Env()
environ.Env.read_env(BASE_DIR / '.env')

SECRET_KEY = env('SECRET_KEY')
DEBUG = env.bool('DEBUG')
ALLOWED_HOSTS = env.list('ALLOWED_HOSTS')

LANGUAGE_CODE = 'ja'
TIME_ZONE = 'Asia/Tokyo'

DATABASES = {
    'default': env.db()
}

STATIC_URL = 'static/'
STATIC_ROOT = BASE_DIR / 'staticfiles'

cd ~/myblog
docker compose build

docker compose run --rm web pip list | grep -E "django-environ|mysqlclient"

cd ~/myblog
docker compose run --rm web python manage.py migrate

cd ~/myblog
docker compose up

web-1 | [INFO] Starting gunicorn 26.0.0
web-1 | [INFO] Listening at: http://0.0.0.0:8000

cd ~/myblog
docker compose down

docker compose ps -a

ERROR: Could not find a version that satisfies the requirement xxx==1.2.3

docker compose down -v   # ← -v でボリュームも消す（DBデータも消える）
docker compose up