如何在Docker+Gunicorn的Django环境中运行django-apscheduler

问题背景 #

在Docker容器中通过Gunicorn运行Django时，尝试用entrypoint脚本启动自定义的runapscheduler命令，但该命令为阻塞式运行，导致Gunicorn始终无法启动。

现有配置 #

1. Entrypoint脚本：

#!/bin/sh
python manage.py runapscheduler --settings=core.settings_dev_docker

2. runapscheduler.py核心逻辑：使用APScheduler调度器，调用scheduler.start()后会阻塞当前进程
3. Docker启动命令：

command: gunicorn core.wsgi:application --bind 0.0.0.0:8000

解决方案 #

方式一：单容器内后台运行调度器 #

修改entrypoint脚本，将调度器命令放到后台执行，再启动Gunicorn：

#!/bin/sh
# 后台启动APScheduler调度器
python manage.py runapscheduler --settings=core.settings_dev_docker &
# 启动Gunicorn作为容器主进程
exec gunicorn core.wsgi:application --bind 0.0.0.0:8000

说明：&符号让调度器进程在后台运行，exec命令确保Gunicorn成为容器的主进程，这样容器能正确响应停止等系统信号。

方式二：拆分独立容器（推荐） #

遵循Docker"一个容器一个进程"的最佳实践，将Web服务和调度器拆分为两个独立容器：

• Web服务容器：保持原有配置，仅运行Gunicorn
• 调度器容器：启动命令改为python manage.py runapscheduler --settings=core.settings_dev_docker

这种方式的优势：

• 两个服务完全独立，不会互相影响
• 便于单独扩容、监控和维护
• 避免多进程在单容器内的信号处理问题

关键注意事项 #

• 若使用BlockingScheduler（阻塞式调度器），必须后台运行或单独容器；若用BackgroundScheduler，不建议在Gunicorn多worker环境下使用，会导致多个调度器实例重复执行任务。
• 确保两个进程/容器能访问同一个数据库，django-apscheduler依赖数据库存储任务和执行记录。

内容的提问来源于stack exchange，提问作者m-derra