How do I schedule a task with Celery that runs on 1st of every month?

Question

How do I schedule a task with celery that runs on 1st of every month?

Plage

Have you read celeryq.org/docs/reference/celery.schedules.html ? – Slushy

@Deniz: Doesn't look like that covers DoM. – Ooze

Answer 1

Since Celery 3.0 the crontab schedule now supports day_of_month and month_of_year arguments: http://docs.celeryproject.org/en/latest/userguide/periodic-tasks.html#crontab-schedules

Incogitable

Answer 2

You can do this using Crontab schedules and you cand define this either:

• in your django settings.py:

from celery.schedules import crontab

CELERYBEAT_SCHEDULE = {
    'my_periodic_task': {
        'task': 'my_app.tasks.my_periodic_task',
        'schedule': crontab(0, 0, day_of_month='1'), # Execute on the first day of every month.
    },
}

• in celery.py config:

from celery import Celery
from celery.schedules import crontab

app = Celery('app_name')
app.conf.beat_schedule = {
    'my_periodic_task': {
        'task': 'my_app.tasks.my_periodic_task',
        'schedule': crontab(0, 0, day_of_month='1'), # Execute on the first day of every month.
    },
}

Resolute

I can't seem to find documentation on exactly how the '0's are used (I guess they are positional, minute/hour and are not optional, but not seen this explicitly stated) – Cadre

It's just an interface to linux contrab have a look here to better understand the parameters and how it works: linuxconfig.org/linux-crontab-reference-guide – Resolute

when i added crontab(0,0,day_of_month='1') it seems to get executed every second. – Anility

Answer 3

Use below crontab in your app.conf.beat_schedule(Celery Beat Scheduler):

crontab(hour=set_your_hours, minute=set_your_minutes, day_of_week="*",
        day_of_month=1, month_of_year="*")

Godfearing