如何在Docker中以Cron Job运行自定义Django-admin命令？

问题背景 #

我有一个Django应用sample，已按照官方文档在应用内创建test.py编写自定义命令，目录结构如下：

sample/
    __init__.py
    models.py
    management/
        __init__.py
        commands/
            __init__.py
            test.py
    views.py

test.py内容：

from django.core.management.base import BaseCommand

class Command(BaseCommand):

    def handle(self, *args, **options):
        # Sample content
        print("Hello World")

本地执行python manage.py test可正常运行，但在Docker中配置Cron定时执行该命令后，任务未生效。已创建hello-cron、Dockerfile和docker-compose.yml，配置如下：

相关配置文件 #

hello-cron

* * * * * root python /home/manage.py test >> /home/cron.log 2>&1

# Empty line

Dockerfile

FROM python:3.10.6
ENV PYTHONDONTWRITEBYTECODE=1
ENV PYTHONUNBUFFERED=1
WORKDIR /home
COPY requirements.txt /home/
RUN pip install -r requirements.txt
COPY . /home/
RUN apt-get update && apt-get -y install cron
COPY hello-cron /home/hello-cron
RUN chmod 0644 /home/hello-cron
RUN chmod 0744 /home/sample/management/commands/test.py
RUN crontab /home/hello-cron
RUN touch /home/cron.log
CMD cron && tail -f /home/cron.log

docker-compose.yml

version: "3.9"

services:
  db:
    image: postgres
    volumes:
      - ./data/db:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
  web:
    restart: always
    build: .
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/home
    ports:
      - "8000:8000"
    environment:
      - POSTGRES_NAME=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    depends_on:
      - db

问题排查与解决方法 #

1. 修复Cron任务格式错误 #

用户级crontab不需要指定root用户（只有系统级cron文件如/etc/cron.d/下的才需要），去掉hello-cron中的root字段：

* * * * * python /home/manage.py test >> /home/cron.log 2>&1

2. 解决Docker启动命令冲突 #

当前docker-compose.yml中web服务的command字段覆盖了Dockerfile的CMD，导致cron根本没启动——这是核心问题。推荐单独拆分cron服务：
修改docker-compose.yml，新增cron服务：

version: "3.9"

services:
  db:
    image: postgres
    volumes:
      - ./data/db:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
  web:
    restart: always
    build: .
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/home
    ports:
      - "8000:8000"
    environment:
      - POSTGRES_NAME=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    depends_on:
      - db
  cron:
    build: .
    volumes:
      - .:/home
    environment:
      - POSTGRES_NAME=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    depends_on:
      - db
    command: cron && tail -f /home/cron.log

3. 确保Cron执行环境正确 #

Cron的执行环境与容器shell环境不同，需做以下调整：

• 使用Python绝对路径：先进入容器执行which python获取路径（通常为/usr/local/bin/python），替换cron命令中的python：

  * * * * * /usr/local/bin/python /home/manage.py test >> /home/cron.log 2>&1
  

• 先进入项目目录：确保Django能找到配置文件，修改cron命令：

  * * * * * cd /home && /usr/local/bin/python manage.py test >> /home/cron.log 2>&1
  

4. 验证与排查日志 #

• 进入cron容器执行crontab -l，确认定时任务已正确加载
• 查看系统cron日志：若容器无syslog，先安装rsyslog：

  apt-get install -y rsyslog
  service rsyslog start
  tail -f /var/log/syslog
  

  从日志中可查看任务执行的错误信息（如路径、权限或环境变量问题）

内容的提问来源于stack exchange，提问作者Ajdal