基础设施即代码 / 系统课时

执行异步长任务

执行异步长任务

耗时升级、索引重建或批量计算可能超过普通 SSH 会话的等待时间,也可能让大量主机依次阻塞。本课用 async 和 poll 控制长任务生命周期,并演示“后台启动后再汇合”的写法,让并发执行仍然有明确的完成检查。

学习目标

  • 理解 async 与 poll 分别控制什么
  • 使用 poll: 0 启动后台任务并保存作业 ID
  • 使用 ansible.builtin.async_status 等待、验证并清理异步作业

先决定是否需要等待结果

Ansible 默认同步执行任务:当前任务结束后才进入下一任务。设置 async 后,会给远端任务一个最长运行时间;poll 决定控制端是否持续等待结果。poll 大于 0 时仍会阻塞后续任务,只是按指定间隔轮询;poll: 0 则提交任务后立即继续执行。

Ansible async 与 poll 的两种执行路径

如果目标只是避免连接超时,但后续任务必须立刻依赖结果,可使用正数 poll。如果希望先把长任务尽快分发到多台主机,再在明确位置等待完成,则使用 poll: 0 并保存 ansible_job_id。

后台启动后显式汇合

下面用 15 秒任务模拟耗时操作。poll: 0 让任务立即返回,随后 async_status 根据作业 ID 等待完成。真实环境中可把 sleep 替换为升级、构建或维护命令。

yaml
---
- 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:

bash
ansible-playbook -i inventory.ini async-job.yml

预期输出的关键部分如下,主机名和 <ID> 会因环境而变化:

text
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 上限还应明显大于正常执行时间。上限过短会让远端进程在尚未完成时被终止;上限过长则会延迟真正的超时暴露。把并发启动、状态汇合和失败处理写成同一条可审计链路,才能让大规模长任务既快又可控。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行异步长任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通