如何限制Ansible的setup模块仅获取主机名？ansible_hostname属哪个gather_subset？

首先直接给你明确答案：ansible_hostname属于min这个gather_subset。这个子集是Ansible提供的最小信息集合，包含最基础的主机标识和核心系统指标，刚好能满足你只获取hostname这类关键基础信息的需求，同时大幅减少数据采集量。

如何限制setup模块仅获取hostname（基于gather_subset） #

有两种常用方式，分别适配ad-hoc命令和playbook场景：

1. Ad-hoc命令方式

直接在命令行调用setup模块，指定gather_subset=min，就能只采集包含hostname的最小数据集：

ansible your_host_group -m setup -a "gather_subset=min"

执行后返回的结果里会包含ansible_hostname字段，同时只会附带min子集里的其他少量基础字段（比如ansible_fqdn、ansible_python_version等），远少于默认all子集的采集量。

如果只想单独提取hostname，还可以配合简单的文本过滤：

ansible your_host_group -m setup -a "gather_subset=min" | grep -A1 "ansible_hostname"

2. Playbook方式

在play中配置gather_subset参数，明确指定只收集min子集：

- name: Verify correct host via hostname with minimal facts
  hosts: your_target_hosts
  gather_facts: true
  gather_subset: min  # 关键配置：仅收集最小子集
  tasks:
    - name: Print the connected host's hostname
      debug:
        msg: "Successfully connected to target host: {{ ansible_hostname }}"

这样整个play在收集facts阶段只会获取min子集的数据，既提升了执行速度，又能拿到你需要的hostname来验证连接正确性。

补充说明 #

如果你想更极致地锁定最小采集范围，也可以用gather_subset: !all,!min,min的写法，本质和直接写min效果一致，都是排除所有其他子集只保留min。另外要注意：ansible_hostname并不属于更小的专属子集，min是包含它的最小集合，这是最符合你需求的选择。

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