基础设施即代码 / 系统课时
采集并使用 Facts
采集并使用 Facts
Facts 是 Ansible 从目标主机采集的运行时信息,包括操作系统、架构、网络接口、内存和挂载点等。掌握 ansible_facts 后,可以让同一个 Playbook 根据主机真实状态做条件判断,而不是为每种机器维护一套硬编码配置。
学习目标
- 理解 Facts 的采集时机与
ansible_facts数据结构 - 读取常用系统事实并验证实际值
- 使用 Facts 驱动条件分支,并知道何时缩小采集范围
Facts 如何进入任务
Play 默认启用 gather_facts。在任务执行前,Ansible 会调用事实采集机制读取目标主机信息,并把结果放入 ansible_facts 字典。后续任务、模板和条件表达式都可以读取这份数据。

先在本机直接调用 setup 模块,只筛选发行版相关事实:
ansible localhost -c local -m ansible.builtin.setup -a 'filter=ansible_distribution*'预期输出会因当前系统不同而变化,其中发行版名称和版本应替换为实际值:
localhost | SUCCESS => {
"ansible_facts": {
"ansible_distribution": "<VALUE>",
"ansible_distribution_major_version": "<VALUE>",
"ansible_distribution_version": "<VALUE>"
},
"changed": false
}<VALUE> 是动态值。完整 Facts 很大,调试时优先使用 filter 或 gather_subset 缩小输出,比把全部事实打印到日志更容易阅读。
在 Playbook 中读取事实
推荐从 ansible_facts 字典读取事实,这样来源清晰,也不会依赖旧式顶层事实变量注入。下面的 Playbook 读取操作系统、架构和默认 IPv4,并根据操作系统家族给出包管理器提示。
- name: Use gathered facts
hosts: localhost
connection: local
gather_facts: true
tasks:
- name: Show selected facts
ansible.builtin.debug:
msg: >-
os={{ ansible_facts.distribution }}
arch={{ ansible_facts.architecture }}
ipv4={{ ansible_facts.default_ipv4.address | default('N/A') }}
- name: Choose package manager hint
ansible.builtin.set_fact:
package_manager_hint: >-
{{
'apt'
if ansible_facts.os_family == 'Debian'
else 'dnf'
if ansible_facts.os_family == 'RedHat'
else 'manual'
}}
- name: Show decision
ansible.builtin.debug:
msg: "package_manager_hint={{ package_manager_hint }}"运行:
ansible-playbook facts.yml预期输出的具体平台值会变化,但应先看到事实,再看到基于 os_family 得出的分支结果:
ok: [localhost] => {
"msg": "os=<VALUE> arch=<VALUE> ipv4=<VALUE>"
}
ok: [localhost] => {
"msg": "package_manager_hint=<VALUE>"
}这里第二个 <VALUE> 在 Debian 家族上为 apt,在 Red Hat 家族上为 dnf,其他平台为 manual。这就是 Facts 最常见的用途:先观察主机,再决定执行路径。
控制采集成本与边界
Facts 不是越多越好。大型 Inventory 中,如果 Play 只需要少量系统信息,可以通过 gather_subset 减少采集内容;如果完全不依赖 Facts,则直接关闭 gather_facts。
下面是一个只采集最小事实集并额外保留网络相关事实的片段示例,它依赖一个正常可连接的目标主机组 all:
- name: Gather a reduced fact set
hosts: all
gather_facts: true
gather_subset:
- min
- network
tasks:
- name: Verify architecture
ansible.builtin.debug:
var: ansible_facts.architecture生效行为是:Ansible 不再按默认范围收集所有事实,而只保留最小集合和网络相关集合。验证方法是运行 Playbook 后检查 ansible_facts.architecture 能正常输出,并用 ansible localhost -m setup 对比完整 Facts 数量。
把 Facts 当作只读的运行时输入最容易维护:用它识别平台与环境,用 when、模板或变量计算做决策,而不是把主机差异硬编码进多份 Playbook。