基础设施即代码 / 系统课时
执行异步长任务
执行异步长任务
耗时升级、索引重建或批量计算可能超过普通 SSH 会话的等待时间,也可能让大量主机依次阻塞。本课用 async 和 poll 控制长任务生命周期,并演示“后台启动后再汇合”的写法,让并发执行仍然有明确的完成检查。
学习目标
- 理解
async与poll分别控制什么 - 使用
poll: 0启动后台任务并保存作业 ID - 使用
ansible.builtin.async_status等待、验证并清理异步作业
先决定是否需要等待结果
Ansible 默认同步执行任务:当前任务结束后才进入下一任务。设置 async 后,会给远端任务一个最长运行时间;poll 决定控制端是否持续等待结果。poll 大于 0 时仍会阻塞后续任务,只是按指定间隔轮询;poll: 0 则提交任务后立即继续执行。

如果目标只是避免连接超时,但后续任务必须立刻依赖结果,可使用正数 poll。如果希望先把长任务尽快分发到多台主机,再在明确位置等待完成,则使用 poll: 0 并保存 ansible_job_id。
后台启动后显式汇合
下面用 15 秒任务模拟耗时操作。poll: 0 让任务立即返回,随后 async_status 根据作业 ID 等待完成。真实环境中可把 sleep 替换为升级、构建或维护命令。
---
- name: Run long tasks asynchronously
hosts: workers
gather_facts: false
tasks:
- name: Start long-running operation
ansible.builtin.command:
argv:
- /usr/bin/sleep
- "15"
async: 60
poll: 0
register: long_job
- name: Show accepted async job id
ansible.builtin.debug:
var: long_job.ansible_job_id
- name: Wait for asynchronous job to finish
ansible.builtin.async_status:
jid: "{{ long_job.ansible_job_id }}"
register: job_result
until: job_result is finished
retries: 20
delay: 3
- name: Remove asynchronous job cache
ansible.builtin.async_status:
jid: "{{ long_job.ansible_job_id }}"
mode: cleanup预期结果:每台主机先快速返回自己的 ansible_job_id,控制端随后以该 ID 查询状态;约 15 秒后 job_result 进入完成状态,最后清理远端异步作业缓存。实际作业 ID 会不同,可将其视为 <ID>。
执行 Playbook:
ansible-playbook -i inventory.ini async-job.yml预期输出的关键部分如下,主机名和 <ID> 会因环境而变化:
TASK [Start long-running operation] ***
changed: [worker1]
TASK [Show accepted async job id] ***
ok: [worker1] => {
"long_job.ansible_job_id": "<ID>"
}
TASK [Wait for asynchronous job to finish] ***
changed: [worker1]选择 poll 大于 0 还是等于 0
当 poll 大于 0 时,Ansible 会定期查询异步任务,但当前 Play 仍要等它结束才继续。这个模式适合单个任务耗时很长、主要风险是连接超时,而下一步必须依赖其结果的情况。
poll: 0 更像“提交后台作业”。它适合先启动多个耗时任务,或者在等待期间安排其他不依赖该结果的工作;但后续若依赖结果,就必须自己建立 async_status 汇合点,不能把“已提交”误判成“已成功”。
避免把异步当成无条件并发
async 不是对所有模块都有效,也不会自动解决资源竞争。包管理器、数据库迁移等操作可能持有独占锁;如果用 poll: 0 后立即执行另一个访问同一资源的任务,反而容易造成锁冲突或状态竞争。
异步任务的 async 上限还应明显大于正常执行时间。上限过短会让远端进程在尚未完成时被终止;上限过长则会延迟真正的超时暴露。把并发启动、状态汇合和失败处理写成同一条可审计链路,才能让大规模长任务既快又可控。