发现变量：事实和魔法变量

使用 Ansible，您可以检索或发现某些包含有关远程系统或 Ansible 本身的信息的变量。与远程系统相关的变量称为事实。使用事实，您可以将一个系统的行为或状态用作其他系统的配置。例如，您可以将一个系统的 IP 地址用作另一个系统的配置值。与 Ansible 相关的变量称为魔法变量。

键值对中的键将被转换为小写，放入 ansible_local 变量中。使用上面的示例，如果 ini 文件在 [general] 部分包含 XYZ=3，则您应该以这种方式访问它：{{ ansible_local['preferences']['general']['xyz'] }} 而不是 {{ ansible_local['preferences']['general']['XYZ'] }}。这是因为 Ansible 使用 Python 的 ConfigParser，它将所有选项名称通过 optionxform 方法，而此方法的默认实现会将选项名称转换为小写。

您也可以使用 facts.d 在远程主机上执行脚本，生成动态自定义 facts 到 ansible_local 命名空间。例如，您可以生成远程主机上所有存在的用户的列表作为该主机的 fact。要使用 facts.d 生成动态自定义 facts，

编写并测试一个脚本，以生成您想要的 JSON 数据。

将脚本保存到您的 facts.d 目录中。

确保您的脚本具有 .fact 文件扩展名。

确保您的脚本可由 Ansible 连接用户执行。

收集 facts 以执行脚本并将 JSON 输出添加到 ansible_local。

默认情况下，fact 收集在每个 playbook 开始时只运行一次。如果您在 playbook 中使用 facts.d 创建了自定义 fact，它将在下一个收集 facts 的 playbook 中可用。如果您想在创建它的同一个 playbook 中使用它，您必须显式地重新运行 setup 模块。例如

- hosts: webservers
  tasks:

    - name: Create directory for ansible custom facts
      ansible.builtin.file:
        state: directory
        recurse: true
        path: /etc/ansible/facts.d

    - name: Install custom ipmi fact
      ansible.builtin.copy:
        src: ipmi.fact
        dest: /etc/ansible/facts.d

    - name: Re-read facts after adding custom fact
      ansible.builtin.setup:
        filter: ansible_local

如果您经常使用这种模式，自定义 facts 模块将比 facts.d 更有效率。

关于 Ansible：魔法变量 

您可以使用“魔法”变量访问有关 Ansible 操作的信息，包括正在使用的 Python 版本、清单中的主机和组以及 playbook 和角色的目录。与连接变量一样，魔法变量是特殊变量。魔法变量名是保留的 - 不要使用这些名称设置变量。变量 environment 也是保留的。

最常用的魔法变量是 hostvars、groups、group_names 和 inventory_hostname。使用 hostvars，您可以在 playbook 的任何地方访问为 playbook 中任何主机定义的变量。您也可以使用 hostvars 变量访问 Ansible facts，但前提是您已经收集（或缓存）了 facts。请注意，在 playbook 对象中定义的变量没有为特定主机定义，因此不会映射到 hostvars。

如果您想使用另一个节点的“fact”的值或分配给另一个节点的清单变量的值来配置您的数据库服务器，您可以在模板或操作行中使用 hostvars

{{ hostvars['test.example.com']['ansible_facts']['distribution'] }}

使用 groups，它是清单中所有组（和主机）的列表，您可以枚举组中的所有主机。例如

{% for host in groups['app_servers'] %}
   # something that applies to all app servers.
{% endfor %}

您可以将 groups 和 hostvars 结合使用，以查找组中的所有 IP 地址。

{% for host in groups['app_servers'] %}
   {{ hostvars[host]['ansible_facts']['eth0']['ipv4']['address'] }}
{% endfor %}

您可以使用这种方法将前端代理服务器指向应用程序服务器组中的所有主机，以在服务器之间设置正确的防火墙规则，等等。您必须在填写模板的任务之前缓存 facts 或收集这些主机的 facts。

使用 group_names，它是当前主机所在的所有组（数组）的列表，您可以创建基于主机组成员资格（或角色）而不同的模板文件

{% if 'webserver' in group_names %}
   # some part of a configuration file that only applies to webservers
{% endif %}

您可以使用魔法变量 inventory_hostname，即您清单中配置的主机名称，作为 ansible_hostname 的替代方案，当禁用 fact 收集时。如果您有一个很长的 FQDN，您可以使用 inventory_hostname_short，它包含第一个句点之前的部分，不包含域名中的其余部分。

其他有用的魔法变量指的是当前的 playbook 或 playbook。这些变量可能有助于使用多个主机名填写模板，或将列表注入到负载均衡器的规则中。

ansible_play_hosts 是当前 playbook 中仍然处于活动状态的所有主机的列表。

ansible_play_batch 是当前 playbook “批次”范围内的主机名列表。

批次大小由 serial 定义，当未设置时，它等效于整个 playbook（使其与 ansible_play_hosts 相同）。

ansible_playbook_python 是用来调用 Ansible 命令行工具的 Python 可执行文件的路径。

inventory_dir 是包含 Ansible 清单主机文件的目录的路径名。

inventory_file 是指向 Ansible 清单主机文件的路径名和文件名。

playbook_dir 包含 playbook 的基目录。

role_path 包含当前角色的路径名，只在角色内部有效。

ansible_check_mode 是一个布尔值，如果您使用 --check 运行 Ansible，则设置为 True。

Ansible 版本 

版本 1.8 中新增。

要使 playbook 行为适应不同版本的 Ansible，您可以使用变量 ansible_version，它具有以下结构

{
    "ansible_version": {
        "full": "2.10.1",
        "major": 2,
        "minor": 10,
        "revision": 1,
        "string": "2.10.1"
    }
}

发现变量：事实和魔法变量

Ansible 事实 

事实收集的包要求 

缓存事实 

禁用事实 

添加自定义事实 

facts.d 或本地事实 

关于 Ansible：魔法变量 

Ansible 版本 