使用 ansible-inventory 查看清单结构,核心命令是 ansible-inventory --list。该工具会解析当前工作目录或指定路径下的所有清单文件(如 hosts、.yml),将动态插件和静态配置合并后,以 json 格式输出完整的层级结构。通过管道配合 jq 可以格式化输出,便于阅读变量、主机分组及嵌套关系。

如何查看特定主机的详细变量
要查看特定主机的详细变量,使用 ansible-inventory --host 。这会返回仅包含该主机及其所属组变量的 JSON 对象,帮助排查变量覆盖问题。

{
"_meta": {
"hostvars": {
"web01": {
"ansible_host": "192.168.1.10",
"http_port": 80
}
}
},
"all": {
"children": [
"webservers"
]
},
"webservers": {
"hosts": [
"web01"
],
"vars": {
"env": "prod"
}
}
}
如何验证清单文件的语法正确性
在修改清单文件后,使用 ansible-inventory --graph 可以快速生成文本树状图,直观检查分组层级是否正确,同时也能发现 YAML 语法错误导致的解析失败。

@all:
|--@webservers:
| |--web01
|--@dbservers:
|--db01
当清单中存在重复主机名时如何处理
如果多个清单文件或同一文件中定义了相同名称的主机,ansible-inventory 会合并它们的变量。后加载的清单或更具体的组定义会覆盖之前的值。最终输出的 JSON 中,每个主机只出现一次,其变量是所有来源的并集,且高优先级变量保留。若需调试此类冲突,应结合 --host 选项逐个检查主机变量,确认最终生效的配置。










