怎么在Ansible中利用Delegate_To在特定主机执行任务-linux运维-PHP中文网

delegate_to 是让 ansible 在指定主机（非目标主机）上执行任务但保留原始主机变量上下文的机制；需确保委托目标在 inventory 中定义且连接可达，变量引用须用 hostvars 显式获取原始主机数据。

怎么在ansible中利用delegate_to在特定主机执行任务

Delegate_to 是用来绕过当前 play 目标主机的执行跳转机制

它不是“在另一台机器上跑这个任务”，而是让 Ansible 控制节点（或你指定的某台 host）来执行该 task，同时保留原始 host 的变量上下文。常见误解是以为它能替代 delegate_to: localhost 就等于“本地执行”——其实不一定，得看你的 inventory 和 connection 配置是否真把 localhost 当作可连接节点。

典型使用场景包括：在跳板机上触发部署、在某台 DB 主机上执行备份脚本、对一组目标主机统一调用一个外部 API（但只由一台机器发请求）。

delegate_to 不会自动切换变量作用域，hostvars、inventory_hostname 等仍指向原始 host
如果委托到 localhost，需确保 connection: local 或已配置好 SSH 到 localhost 的密钥；否则可能报 FAILED! => {"msg": "Failed to connect to the host via ssh"}
委托目标必须出现在当前 play 的 hosts 列表里，或显式加进 inventory（哪怕只是 localhost ansible_connection=local）

delegate_to: localhost 为什么有时不生效

最常踩的坑是：你以为 localhost 总是可用，但它在默认 inventory 里未必被定义，或者被定义为不可达。Ansible 不会为你自动创建一个“逻辑 localhost”，它严格按 inventory 解析。

检查方式很简单：ansible-inventory -i your_inventory.yml --list | grep localhost。如果没输出，那它就不在 scope 内。

修复方法是在 inventory 文件顶部加一行：localhost ansible_connection=local

若用 YAML 格式 inventory，写成：

- name: localhost
  hosts: localhost
  connection: local

别依赖 127.0.0.1 替代 localhost，除非 inventory 明确写了 127.0.0.1 这个 hostname，否则变量如 hostvars['localhost'] 会取不到值

委托时如何正确引用原始主机的变量

你委托任务到别的主机执行，但往往还要操作原始主机的信息——比如生成一个以目标主机名命名的文件、或把它的 IP 写进配置。这时候不能直接写 {{ inventory_hostname }}，因为委托后当前上下文已经是新 host。

必须显式通过 hostvars 获取原始 host 数据：

- name: Write target's IP to remote config
  delegate_to: jumpbox
  copy:
    content: "target_ip={{ hostvars[inventory_hostname]['ansible_host'] | default(inventory_hostname) }}"
    dest: "/tmp/{{ inventory_hostname }}_config.txt"

inventory_hostname 在 task 中始终代表原始 host 名（即当前 loop 的那个 host）
不要用 play_hosts 或 groups 直接索引，它们不保证顺序且易受动态 inventory 影响
如果原始 host 没跑过 setup 模块（比如用了 gather_facts: false），hostvars[...]['ansible_host'] 可能为空，建议 fallback 到 inventory_hostname

delegate_to 和 run_once 的组合陷阱

两者经常一起用，比如“只在一台机器上执行一次命令，并委托给跳板机”。但要注意：run_once 是针对 play 内所有 host 的去重，而 delegate_to 是 per-task 的跳转。它们不互斥，但行为叠加容易误判。

例如你对 10 台 web server 执行一个 task，设了 run_once: true + delegate_to: jumpbox，结果是：整个 play 只触发一次该 task，且这次执行发生在 jumpbox 上——而不是每台 web server 各自委托一次。

如果你想要“每台 web server 都触发一次，但都在 jumpbox 上执行”，就别加 run_once
如果你还用了 loop 或 with_items，run_once 会让整个 loop 只跑一遍，不是 loop 内每个 item 跑一遍
委托目标本身如果是动态生成的（比如从 facts 里取的 {{ some_var }}），要确保该变量在委托发生前已确定，否则会报 undefined variable

真正难的不是写对 delegate_to，而是厘清“谁在执行”“谁的变量可用”“谁在连接”这三件事是否一致。inventory 定义、connection 类型、变量作用域，三个地方错一个，就会静默失败或行为偏移。