基础设施即代码 / 系统课时
检查 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 同时包含父子组变量和主机变量,便于观察变量如何落到最终主机视图。
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 关系没有把主机放错位置。
ansible-inventory -i inventory.yml --graph预期输出
@all:
|--@ungrouped:
|--@prod:
| |--@web:
| | |--web01
| | |--web02如果预期中的组或主机没有出现,先修正 Inventory 结构,不要继续执行 Playbook。动态 Inventory 也是同样原则:先确认插件实际返回并被 Ansible 接受的组关系。
再核对变量合并后的主机视图
结构正确后,只看目标主机。--host 展示的是 Ansible 为该主机整理出的变量,因此很适合检查“为什么连接用户、端口或业务变量不是我以为的值”。
ansible-inventory -i inventory.yml --host web01 --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 的最终视图作为上线前检查项,才能在真正变更主机之前发现这类配置偏差。