Entrypoint¶
entrypoint.sh— shell скрипт що виконується при кожномуdocker compose up. Він запускає підготовчі кроки і потім uvicorn.
entrypoint.sh — повний код¶
#!/bin/sh
set -eu # -e: зупинитись при будь-якій помилці (exit code ≠ 0)
# -u: помилка при використанні неоголошеної змінної
# Без set -e: uvicorn стартує навіть якщо migrate провалилась → 500 на всіх запитах
log() {
printf '[entrypoint] %s\n' "$1"
}
if [ "${RUN_MIGRATIONS:-1}" = "1" ]; then
log "Applying database migrations..."
python manage.py migrate --noinput
# --noinput: не питати підтвердження в інтерактивному режимі
# Застосовує всі нові міграції з попередньої версії коду
fi
if [ "${RUN_COLLECTSTATIC:-1}" = "1" ]; then
log "Collecting static files..."
python manage.py collectstatic --noinput
# Збирає static з усіх installed apps у STATIC_ROOT (/app/staticfiles)
# Потрібно при кожному deploy (якщо змінились CSS/JS)
fi
if [ "${CREATE_SUPERUSER:-0}" = "1" ]; then
log "Creating/updating Django superuser ${DJANGO_SUPERUSER_USERNAME:-admin}..."
python manage.py shell -c "..."
# ... створює або оновлює суперкористувача з
# DJANGO_SUPERUSER_USERNAME / _EMAIL / _PASSWORD
fi
if [ "${SEED_DEMO_DATA:-0}" = "1" ]; then
seed_args="--force"
# --force: дозволити seed навіть при DEBUG=False
if [ "${SEED_DEMO_RESET:-0}" = "1" ]; then
seed_args="--force --reset"
# --reset: спочатку видалити наявні демо-дані
fi
log "Seeding demo data with args: ${seed_args}"
python manage.py seed_demo_data ${seed_args}
fi
port="${PORT:-8001}"
set -- --host 0.0.0.0 --port "${port}" --proxy-headers --forwarded-allow-ips '*'
# set -- ...: формує список аргументів для uvicorn ("$@")
# --proxy-headers: довіряти X-Forwarded-* від nginx
if [ "${UVICORN_RELOAD:-1}" = "1" ]; then
set -- "$@" --reload
# --reload: авто-перезапуск при зміні файлів (ТІЛЬКИ ДЛЯ DEV!)
# У production: UVICORN_RELOAD=0
fi
log "Starting ASGI web server on port ${port}..."
exec python -m uvicorn notes_project.asgi:application "$@"
# exec: замінює shell процес uvicorn'ом
# Без exec: shell → uvicorn як child process
# SIGTERM від Docker → shell → shell може ігнорувати → uvicorn не отримує сигнал
# З exec: SIGTERM → uvicorn → graceful shutdown ✓
Кожен крок керується змінною оточення з docker-compose.yml / .env (RUN_MIGRATIONS, RUN_COLLECTSTATIC, CREATE_SUPERUSER, SEED_DEMO_DATA, SEED_DEMO_RESET, UVICORN_RELOAD, PORT), тому той самий скрипт працює і для dev, і для production.
set -e — чому migrate має завершитись перед uvicorn¶
Ланцюг set -e у дії:
✅ Нормальний запуск:
migrate OK → collectstatic OK → seed OK → uvicorn START
❌ Якщо migrate провалилась (наприклад, PostgreSQL ще не ready):
migrate FAIL (exit 1) → set -e → shell EXIT
entrypoint повертає exit 1
→ Docker: контейнер вийшов з помилкою → "Exited (1)"
→ nginx НЕ стартує (depends_on: service_healthy)
→ Зрозуміла помилка в логах замість таємничих 500
Без set -e:
migrate FAIL → shell продовжується
collectstatic → може теж провалитись (якщо БД потрібна для static discovery)
seed_demo_data → може провалитись
uvicorn START → стартує без міграцій
→ 500 IntegrityError або OperationalError на кожній сторінці
→ важко зрозуміти що пішло не так
--noinput прапор¶
--noinput (або --no-input) вимикає інтерактивні підтвердження. Без нього:
You have requested to collect static files at the destination location as
specified in your settings:
/app/staticfiles
This will overwrite existing files!
Are you sure you want to do this?
Type 'yes' to continue, or 'no' to cancel:
У Docker контейнері немає інтерактивного терміналу → команда зависає назавжди. --noinput автоматично відповідає yes.
collectstatic — коли і навіщо¶
Ця команда збирає static files з усіх встановлених apps в один директорій (STATIC_ROOT = /app/staticfiles):
Джерела:
notes_app/static/notes_app/css/style.css
notes_app/static/notes_app/js/group_chat.js
django/contrib/admin/static/admin/css/base.css
crispy_forms/static/...
Результат: /app/staticfiles/
notes_app/css/style.css
notes_app/js/group_chat.js
admin/css/base.css
...
collectstatic виконується при кожному docker compose up тому що:
1. При зміні CSS/JS у code → нові файли мають потрапити у volume
2. При першому запуску staticfiles volume порожній
3. Це ідемпотентна операція (завжди безпечно виконати)
exec — чому не просто uvicorn¶
Без exec:
# ❌ Без exec (погано):
python -m uvicorn notes_project.asgi:application ...
# Process tree:
# PID 1: sh entrypoint.sh
# PID 2: python uvicorn ← SIGTERM не доходить до нього
#
# docker stop → SIGTERM → PID 1 (sh) → sh ігнорує
# → 10 сек → SIGKILL → hard kill
# Активні WebSocket з'єднання обриваються без graceful shutdown
З exec:
# ✅ З exec (правильно):
exec python -m uvicorn notes_project.asgi:application ...
# Process tree:
# PID 1: python uvicorn ← SIGTERM приходить напряму
#
# docker stop → SIGTERM → PID 1 (uvicorn) → graceful shutdown
# → допомагає завершити активні WebSocket з'єднання
# → зупиняється коректно
exec замінює поточний shell процес процесом uvicorn. Після exec PID 1 — це uvicorn, а не shell. Docker завжди надсилає SIGTERM до PID 1 при docker stop, і тепер uvicorn правильно його отримує.
production vs dev entrypoint¶
Development (поточний):
exec python -m uvicorn notes_project.asgi:application \
--host 0.0.0.0 \
--port 8001 \
--reload # ← автоматичний перезапуск при зміні .py файлів
Production:
exec python -m uvicorn notes_project.asgi:application \
--host 0.0.0.0 \
--port 8001 \
--workers 4 # ← 4 паралельних worker (2 × CPU cores)
# Без --reload: статичний запуск, вища продуктивність
У реальному entrypoint.sh --reload додається лише коли UVICORN_RELOAD=1 (значення за замовчуванням), тому для production достатньо задати UVICORN_RELOAD=0. --workers у скрипті немає — його треба додати самостійно.
--reload у production — антипатерн:
- Uvicorn стежить за файловою системою → зайве навантаження
- При кожному записі temp файлу або логу → можливий перезапуск
- Один worker process (не можна використовувати --workers з --reload)
У книзі¶
- Частина X. Linux і DevOps — Docker, контейнери, shell скрипти, process management, signals
Офіційна документація¶
- Uvicorn: Deployment —
--workers,--reload, graceful shutdown - Docker: ENTRYPOINT vs CMD — різниця між entrypoint і cmd
- Bash: set -e — опція errexit
- Linux: exec (shell builtin) — замінити поточний процес
- Django: collectstatic — команда і параметри