django-cronjobs 0.2.3

安装

要安装django-cronjobs，首先通过pip或easy_install安装，然后将cronjobs添加到您的INSTALLED_APPS。

注册cron作业

django-cronjobs包含一个用于注册cron作业的装饰器，并在<appname>.cron模块中查找已注册的作业。

例如

# myapp/cron.py
import cronjobs

@cronjobs.register
def periodic_task():
    pass

django-cronjobs将识别periodic_task为有效作业。

运行cron作业

要运行已注册的cron作业，请使用cron管理命令

$ ./manage.py cron <job_name>

因此，要从上面运行periodic_task，您可以

$ ./manage.py cron periodic_task

可以在任务名称后传递额外的参数。

锁

默认情况下，cron作业被锁定，以确保同一时间只有一个作业副本正在运行。如果您需要覆盖此行为，可以将 lock 关键字参数传递给 register。

from cronjobs import register
@register(lock=False)
def my_cron_job():
    # Multiple instances of me can run simultaneously.

如果您在相同的文件系统上运行多套cron作业并且需要锁不冲突，请将 CRONJOB_LOCK_PREFIX 设置为 Django 设置中唯一的值。