celery （二） task调用
调用 TASK
基础
task 的调用方式有三种：
- 类似普通函数的调用方式, 通过
__calling__调用 ，类似function() - 通过
apply_async（）调用，能接受较多的参数 - 通过
delay（）调用 ，是apply_async方法的快捷方法，可接受的参数较少
task.delay(arg1, arg2, kwarg1=1, kwarg2=2)
等同于
task.apply_async(args=[arg1, arg2], kwargs={'kwarg':1, 'kwarg2':2})
链接任务
通过链接的方式，可以在一个任务执行完毕之后，执行另一个任务。
add.apply_async(args=(2,2),link=add.s(6))
当第一个task完成之后，task的结果会作为第二个函数参数的的一部分传入第二个task。
上例第一个task结果为 4， 第二个task执行的是 \(4 + 6\) 。
如果第一个task失败，那么第一个task的 id 会被传入到第二个task中
@app.task
def error_handler(uuid):
result = AsyncResult(uuid)
exc = result.get(propagate=False)
print('Task {0} raised exception: {1!r}\n{2!r}'.format(
uuid, exc, result.traceback))
add.apply_async(args=(2), link=error_handler.s())
当然，两个是可以同时调用的
add.apply_async((2, 2), link=[add.s(16), error_handler21111.s()])
追踪状态
通过设置 on_message 回调函数，可以追踪 task 的状态变化
@app.task(bind=True)
def hello(self, a, b):
time.sleep(1)
self.update_state(state="PROGRESS", meta={'progress': 50})
time.sleep(1)
self.update_state(state="PROGRESS", meta={'progress': 90})
time.sleep(1)
return 'hello world: %i' % (a+b)
def on_raw_message(body):
print(body)
r = hello.apply_async()
print(r.get(on_message=on_raw_message, propagate=False))
{'task_id': '5660d3a3-92b8-40df-8ccc-33a5d1d680d7',
'result': {'progress': 50},
'children': [],
'status': 'PROGRESS',
'traceback': None}
{'task_id': '5660d3a3-92b8-40df-8ccc-33a5d1d680d7',
'result': {'progress': 90},
'children': [],
'status': 'PROGRESS',
'traceback': None}
{'task_id': '5660d3a3-92b8-40df-8ccc-33a5d1d680d7',
'result': 'hello world: 10',
'children': [],
'status': 'SUCCESS',
'traceback': None}
hello world: 10
ETA 和countdown 延迟执行
ETA（预估到达时间）配置一个具体的时间，是一个时间对象，这个时间是相关task的最早的执行时间（也就是说，该任务实际执行时间，可能晚于该时间）。countdown是ETA的快捷方式，countdown 是相对（当前）时间，单位是 秒。它表示该任务会在多少秒之后执行。
>>> from datetime import datetime, timedelta
>>> tomorrow = datetime.utcnow() + timedelta(days=1)
>>> add.apply_async((2, 2), eta=tomorrow) # 明天的当前时间执行
>>> result = add.apply_async((2, 2), countdown=3)
>>> result.get() # 3秒后执行
Expiration 任务保质期
通过配置 expiration 参数给task设置一个 过期时间，来保证task的时效性。当worker收到一个过期的任务之后，会标记该任务为 revoked（取消）状态。expiration 既可以是相对时间（单位：秒），也可以是绝对时间（时间对象）
add.apply_async((10, 10), expires=60)
>>> from datetime import datetime, timedelta
>>> add.apply_async((10, 10), kwargs,
... expires=datetime.now() + timedelta(days=1)
重试机制
celery会在连接失败的时候，自动尝试重新发送task。一般收到一个task，都会有一条 收到task的log信息。
通过设置 retry=False 来禁用自动重试。当然也可以通过配置其他参数来，配置celery自动重试的策略。
max_retries 最大重试次数
默认为3，如果设置为 None，表示一直重试。如果超过重试次数依旧失败，会引发一个导致重试失败的异常。
interval_start 重试等待时间
在多久之后开始重试，默认为 0 ，即可以重试。但是为 秒
interval_step 延迟重试 步长
连续重试的时候，每次重试之后，其延迟时间都会加上该参数的值。 默认是 0.2 ，单位为 秒
interval_max 重试延迟最大等待时间
每次重试之间，最大等待时间。 默认是 0.2 ， 单位为 秒
add.apply_async((2, 2), retry=True, retry_policy={
'max_retries': 3,
'interval_start': 0,
'interval_step': 0.2,
'interval_max': 0.2,
})
# 最大重试次数为 3，第一次会在失败之后，立刻执行； 第二次会在第一次失败之后，等待0+0.2s执行；第三次会会 0+0.2（两次重试最大间隔为0.2，所以依旧是0.2，而不是0.4）。所以，三次重试一共耗时 0.2+0.2 = 0.4s
连接失败，或者是无法建立连接的时候，celery会引发OperationalError 异常。但是如果配置了自动重试，那么该异常只会在重试次数耗尽之后，依旧无法建立连接的时候，才引发。
>>> from celery.utils.log import get_logger
>>> logger = get_logger(__name__)
>>> try:
... add.delay(2, 2)
... except add.OperationalError as exc:
... logger.exception('Sending task raised: %r', exc)
序列化
在celery的客户端和worker之间发送消息的时候，需要对消息进行序列化。默认的序列化方式是 JSON，可以通过在 setting 中配置 task_serializer 来更改默认的序列化方式，当然可以对每个task分别设置序列化方式。支持的序列化方式有：JSON YAML PICKLE msgpck
压缩
celery 同样可以在传送消息的时候，对其进行压缩。压缩方式有：gzip 和bzip2 。
有如下三种方式来配置压缩属性，按优先级分别为：
- compression 调用task时，配置该参数
- Task.compression 属性。配置自定义 Task类的属性
- task_compression 在配置文件中配置 该属性
