Celery分布式队列学习

1. celery介绍和使用

Celery 是一个 基于python开发的分布式异步消息任务队列(可以简单理解为python多进程或多线程中的queue)，通过它可以轻松的实现任务的异步处理。celery的架构由三部分组成：消息中间件（message broker），任务执行单元（worker）和任务执行结果储存（task result store）。各个职责如下：

消息中间件

Celery本身不提供消息服务，但是可以方便的和第三方提供的消息中间件集成，包括RabbitMQ,Redis,MongoDB等。

任务执行单元

Worker是Celery提供的任务执行的单元，worker并发的运行在分布式的系统节点中

任务结果存储

Task result store用来存储Worker执行的任务的结果，Celery支持以不同方式存储任务的结果，包括Redis，MongoDB，Django ORM，AMQP等

　　　　　　　　　

　　　　　　　　　　　　　　　　

安装celery和redis组件  （用redis做broker）

sudo pip install -U "celery[redis]"

sudo pip install celery

测试celery

　　新建一个python文件tasks.py

#/usr/bin/python

from celery import Celery

app = Celery('tasks',broker='redis://127.0.0.1:6379/0',backend='redis://127.0.0.1:6379/0')

# 'tasks'为module名称，broker为消息中间件，backend为任务结果存储地方（backend可以不设置，默认为disabledbackend）
#127.0.0.1:6379/0 为redis server安装的ip地址和端口，0为数据库编号（redis有0-16个数据库）

@app.task
def add(x, y):
    return x+y

　　启动celery worker来监听任务队列：

　　　　celery -A tasks worker --loglevel=info   #tasks为上面module文件的名称

　　调用任务

　　　　再开一个终端，进入python环境

　　　　from tasks import add

　　　　add.delay(4,4)

　　celery worker端执行结果如下，说明celery可以正常运行了

　　若设置了backend，可以查看任务执行结果

　　　　from tasks import add

　　　　result = add.delay(4,4)

　　　　#result.ready() 　　　　 #查看worker是否执行完任务

　　　　result.get(timeout=10)　　# 返回执行结果，若任务还未执行完成，等待10s，否则抛出异常

　　　　#result.get(propagate=False)

　　　　　　

运行过程中出现的几个错误及解决方式：

　　bash：celery command not found：查看/usr/bin的确没有celery，最后发现celery安装在/usr/local/python-3.5.2/bin/目录下，而$PATH中不包括该目录，所以shell找不到celery命令，建立一个软连接就好了：sudo ln -s /usr/local/python-3.5.2/bin/celery /usr/bin/celery

　　AttributeError  "'float' object has no attribute 'items'" ：参考https://github.com/celery/celery/issues/5175发现原因，由于celery和redis 3.0版本兼容问题，需要回滚redis版本：pip install redis==2.10.6 （查看redis版本：pip show redis;）

 2. celery在项目中的使用

建立一个python project，如下图所示

celery.py

#/usr/bin/python
#coding:utf-8

from __future__ import absolute_import
from celery import Celery
# absolute_import 保证从绝对路径引入celery，防止倒入时目录下celery.py文件覆盖celery库文件

app = Celery('proj', broker='redis://localhost',
        backend='redis://localhost', include=['proj.tasks'])
#将proj目录下tasks加进来

 app.config_from_object('proj.config')
#使用config.py作为配置文件，也可以直接在这里写相关配置信息

if __name__=='__main__':
    app.start()

tasks.py

#/usr/bin/python
#coding:utf-8

from __future__ import absolute_import
from proj.celery import app

@app.task
def add(x,y):
    print('running add..')
    return x+y

@app.task
def mul(x,y):
    print('running mul..')
    return x*y

@app.task
def sub(x,y):
    print('running sub..')
    return x-y

config.py

#/usr/bin/python
#coding:utf-8
from __future__ import absolute_import

#BROKER_URL='redis://localhost:6379/0'
#CELERY_RESULT_BACKEND='redis://localhost:6379/0'

在proj 所在路径下：  celery -A proj worker -l info

另外打开终端：　　　    from proj.tasks import add, mul, sub

　　　　　　　　　　　add.delay(6,3)

　　　　　　

后台启动多个worker ：http://docs.celeryproject.org/en/latest/userguide/daemonizing.html#daemonizing

3，celery定时任务

　　http://docs.celeryproject.org/en/latest/userguide/periodic-tasks.html

　　利用celery beat任务模块可以完成定时任务，设定好任务的执行时间，celery就会定时自动帮你执行，还可以结合celery.schedules中的crontab模块来设置时间（类似于linux的crontab）.新建periodic_task.py文件，代码如下：

#/usr/bin/python
#coding:utf-8
from celery import Celery
from celery.schedules import crontab

