
ã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/appdbSECRET_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` ã®ãã¡ã€ã«âãã¡ã€ã«ã§OKcollectstatic ã® 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䜿ã£ãŠOKdocker 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ã§ã¯
ãŸãïŒ