Ansible自定义事实无法在Playbook中调用问题求助

核心问题定位 #

自定义事实不会直接作为顶级变量存在，而是被嵌套在ansible_facts字典的对应命名空间下——也就是你定义的ogg_fact_general这个层级里，直接调用ogg_fact_version自然会提示变量未定义。

步骤1：确认自定义事实的变量结构 #

先通过setup命令确认变量的完整路径，执行：

ansible lnx072 -m ansible.builtin.setup | grep -A 15 ogg_fact_general

输出会类似：

"ogg_fact_general": {
    "ogg_fact_version": "12.3.0.1",
    "ogg_fact_environment_type": "prod"
}

这说明完整变量路径是ansible_facts.ogg_fact_general.ogg_fact_version和ansible_facts.ogg_fact_general.ogg_fact_environment_type。

步骤2：Playbook中正确调用自定义事实 #

验证变量可用性 #

先写个简单Playbook确认变量能正常读取：

- name: Validate custom facts
  hosts: lnx072
  gather_facts: yes  # 默认开启，显式声明更稳妥
  tasks:
    - name: Print OGG version
      ansible.builtin.debug:
        msg: "OGG版本：{{ ansible_facts.ogg_fact_general.ogg_fact_version }}"
    - name: Print environment type
      ansible.builtin.debug:
        msg: "环境类型：{{ ansible_facts.ogg_fact_general.ogg_fact_environment_type }}"

模板文件名配置实现 #

如果要将这两个变量作为目标文件名的一部分，直接在template模块的dest参数中拼接即可：

- name: Generate config file with custom fact in filename
  hosts: lnx072
  tasks:
    - name: Deploy OGG config
      ansible.builtin.template:
        src: ogg_config.j2
        dest: "/opt/ogg/config/ogg_{{ ansible_facts.ogg_fact_general.ogg_fact_version }}_{{ ansible_facts.ogg_fact_general.ogg_fact_environment_type }}.conf"
        mode: '0644'

常见排查点 #

• 检查事实文件格式：自定义事实文件必须以.fact为后缀（比如ogg_fact_general.fact），放在/etc/ansible/facts.d/目录下，权限设置为0644确保Ansible执行用户能读取。
  • INI格式示例：

    [ogg_fact_general]
    ogg_fact_version=12.3.0.1
    ogg_fact_environment_type=prod
    

  • JSON格式示例：

    {
        "ogg_fact_version": "12.3.0.1",
        "ogg_fact_environment_type": "prod"
    }
    

• 强制收集所有事实：如果Playbook中设置了gather_facts: no，需要手动调用setup模块并指定gather_subset: all：

  - name: Gather all facts explicitly
    ansible.builtin.setup:
      gather_subset: all
  

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