异步操作和轮询

默认情况下playbook中的任务执行时会一直保持连接,直到该任务在每个节点都执行完毕.有时这是不必要的,比如有些操作运行时间比SSH超时时间还要长.

解决该问题最简单的方式是一起执行它们,然后轮询直到任务执行完毕.

你也可以对执行时间非常长（有可能遭遇超时）的操作使用异步模式.

为了异步启动一个任务,可以指定其最大超时时间以及轮询其状态的频率.如果你没有为 poll 指定值,那么默认的轮询频率是10秒钟:

  1. ---
  2.  
  3. - hosts: all
  4.   remote_user: root
  5.  
  6.   tasks:
  7.  
  8.   - name: simulate long running op (15 sec), wait for up to 45 sec, poll every 5 sec
  9.     command: /bin/sleep 15
  10.     async: 45
  11.     poll: 5

Note

async 并没有默认值,如果你没有指定 async 关键字,那么任务会以同步的方式运行,这是Ansible的默认行为.

另外,如果你不需要等待任务执行完毕,你可以指定 poll 值为0而启用 “启动并忽略”

  1. ---
  2.  
  3. - hosts: all
  4.   remote_user: root
  5.  
  6.   tasks:
  7.  
  8.   - name: simulate long running op, allow to run for 45 sec, fire and forget
  9.     command: /bin/sleep 15
  10.     async: 45
  11.     poll: 0

Note

对于要求排它锁的操作,如果你需要在其之后对同一资源执行其它任务,那么你不应该对该操作使用”启动并忽略”.比如yum事务.

Note

—forks 参数值过大会更快的触发异步任务.也会加快轮询的效率.

当你想对 “启动并忽略” 做个变种,改为”启动并忽略,稍后再检查”,你可以使用以下方式执行任务:

  1. ---
  2. # Requires ansible 1.8+
  3. - name: 'YUM - fire and forget task'
  4.   yum: name=docker-io state=installed
  5.   async: 1000
  6.   poll: 0
  7.   register: yum_sleeper
  8.  
  9. - name: 'YUM - check on fire and forget task'
  10.   async_status: jid={{ yum_sleeper.ansible_job_id }}
  11.   register: job_result
  12.   until: job_result.finished
  13.   retries: 30

Note

如果 async: 值太小,可能会导致 “稍后检查” 任务执行失败,因为 async_status:: 的临时状态文件还未被写入信息,而”稍后检查”任务就试图读取此文件.

See also