基础设施即代码 / 系统课时

采集并使用 Facts

采集并使用 Facts

Facts 是 Ansible 从目标主机采集的运行时信息,包括操作系统、架构、网络接口、内存和挂载点等。掌握 ansible_facts 后,可以让同一个 Playbook 根据主机真实状态做条件判断,而不是为每种机器维护一套硬编码配置。

学习目标

  • 理解 Facts 的采集时机与 ansible_facts 数据结构
  • 读取常用系统事实并验证实际值
  • 使用 Facts 驱动条件分支,并知道何时缩小采集范围

Facts 如何进入任务

Play 默认启用 gather_facts。在任务执行前,Ansible 会调用事实采集机制读取目标主机信息,并把结果放入 ansible_facts 字典。后续任务、模板和条件表达式都可以读取这份数据。

Ansible 从目标主机采集 Facts 并用于条件判断的数据流

先在本机直接调用 setup 模块,只筛选发行版相关事实:

bash
ansible localhost -c local -m ansible.builtin.setup -a 'filter=ansible_distribution*'

预期输出会因当前系统不同而变化,其中发行版名称和版本应替换为实际值:

text
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,并根据操作系统家族给出包管理器提示。

yaml
- 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 }}"

运行:

bash
ansible-playbook facts.yml

预期输出的具体平台值会变化,但应先看到事实,再看到基于 os_family 得出的分支结果:

text
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:

yaml
- 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。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

采集并使用 Facts

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通