Django Celery定時任務和時間設置
- 2020 年 3 月 17 日
- 筆記
1、Celery加入定時任務
Celery除了可以異步執行任務之外,還可以定時執行任務。在實例代碼的基礎上寫個測試方法:
#coding:utf-8from celery.task.schedules import crontab from celery.decorators import periodic_task @periodic_task(run_every=crontab())def some_task(): print('periodic task test!!!!!') time.sleep(5) print('success') return True
該代碼是每分鐘執行一次some_task方法。
上篇文章啟動celery是使用worker。但worker不能啟動定時任務。啟動方式如下:
1)先確保中間人是否打開,我使用redis作為中間人。可參考Redis在CentOS和Windows安裝過程。
2)進入django項目的根目錄執行如下代碼啟動celery的worker:
有兩個任務,其中一個myapp.tasks.sendmail是上篇文章添加的異步處理任務。myapp.tasks.some_task是本次的定時任務。
3)同樣在django項目的根目錄下再打開一個命令行界面,執行如下代碼:
2、Celery定時任務時間設置
若你覺得1分鐘等待時間太長。可以設置為每10秒執行一次定時任務。將上面的periodic_task修改如下:
@periodic_task(run_every=10)
修改代碼,需要重啟Celery的worker和beat。
這個run_every參數是設置定時任務的時間間隔或執行的時間。該參數設置有3種方式。
1)直接設置秒數
例如剛剛所說的10秒間隔,run_every=10,每10秒執行一次任務。1分鐘即是60秒;1小時即是3600秒。
2)通過datetime設置時間間隔
有時直接設置秒數不方便,需要通過計算得到具體秒數。
例如,1小時15分鐘40秒 = 1*60*60 + 15*60 + 40。這種情況可讀性也不高。
可以採用datetime設置,代碼如下:
from celery.decorators import periodic_taskimport datetime @periodic_task(run_every=datetime.timedelta(hours=1, minutes=15, seconds=40))def some_task(): print('periodic task test!!!!!')
代碼可讀性明顯提升,而且設置方便。
但這種不能滿足定時定點的時間設置。假如我想固定每天12點15分的時候,執行一次任務。datetime和直接設置秒數的方式都無法實現。這時得使用第3種方式。
3)celery的crontab表達式
crontab是比較完善,且稍微有點複雜(相對前面兩種方式而言)的方式。可以實現我們各種設置時間的需求。
例如,前面給出的代碼:
#coding:utf-8from celery.task.schedules import crontab from celery.decorators import periodic_task @periodic_task(run_every=crontab())def some_task(): print('periodic task test!!!!!')
表示每分鐘0秒時刻執行一次(後面不提這個0秒,大家都知道就行了,省點口水)。
其中,crontab()實例化的時候沒設置任何參數,都是使用默認值。crontab一共有7個參數,常用有5個參數分別為:
minute:分鐘,範圍0-59;
hour:小時,範圍0-23;
day_of_week:星期幾,範圍0-6。以星期天為開始,即0為星期天。這個星期幾還可以使用英文縮寫表示,例如「sun」表示星期天;
day_of_month:每月第幾號,範圍1-31;
month_of_year:月份,範圍1-12。
a、默認參數
這些參數可以設置表達式,表達稍微複雜的設置。默認值都是"*"星號,代表任意時刻。即crontab()相當與:
crontab(minute='*', hour='*', day_of_week='*', day_of_month='*', month_of_year='*')
含義是每天、每小時、每分鐘執行一次任務。這說法太反人類語言習慣,簡單說就是每1分鐘執行一次任務。
b、具體某個值
上面提到這些參數的取值範圍。我們可以直接設置某個值。例如:
crontab(minute=15)
即每小時的15分時刻執行一次任務。直接指定某個時刻。以此類推可以設置每天0點0分時刻執行任務的設置如下:
crontab(minute=0, hour=0)
當然,也可以設置多個值。例如0分和30分執行一次任務:
crontab(minute='0,30')
這裡使用字符串,用逗號隔開數值。這裡的逗號是表示多個表達式or邏輯關係。
c、設置範圍
設置範圍也是設置多個值,例如指定9點到12點每個小時的每分鐘執行任務。
crontab(minute='*', hour='9-12')
這裡*號是默認值,可以省略如下:
crontab(hour='9-12')
上面提到逗號是or邏輯關係。拓展一下,指定9點到12點和20點中每分鐘執行任務:
crontab(hour='9-12,20')
crontab的表達式越來越複雜了。celery還提供了一個類得到表達式解析結果,代碼如下:
from celery.task.schedules import crontab_parserr = crontab_parser(23, 0).parse('9-12,20')print(r)
其中,crontab_parse是一個解析類。第1個參數是範圍的最大值;第2個參數是範圍的最小值。通過parse輸入表達式,可得到表達式的解析結果:
set([9, 10, 11, 12, 20])
下面很多地方我們都可以通過該方法驗證解析結果。
d、設置間隔步長
假如我要設置1、3、5、7、9、11月份每天每分鐘執行任務,按照上面的做法可以設置如下:
crontab(day_of_month='1,3,5,7,9,11')
觀察數據可以發現,都是間隔2的步長。需要設置的數字比較少,若數字比較多顯得很麻煩。例如我想每間隔2分鐘就執行一次任務,要寫30個數字想想就覺得很麻煩。crontab表達式還提供了間隔的處理,例如:
crontab(minute='*/2')crontab(minute='0-59/2') #效果等同上面
這個/號不是除以的意思。相當與range的第3個參數,例如:
range(0, 59+1, 2)
差不多crontab表達式就這些,多舉幾個例子:
#每2個小時中每分鐘執行1次任務crontab(hour='*/2') #每3個小時的0分時刻執行1次任務#即[0,3,6,9,12,15,18,21]點0分crontab(minute=0, hour='*/3') #每3個小時或8點到12點的0分時刻執行1次任務#即[0,3,6,9,12,15,18,21]+[8,9,10,11,12]點0分crontab(minute=0, hour='*/3,8-12') #每個季度的第1個月中,每天每分鐘執行1次任務#月份範圍是1-12,每3個月為[1,4,7,10]crontab(month_of_year='*/3') #每月偶數天數的0點0分時刻執行1次任務crontab(minute=0, hour=0, day_of_month='2-31/2') #每年5月11號的0點0分時刻執行1次任務crontab(0, 0, day_of_month='11', month_of_year='5')
這些表達式設置都可以用crontab_parser驗證。