基础设施即代码 / 系统课时
用 Handler 延迟触发动作
用 Handler 延迟触发动作
配置文件一旦变化,服务往往需要重载或重启;但每改一个文件就立刻执行一次会产生重复操作。Handler 把“发生变化”和“何时执行动作”分开,只在收到通知时进入待执行队列,并在刷新点统一处理。
学习目标
- 理解
notify、Handler 队列和延迟执行之间的关系。 - 让多个发生变化的任务共同触发同一个 Handler,并避免重复执行。
- 正确处理
flush_handlers、失败场景和真实服务重载。
Handler 为什么延迟执行
普通任务负责判断并修改配置,只有返回 changed: true 的任务才会发送 notify。通知不会立即调用 Handler,而是把对应 Handler 标记为待执行;同一个 Handler 被通知多次也只会保留一个待执行状态。

这种机制把高频的配置变化合并成一次低频动作。例如模板、证书和环境变量文件都发生变化时,可以共同通知同一个“重载服务” Handler,避免在一次 Play 中连续重载三次。
用 notify 聚合变化
下面用两个配置文件模拟同一个服务的配置来源,并用 touch 代表一次重载动作。示例不依赖系统中预装具体服务,适合直接在本机验证 Handler 的触发和去重行为。
- name: Verify handler notification
hosts: localhost
connection: local
gather_facts: false
tasks:
- name: Write main configuration
ansible.builtin.copy:
dest: /tmp/handler-demo.conf
content: "workers=4\n"
mode: "0644"
notify: reload demo service
- name: Write extra configuration
ansible.builtin.copy:
dest: /tmp/handler-demo-extra.conf
content: "keepalive=on\n"
mode: "0644"
notify: reload demo service
handlers:
- name: reload demo service
ansible.builtin.command:
cmd: /usr/bin/touch /tmp/handler-demo.reloaded把内容保存为 handler.yml,连续执行两次:
ansible-playbook -i localhost, -c local handler.yml
ansible-playbook -i localhost, -c local handler.yml预期输出如下,省略任务明细,只保留两次 PLAY RECAP:
localhost : ok=3 changed=3 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
localhost : ok=2 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0第一次运行时两个 copy 都变化,因此都发送通知,但 Handler 只执行一次,所以总共三项变化。第二次两个文件都已收敛,没有任务发送通知,Handler 不会出现在执行结果中。
控制执行时机与失败边界
默认延迟执行能减少抖动,但有些后续任务必须依赖“新配置已经生效”。这时可在依赖点之前使用 ansible.builtin.meta: flush_handlers,让当前已通知的 Handler 立即执行;之后若又发生新的通知,它还可以在后续刷新点再次运行。
notify 是否发生完全依赖任务的 changed 判定,因此错误的 changed_when 会直接破坏 Handler 语义。另一个重要边界是失败:某主机在通知 Handler 后又有后续任务失败时,默认可能导致该主机已排队的 Handler 不再执行;只有明确接受这种风险时才考虑 force_handlers: true 或 --force-handlers,并同时设计好服务重载失败的恢复策略。
把服务重载写成生产形态
真实 Playbook 中,Handler 通常使用服务模块,而不是直接执行重启命令。下面是一个片段示例,假设目标主机已经安装并由 systemd 管理 nginx;它只负责展示生产环境中 Handler 的推荐形态。
handlers:
- name: reload nginx
ansible.builtin.service:
name: nginx
state: reloaded配置任务只需要在可能影响 Nginx 运行状态时写 notify: reload nginx。如果多个任务都通知它,只要它们属于同一次待处理批次,Handler 仍只执行一次。
把 Handler 视为“变化后的统一副作用”更容易写对:任务负责把配置收敛到目标状态,changed 负责证明发生了变化,notify 负责登记需要执行的动作,Handler 则在合适的刷新点完成一次集中重载。