app = Celery(broker='redis://localhost')  #默认会采用broker_url = 'amqp://guest:guest@localhost:5672//'，若未安装rabbitmq会报错

@app.on_after_configure.connect
def setup_periodic_tasks(sender, **kwargs):
    # Calls test('hello') every 10 seconds.
    sender.add_periodic_task(10.0, test.s('hello'), name='add every 10')

    # Calls test('world') every 30 seconds
    sender.add_periodic_task(30.0, test.s('world'), expires=10)

    # Executes every Monday morning at 7:30 a.m.
    sender.add_periodic_task(
        crontab(hour=7, minute=30, day_of_week=1),
        test.s('Happy Mondays!'),
    )

@app.task
def test(arg):
    print(arg)

　　上面是通过函数add_periodic_task()添加定时任务，也可以通过配置文件方式添加任务：

app.conf.beat_schedule = {
    'add-every-30-seconds': {
        'task': 'tasks.add',
        'schedule': 30.0,
        'args': (16, 16)
    },
}
app.conf.timezone = 'UTC'   #'Asia/Shanghai'

　　相关参数含义：

    task： The name of the task to execute.
    schedule：The frequency of execution.
        This can be the number of seconds as an integer, a timedelta, or a crontab. You can also define your own custom schedule types, by extending the interface of schedule.
    args： Positional arguments (list or tuple).
    kwargs： Keyword arguments (dict).
    options：Execution options (dict).
        This can be any argument supported by apply_async() – exchange, routing_key, expires, and so on.
    relative： If relative is true timedelta schedules are scheduled “by the clock.” This means the frequency is rounded to the nearest second, minute, hour or day depending on the period of the timedelta.
              By default relative is false, the frequency isn’t rounded and will be relative to the time when celery beat was started

　　启动任务调度器：celery beat

　　　　celery -A periodic_task beat

　　　　

　　　　（beat需要存储任务的上一次执行时间到本地（默认celerybeat-schedule），所以需要有对当前文件路径的写权限，也可以自定义存储目录：如下命令）

　　　  　celery -A proj beat -s /home/celery/var/run/celerybeat-schedule

　　启动worker来执行任务：（另外打开终端）

　　　　celery -A periodic_task worker

　　　　

　　利用corntab设置更复杂的定时时间，类似于linux中的corntab命令，linux crontab http://www.cnblogs.com/peida/archive/2013/01/08/2850483.html

　　如下面的每周一早上7:30

from celery.schedules import crontab

app.conf.beat_schedule = {
    # Executes every Monday morning at 7:30 a.m.
    'add-every-monday-morning': {
        'task': 'tasks.add',
        'schedule': crontab(hour=7, minute=30, day_of_week=1),
        'args': (16, 16),
    },
}

　　更多corntab示例：

Example	Meaning
crontab()	Execute every minute.
crontab(minute=0, hour=0)	Execute daily at midnight.
crontab(minute=0, hour='*/3')	Execute every three hours: midnight, 3am, 6am, 9am, noon, 3pm, 6pm, 9pm.
crontab(minute=0, hour='0,3,6,9,12,15,18,21')	Same as previous.
crontab(minute='*/15')	Execute every 15 minutes.
crontab(day_of_week='sunday')	Execute every minute (!) at Sundays.
crontab(minute='*', hour='*',day_of_week='sun')	Same as previous.
crontab(minute='*/10', hour='3,17,22',day_of_week='thu,fri')	Execute every ten minutes, but only between 3-4 am, 5-6 pm, and 10-11 pm on Thursdays or Fridays.
crontab(minute=0,hour='*/2,*/3')	Execute every even hour, and every hour divisible by three. This means: at every hour except: 1am, 5am, 7am, 11am, 1pm, 5pm, 7pm, 11pm
crontab(minute=0, hour='*/5')	Execute hour divisible by 5. This means that it is triggered at 3pm, not 5pm (since 3pm equals the 24-hour clock value of “15”, which is divisible by 5).
crontab(minute=0, hour='*/3,8-17')	Execute every hour divisible by 3, and every hour during office hours (8am-5pm).
crontab(0, 0,day_of_month='2')	Execute on the second day of every month.
crontab(0, 0, day_of_month='2-30/3')	Execute on every even numbered day.
crontab(0, 0, day_of_month='1-7,15-21')	Execute on the first and third weeks of the month.
crontab(0, 0,day_of_month='11', month_of_year='5')	Execute on the eleventh of May every year.
crontab(0, 0, month_of_year='*/3')	Execute on the first month of every quarter.

官方文档：http://docs.celeryproject.org/en/latest/

参考博客：https://www.cnblogs.com/alex3714/p/6351797.html

　　　　    https://www.cnblogs.com/forward-wang/p/5970806.html