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

使用 Delegate 与 Run Once

使用 Delegate 与 Run Once

多主机编排中,任务的目标主机和实际执行节点并不总相同。delegate_to 可把步骤移到指定节点执行,run_once 则限制当前批次只运行一次;组合两者,可准确控制摘流、登记等全局动作。

学习目标

  • 区分 inventory_hostname 所代表的目标主机与 delegate_to 指定的执行节点。
  • 使用 run_once 控制只需执行一次的全局任务,并理解它与批次的关系。
  • 验证委派结果,避免在滚动发布中把“一次”误解为“整个 Play 永远一次”。

先区分目标主机与执行节点

普通任务在当前目标主机上执行;加入 delegate_to: lb01 后,Ansible 仍然为当前目标主机处理这条任务,但连接与模块执行发生在 lb01。因此任务中使用 inventory_hostname 时,拿到的仍是原目标主机名,这正适合让负载均衡节点逐一处理 app01、app02。

run_once: true 改变的是“选多少个目标主机执行这条任务”,不是“在哪台机器执行”。两者组合后,Ansible 先从当前批次选择一个目标主机上下文,再把实际执行委派给指定节点。

Delegate 与 Run Once 的目标主机、委派节点和一次性任务关系

组合 Delegate 与 Run Once

下面用本机连接模拟三台 Inventory 主机,因此无需准备真实服务器。保存为 inventory.ini:

ini
[app]
app01 ansible_connection=local
app02 ansible_connection=local

[lb]
lb01 ansible_connection=local

再保存 deploy.yml。第一组任务会针对每个应用节点委派到 lb01;第二组任务只选择一次目标主机上下文,并委派到控制机的 localhost。

yaml
- name: 演示委派与一次性任务
  hosts: app
  gather_facts: false
  tasks:
    - name: 在 lb01 为当前应用节点生成摘流指令
      ansible.builtin.command:
        argv:
          - /usr/bin/printf
          - "drain %s\n"
          - "{{ inventory_hostname }}"
      delegate_to: lb01
      register: drain_result
      changed_when: false

    - name: 显示每个目标主机的委派结果
      ansible.builtin.debug:
        msg: "{{ drain_result.stdout }}"

    - name: 全局只生成一次发布标记
      ansible.builtin.command:
        argv:
          - /usr/bin/printf
          - "release-ready\n"
      delegate_to: localhost
      run_once: true
      register: release_marker
      changed_when: false

    - name: 显示一次性任务结果
      ansible.builtin.debug:
        msg: "{{ release_marker.stdout }}"
      run_once: true

配置生效行为是:drain 命令执行两次,实际都在 lb01;发布标记任务只执行一次,实际在 localhost。若把真实负载均衡 API 调用替换进第一条任务,就能保持“每个应用节点一条摘流动作”的语义。

运行并核对输出

执行 Playbook:

bash
ansible-playbook -i inventory.ini deploy.yml

预期输出的关键部分如下;任务耗时和 recap 数字可能因 Ansible 版本不同而略有差异。

text
TASK [在 lb01 为当前应用节点生成摘流指令] ***
ok: [app01 -> lb01]
ok: [app02 -> lb01]

TASK [显示每个目标主机的委派结果] ***
ok: [app01] => {"msg": "drain app01"}
ok: [app02] => {"msg": "drain app02"}

TASK [全局只生成一次发布标记] ***
ok: [app01 -> localhost]

TASK [显示一次性任务结果] ***
ok: [app01] => {"msg": "release-ready"}

这里最重要的证据不是 recap,而是箭头后的执行节点:两台应用主机都显示 -> lb01;带 run_once 的任务只出现一条 -> localhost 记录。若 Inventory 顺序变化,被选作一次性任务上下文的主机也可能变化,不要把 app01 当成固定契约。

注意批次与变量边界

当 Play 使用 serial 时,run_once 是每个批次一次,不是整个 Play 永远一次。例如 serial: 1 配合两台应用主机时,一次性任务可能执行两次。若业务要求整场发布只执行一次,应额外用全局条件锁定首个 Play 主机,例如 when: inventory_hostname == ansible_play_hosts_all[0],或把真正的全局步骤拆成单独的 Play。

委派时也要区分变量来源:inventory_hostname 仍指向原目标主机,而连接地址、解释器等与执行环境相关的变量会按委派节点解析。需要在委派节点上采集并保存 facts 时,再显式考虑 delegate_facts: true,不要默认把委派节点事实写回原目标主机。

delegate_to 解决“在哪执行”,run_once 解决“选几个目标主机上下文执行”。把这两个维度分开思考,才能在负载均衡、数据库迁移、发布登记等多主机流程里准确控制副作用。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Delegate 与 Run Once

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

登录哪都通