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

检查 Inventory 解析结果

检查 Inventory 解析结果

Inventory 文件只是输入,真正影响执行的是 Ansible 解析后的主机、组和变量视图。本课用 ansible-inventory 先确认主机归属,再检查变量合并结果,最后建立一套在运行 Playbook 前就能发现 Inventory 错误的验证顺序。

学习目标

  • 使用 --graph 检查主机与组的实际归属关系
  • 使用 --host 查看某台主机合并后的最终变量
  • 根据解析结果定位分组、变量覆盖和 Inventory 源错误

用解析结果作为判断依据

不要只盯着 inventory.yml、group_vars/ 或动态 Inventory 的源数据。Ansible 会先加载 Inventory 源,再建立组关系并把可用变量汇总到具体主机;因此排查时应以解析后的结果为准。

ansible-inventory --graph 适合确认“主机到底属于哪些组”,--host <HOST> 适合确认“这台主机最终拿到了什么变量”,--list 则用于查看完整 Inventory 视图。验证时先看结构,再看单主机变量,通常比直接运行 Playbook 更容易定位问题。

准备一个可验证的 Inventory

下面的 inventory.yml 同时包含父子组变量和主机变量,便于观察变量如何落到最终主机视图。

yaml
all:
  vars:
    ansible_user: automation
    env: default
  children:
    prod:
      vars:
        env: prod
        ntp_server: ntp-prod.example.com
      children:
        web:
          vars:
            app_port: 8080
            ntp_server: ntp-web.example.com
          hosts:
            web01:
              ansible_host: 10.20.0.11
              app_port: 9090
            web02:
              ansible_host: 10.20.0.12

这段配置本身不产生终端输出。按定义,web01 应属于 all、prod 和 web,并得到 env=prod、ntp_server=ntp-web.example.com,而主机自己的 app_port=9090 应覆盖组里的 8080。

先核对主机归属

先生成组关系图,确认 YAML 缩进或 children 关系没有把主机放错位置。

bash
ansible-inventory -i inventory.yml --graph

预期输出

text
@all:
  |--@ungrouped:
  |--@prod:
  |  |--@web:
  |  |  |--web01
  |  |  |--web02

如果预期中的组或主机没有出现,先修正 Inventory 结构,不要继续执行 Playbook。动态 Inventory 也是同样原则:先确认插件实际返回并被 Ansible 接受的组关系。

再核对变量合并后的主机视图

结构正确后,只看目标主机。--host 展示的是 Ansible 为该主机整理出的变量,因此很适合检查“为什么连接用户、端口或业务变量不是我以为的值”。

bash
ansible-inventory -i inventory.yml --host web01 --yaml

预期输出(键顺序可能不同)

yaml
ansible_host: 10.20.0.11
ansible_user: automation
app_port: 9090
env: prod
ntp_server: ntp-web.example.com

这里能直接看到覆盖结果:prod 把 all 的 env 改为 prod,子组 web 覆盖父组的 ntp_server,而 web01 的主机变量又覆盖 web 的 app_port。如果实际结果不同,就应继续检查是否还有其他 Inventory 源、group_vars/、host_vars/ 或同名变量参与合并。

把检查顺序固化下来

运行自动化前,先用 --graph 验证目标集合,再用 --host 抽查关键主机;需要全局审计时再使用 --list --yaml。若解析结果与源文件明显不一致,可增加 -vvvv 查看 Inventory 插件加载与解析线索。

尤其不要通过“Playbook 最终有没有成功”反推 Inventory 是否正确。连接到了错误主机、继承了错误变量时,任务仍可能成功执行;以 ansible-inventory 的最终视图作为上线前检查项,才能在真正变更主机之前发现这类配置偏差。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查 Inventory 解析结果

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

登录哪都通