【自动化运维神器Ansible】playbook核心组件之Handlers和notify深度解析

• Handlers：本质上也是task，但只在被notify通知时才会执行
• notify：任务属性，用于在任务引发变化时触发指定的handler
• 执行时机：所有普通任务执行完毕后，才会运行被触发的handlers
• 幂等性：无论被通知多少次，handler只执行一次

• Ansible按顺序执行play中的各个task
• 每个task执行后检查结果状态（changed/failed/ok）
• 如果状态为changed且定义了notify，则记录需要触发的handler
• 所有普通task执行完毕后，检查被触发的handler列表
• 按照handler的定义顺序（而非触发顺序）执行被触发的handler
• 每个handler无论被通知多少次，在整个play中只执行一次

tasks:
  - name: 更新配置文件
    template:
      src: app.conf.j2
      dest: /etc/app.conf
    notify:  # 触发handler
      - 重启应用服务
      - 重载日志配置

handlers:
  - name: 重启应用服务
    service:
      name: app_service
      state: restarted
  
  - name: 重载日志配置
    command: /usr/bin/app --reload-log

tasks:
  - name: 更新主配置
    template:
      src: main.conf.j2
      dest: /etc/main.conf
    notify: 重启服务
  
  - name: 更新路由规则
    copy:
      src: routes.json
      dest: /etc/routes.json
    notify: 重启服务

handlers:
  - name: 重启服务
    service:
      name: myapp
      state: restarted

tasks:
  - name: 部署应用
    copy:
      src: "{{ item }}"
      dest: /opt/app/
    loop:
      - app.jar
      - config.properties
    notify: 变更应用权限

handlers:
  - name: 变更应用权限
    file:
      path: /opt/app/
      mode: "{{ app_mode | default('0755') }}"
      recurse: yes

tasks:
  - name: 配置生产环境
    template:
      src: prod.env.j2
      dest: /etc/prod.env
    notify: 通知监控系统
    when: env == 'prod'

handlers:
  - name: 通知监控系统
    uri:
      url: "http://monitor/api/refresh"
      method: POST
    when: monitoring_enabled  # handler自身也可以有条件

handlers:
  - name: 数据库迁移
    command: /opt/app/db/migrate.sh
    listen: "数据库变更"  # 使用listen替代name实现多handler关联

tasks:
  - name: 更新schema
    copy:
      src: schema.sql
      dest: /opt/app/db/
    notify: "数据库变更"
  
  - name: 更新存储过程
    template:
      src: sproc.j2
      dest: /opt/app/db/sproc.sql
    notify: "数据库变更"

handlers:
  - name: 第一步操作
    command: echo "第一步"
    listen: "多步流程"
  
  - name: 第二步操作
    command: echo "第二步"
    listen: "多步流程"

  - name: 最终操作
    command: echo "完成"
    listen: "多步流程"

tasks:
  - name: 触发流程
    debug:
      msg: "开始多步流程"
    notify: "多步流程"

handlers:
  - name: 安全重启
    service:
      name: "{{ service_name }}"
      state: restarted
    async: 30  # 异步执行避免超时
    poll: 0    # 不等待结果
    no_log: true  # 不记录敏感日志

• 合并同类Handler：将多个触发点合并为一个handler
• 异步执行：长时间运行的handler设置为async
• 条件过滤：通过when条件减少不必要执行
• 标签管理：使用tags选择性触发handler

handlers:
  - name: 带错误处理的Handler
    block:
      - name: 主操作
        command: /opt/scripts/update.sh
      
      - name: 失败通知
        slack:
          token: "{{ slack_token }}"
          msg: "Handler执行失败: {{ inventory_hostname }}"
        when: "'主操作' in ansible_failed_tasks"
    rescue:
      - name: 错误恢复
        debug:
          msg: "执行恢复操作"

tasks:
  - name: 部署Nginx配置
    template:
      src: nginx.conf.j2
      dest: /etc/nginx/nginx.conf
    notify: 重载Nginx配置

handlers:
  - name: 重载Nginx配置
    service:
      name: nginx
      state: reloaded  # 使用reloaded而非restarted避免连接中断

tasks:
  - name: 更新数据库脚本
    copy:
      src: "db/changes/{{ db_version }}.sql"
      dest: /opt/db/changes.sql
    notify: 执行数据库变更

handlers:
  - name: 执行数据库变更
    mysql_db:
      name: "{{ db_name }}"
      state: import
      target: /opt/db/changes.sql
    when: db_change_required  # 通过变量控制是否执行

tasks:
  - name: 分发集群配置
    template:
      src: cluster.xml.j2
      dest: /etc/cluster/config.xml
    notify: 同步集群状态

handlers:
  - name: 同步集群状态
    command: /usr/bin/cluster-admin --sync
    delegate_to: "{{ groups['cluster_master'][0] }}"  # 委托给主节点执行
    run_once: true  # 只需执行一次

- name: 主play
  hosts: all
  tasks:
    - name: 修改配置1
      template:
        src: config1.j2
        dest: /etc/config1
      notify: 最终处理
  
    - name: 修改配置2
      template:
        src: config2.j2
        dest: /etc/config2
      notify: 最终处理
  
  handlers:
    - name: 最终处理
      command: /opt/run-final.sh
      listen: "最终处理"

- name: 显式触发handler
  hosts: all
  tasks:
    - meta: flush_handlers

handlers:
  - name: 预处理
    command: echo "第一步"
    listen: "ordered_handlers"
  
  - name: 主处理
    command: echo "第二步"
    listen: "ordered_handlers"
  
  - name: 后处理
    command: echo "第三步"
    listen: "ordered_handlers"

tasks:
  - name: 触发有序处理
    debug:
      msg: "开始有序处理流程"
    notify: "ordered_handlers"