如何配置Python Django项目在Docker容器中实现一键式自动化部署？-Python教程-PHP中文网

一键式自动化部署的关键在于 docker-compose.yml 与 entrypoint.sh 协同设计：通过 healthcheck 显式探测 db 健康状态、depends_on 引用 service_healthy、迁移与静态文件收集逻辑内置于 entrypoint.sh，并用 exec "$@" 接管主进程，结合分层环境变量管理，确保“谁该等谁、什么时候该做什么、环境变量在哪一层生效”边界清晰。

如何配置python django项目在docker容器中实现一键式自动化部署？

能实现一键式自动化部署，但关键不在“一键”，而在 docker-compose.yml 和启动脚本的协同设计——Docker 本身不提供“自动化”逻辑，所有初始化动作（迁移、收集静态文件、等待 DB 就绪）必须显式编码进容器生命周期里。

docker-compose.yml 必须定义健康依赖和启动顺序

很多人以为 depends_on 就能保证服务就绪，其实它只控制启动顺序，不检查端口或服务状态。PostgreSQL 容器可能已启动，但数据库还没初始化完，Django 就开始执行 migrate，直接失败。

用 healthcheck 显式探测 DB 可用性，例如在 db service 中加：

healthcheck:
  test: ["CMD-SHELL", "pg_isready -U ${DB_USER} -d ${DB_NAME}"]
  interval: 30s
  timeout: 10s
  retries: 5

在 backend service 中用 depends_on 引用该健康检查：

depends_on:
  db:
    condition: service_healthy

避免在 Dockerfile 的 RUN 阶段执行 python manage.py migrate ——镜像构建时 DB 还不存在，会报错或静默跳过。

entrypoint.sh 是自动化真正的执行入口

把迁移、静态文件收集、等待 DB 等逻辑全塞进 entrypoint.sh，而不是靠 docker-compose up 后手动进容器跑命令。这个脚本在容器启动时自动执行，且只运行一次。

python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

脚本开头加 #!/bin/sh，并确保有可执行权限：chmod +x entrypoint.sh
用 until 循环等待 DB 可连通（比 sleep 更可靠）：

until nc -z $DB_HOST $DB_PORT; do
  echo "Waiting for $DB_HOST:$DB_PORT..."
  sleep 2
done

执行迁移和 collectstatic 前，先检查是否已做过（避免重复执行导致冲突）：

if [ ! -f /app/migrated ]; then
  python manage.py migrate --noinput
  touch /app/migrated
fi

最后用 exec "$@" 接管 CMD，保证信号能正确传递给 Gunicorn 或其他主进程。

Gunicorn 启动命令不能硬编码在 Dockerfile 中

CMD ["gunicorn", "..."] 写死在 Dockerfile 会导致无法覆盖参数，比如调试时想加 --reload，就得重建镜像。更灵活的做法是让 entrypoint.sh 根据环境变量决定启动方式。

开发环境用 python manage.py runserver 0.0.0.0:8000，生产环境用 gunicorn
通过 ENV MODE=prod 控制分支逻辑，避免为 dev/prod 维护两套 Dockerfile
注意 Gunicorn 的 --chdir 参数必须指向项目根目录，否则找不到 wsgi.py；常见错误是 ModuleNotFoundError: No module named 'myproject.wsgi'

环境变量和 .env 文件必须分层管理

本地开发、CI 构建、生产部署三者环境变量来源不同，混在一起必然出错。不要把敏感信息写进 docker-compose.yml，也不要让 settings.py 直接读 os.environ 而不做 fallback。

docker-compose.yml 中只声明变量名，值从外部注入：DB_HOST: ${DB_HOST}
本地用 .env 文件（gitignore 掉），CI 用 secret 注入，生产用宿主机环境变量
Django settings.py 里用 os.getenv('DEBUG', 'False').lower() == 'true'，避免字符串比较陷阱
SECRET_KEY 必须设为非空字符串——Docker 默认环境变量为空时返回空字符串，不是 None，容易触发 Django 启动失败