如何让Ansible Playbook仅在各清单组首台主机运行且支持组限制？

你可以通过两种灵活的方式实现需求，无需在Playbook中硬编码组名，执行时可动态指定目标组，确保每个组仅在第一台主机上运行任务：

方法一：任务级条件判断（单Play实现） #

直接在任务中添加条件，判断当前主机是否为其所属指定组的第一个成员。执行时通过--limit参数指定要运行的组即可。

示例Playbook：

- name: 仅在指定组的第一台主机执行任务
  hosts: all
  tasks:
    - name: 执行目标操作（示例：打印信息）
      debug:
        msg: "当前是{{ group_names[0] }}组的第一台主机：{{ inventory_hostname }}"
      # 条件：当前主机等于所属组的第一个成员
      when: inventory_hostname == groups[group_names[0]][0]

执行命令：

ansible-playbook your_playbook.yml --limit ego,asp

说明： #

• group_names[0]：获取当前主机所属的第一个组（因--limit限制了范围，主机只会在你指定的组内）
• groups[group_names[0]][0]：取出该组的第一个主机名
• 条件判断确保只有组内第一台主机执行任务

方法二：动态生成目标主机组（多Play实现） #

先收集所有指定组的第一台主机，动态生成一个目标组，后续Play仅针对该组执行。这种方式更清晰，尤其适合需要多任务串联的场景。

示例Playbook：

- name: 收集指定组的第一台主机
  hosts: localhost
  gather_facts: false
  tasks:
    - name: 提取每个指定组的第一台主机
      set_fact:
        target_hosts: "{{ (target_hosts | default([]) + [groups[item][0]]) | unique }}"
      loop: "{{ ansible_limit.split(',') }}"
      when: ansible_limit is defined and groups[item] is defined

    - name: 将目标主机添加到动态组
      add_host:
        name: "{{ item }}"
        groups: first_hosts_of_groups
      loop: "{{ target_hosts }}"

- name: 在目标主机执行核心任务
  hosts: first_hosts_of_groups
  tasks:
    - name: 执行你的业务操作
      debug:
        msg: "运行在{{ inventory_hostname }}，属于{{ group_names }}组"

执行命令：

ansible-playbook your_playbook.yml --limit bre,ego

说明： #

• ansible_limit：自动获取命令行--limit指定的组列表
• unique：避免同一主机被多次添加（比如server1是多个组的第一台时）
• 动态组first_hosts_of_groups仅包含每个指定组的第一台主机，后续Play直接针对该组执行

两种方法都无需在Playbook中固定组名，完全通过命令行参数控制目标组，满足你灵活选择组并仅执行组内第一台主机的需求。

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