ansible 的 delegate_to: localhost（替代旧版 local_action）用于在控制节点本地执行任务，适用于访问本地文件、调用cli工具、运行前校验及避免敏感信息外泄等场景。
Ansible 的 local_action（或更现代的 delegate_to: localhost）本质是让某个 task 不在远程受控端执行，而是回到主控端（控制节点）本地运行。这在部署过程中实现“主控端与受控端联动”非常关键——比如：主控端生成配置、读取本地文件、调用 API 获取令牌、校验部署结果，再把结果传给后续远程任务使用。
明确 local_action 的适用场景
不是所有操作都需要本地执行，只有满足以下条件时才用：
• 需访问主控端本地文件（如模板、密钥、证书、版本清单）
• 需调用主控端已安装的 CLI 工具（如 git、jq、openssl、curl）
• 需在 playbook 运行中途做判断或预处理（如检查目标主机 IP 是否在白名单中）
• 需避免将敏感内容（如密码、token）明文传到受控端（先在本地解密/生成，再只传必要字段）
两种写法：local_action 与 delegate_to
local_action 是旧语法（Ansible 2.0+ 仍支持），但官方推荐使用 delegate_to: localhost，语义更清晰、兼容性更好。
二者等价，例如：
- 旧写法：
local_action: cmd: cat /tmp/deploy_id.txt - 新写法：
delegate_to: localhost<br>command: cat /tmp/deploy_id.txt
注意：使用 delegate_to: localhost 时，become 默认不生效（因本地非 root 执行），如需提权，显式加 become: true 并确保本地有对应权限。
典型联动操作示例
常见需求是“先在主控端准备数据，再推送给受控端”，例如：
-
生成唯一部署标识并同步到远程：
- name: Generate deploy ID on controller<br> delegate_to: localhost<br> shell: date +%s%N | cut -c1-13<br> register: deploy_id
- name: Write ID to remote host<br> copy:<br> content: "{{ deploy_id.stdout }}\n"<br> dest: /opt/app/deploy.id -
读取本地配置模板，渲染后发到远程：
- name: Render config from local template<br> delegate_to: localhost<br> template:<br> src: ./templates/app.conf.j2<br> dest: /tmp/app.conf.generated<br> vars:<br> app_version: "v2.4.1"<br> db_host: "{{ hostvars[inventory_hostname]['db_endpoint'] }}"- name: Deploy rendered config<br> copy:<br> src: /tmp/app.conf.generated<br> dest: /etc/myapp/app.conf
-
调用本地 curl 查询发布平台状态，决定是否继续：
- name: Check canary release status<br> delegate_to: localhost<br> uri:<br> url: "https://api.release.example.com/v1/deploy/{{ inventory_hostname }}/status"<br> return_content: yes<br> register: release_check- name: Fail if not approved<br> fail:<br> msg: "Release not approved for {{ inventory_hostname }}"<br> when: release_check.json.status != "approved"
注意事项与避坑点
联动容易出错，关键细节要盯住：
• delegate_to: localhost 后，inventory_hostname 仍是当前受控主机名，可用于动态拼接路径或变量
• 主控端必须提前装好所需工具（如 jq、yq、openssl），Ansible 不会帮你装
• 本地任务失败会导致整个 play 中断，建议对非关键本地步骤加 ignore_errors: true
• 若需在多个受控主机上分别触发不同本地操作，用 loop + delegate_to，别误用 run_once: true
• 变量作用域：主控端任务注册的 register 变量，在后续远程任务中可直接引用（如 {{ deploy_id.stdout }}），无需额外 set_fact
