如何在Ansible Playbook中限制指定任务仅在localhost执行？

你原来的写法存在一个关键误区：Ansible的任务级别并不支持hosts参数，这个参数只能在Play（也就是- hosts: ...的顶层层级）中定义。不过有几种简单靠谱的方式可以实现你想要的效果，让特定任务仅在本地执行：

方法1：使用delegate_to: localhost（推荐方案） #

这是最直观且广泛使用的方式，给需要本地执行的任务添加delegate_to参数，明确将任务委派到localhost执行：

- hosts: some_host_group
  tasks:
    - name: 创建本地测试文件（替代删除操作，便于验证）
      file:
        dest: /tmp/test_file
        state: present
      delegate_to: localhost  # 核心参数：指定任务在本地执行

    - name: 在远程主机执行其他业务任务
      file:
        dest: /remote/server/path/target_file
        state: absent

方法2：使用local_action模块 #

另一种等效写法是直接调用local_action来执行模块，适合习惯这种语法的场景：

- hosts: some_host_group
  tasks:
    - name: 创建本地测试文件
      local_action:
        module: file
        dest: /tmp/test_file
        state: present

    - name: 在远程主机执行其他业务任务
      file:
        dest: /remote/server/path/target_file
        state: absent

方法3：拆分出独立的本地Play #

如果你有多个需要在本地执行的任务，把它们单独放在一个针对localhost的Play块里，结构会更清晰：

# 先执行所有本地任务
- hosts: localhost
  connection: local  # 可选参数，跳过SSH连接，加速本地任务执行
  tasks:
    - name: 创建本地测试文件
      file:
        dest: /tmp/test_file
        state: present

# 再执行远程主机的任务
- hosts: some_host_group
  tasks:
    - name: 在远程主机执行其他业务任务
      file:
        dest: /remote/server/path/target_file
        state: absent

补充小提示 #

• 如果你使用Ansible 2.10及以上版本，delegate_to: 127.0.0.1和delegate_to: localhost效果完全一致，可根据习惯选择。
• 方法3中的connection: local并非强制要求，但加上它可以避免Ansible尝试通过SSH连接本地，能小幅提升执行速度。

内容的提问来源于stack exchange，提问作者Graham Nicholls