一键式自动化部署的关键在于 docker-compose.yml 与 entrypoint.sh 协同设计：通过 healthcheck 显式探测 DB 健康状态、depends_on 引用 service_healthy、迁移与静态文件收集逻辑内置于 entrypoint.sh，并用 exec "$@" 接管主进程，结合分层环境变量管理，确保“谁该等谁、什么时候该做什么、环境变量在哪一层生效”边界清晰。
能实现一键式自动化部署，但关键不在“一键”，而在 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 后手动进容器跑命令。这个脚本在容器启动时自动执行，且只运行一次。
- 脚本开头加
#!/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-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
- 开发环境用
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 启动失败
真正卡住一键部署的，往往不是语法或命令，而是“谁该等谁”“什么时候该做什么”“环境变量在哪一层生效”这三个问题没理清。每个环节都得有明确的职责边界，否则看似一键，实则处处要人救火。
