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

用 Handler 延迟触发动作

用 Handler 延迟触发动作

配置文件一旦变化,服务往往需要重载或重启;但每改一个文件就立刻执行一次会产生重复操作。Handler 把“发生变化”和“何时执行动作”分开,只在收到通知时进入待执行队列,并在刷新点统一处理。

学习目标

  • 理解 notify、Handler 队列和延迟执行之间的关系。
  • 让多个发生变化的任务共同触发同一个 Handler,并避免重复执行。
  • 正确处理 flush_handlers、失败场景和真实服务重载。

Handler 为什么延迟执行

普通任务负责判断并修改配置,只有返回 changed: true 的任务才会发送 notify。通知不会立即调用 Handler,而是把对应 Handler 标记为待执行;同一个 Handler 被通知多次也只会保留一个待执行状态。

Ansible notify 与 Handler 延迟去重流程

这种机制把高频的配置变化合并成一次低频动作。例如模板、证书和环境变量文件都发生变化时,可以共同通知同一个“重载服务” Handler,避免在一次 Play 中连续重载三次。

用 notify 聚合变化

下面用两个配置文件模拟同一个服务的配置来源,并用 touch 代表一次重载动作。示例不依赖系统中预装具体服务,适合直接在本机验证 Handler 的触发和去重行为。

yaml
- 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,连续执行两次:

bash
ansible-playbook -i localhost, -c local handler.yml
ansible-playbook -i localhost, -c local handler.yml

预期输出如下,省略任务明细,只保留两次 PLAY RECAP:

text
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 的推荐形态。

yaml
handlers:
  - name: reload nginx
    ansible.builtin.service:
      name: nginx
      state: reloaded

配置任务只需要在可能影响 Nginx 运行状态时写 notify: reload nginx。如果多个任务都通知它,只要它们属于同一次待处理批次,Handler 仍只执行一次。

把 Handler 视为“变化后的统一副作用”更容易写对:任务负责把配置收敛到目标状态,changed 负责证明发生了变化,notify 负责登记需要执行的动作,Handler 则在合适的刷新点完成一次集中重载。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Handler 延迟触发动作

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

登录哪都通