基础设施即代码 / 系统课时
配置主机与组变量
配置主机与组变量
同一套 Playbook 往往需要连接不同端口、使用不同账户,并根据环境提供不同参数。本篇把公共值放入组变量,把节点差异放入主机变量,并通过 Inventory 工具检查最终合并结果。
学习目标
- 区分主机变量、组变量和连接变量的职责
- 使用
group_vars与host_vars组织 Inventory 范围配置 - 使用
ansible-inventory验证某台主机最终获得的变量
先划分变量的作用范围
主机连接信息可以直接作为 Inventory 变量提供。常见连接变量包括 ansible_host、ansible_user 和 ansible_port;应用端口、环境名称等业务参数则使用自定义变量名。
如果多个主机共享同一个值,不应在每台主机上重复配置。通常把全局公共值放在 group_vars/all.yml,把某一组共有值放在对应组文件中,只把真正的单机差异放入 host_vars/<hostname>.yml。
建立 Inventory 与变量目录
假设项目采用下面的文件布局:
inventory/
├── hosts.yml
├── group_vars/
│ ├── all.yml
│ └── web.yml
└── host_vars/
└── web01.ymlhosts.yml 只负责描述主机和组关系,并为 web01 指定实际连接地址。
all:
children:
web:
hosts:
web01:
ansible_host: <IP>group_vars/all.yml 保存所有主机共享的连接用户和默认端口。
ansible_user: ops
ansible_port: 22
environment_name: commongroup_vars/web.yml 保存 Web 组自己的应用配置。
http_port: 8080最后用 host_vars/web01.yml 表达单机例外,例如该主机的 SSH 服务监听在其他端口,并把环境名称覆盖为生产环境。
ansible_port: 2222
environment_name: production把 <IP> 替换为目标主机的实际地址后,Ansible 连接 web01 时会使用用户 ops 和端口 2222;http_port 则来自 web 组变量。
理解 Inventory 范围的覆盖关系
在这里的 Inventory 变量范围内,all 组提供公共默认值,具体组进一步补充或覆盖组级配置,主机变量用于处理单台主机差异。因此 web01 最终不会使用 all.yml 中的端口 22,而会取得 host_vars/web01.yml 中的 2222。
需要注意,Ansible 还有 Play、任务参数、命令行 --extra-vars 等其他变量来源,完整变量优先级不只由 group_vars 和 host_vars 决定。本篇只讨论 Inventory 内部的组织方式。
检查变量合并结果
不要通过逐个打开 YAML 文件来猜某台主机最后得到什么值。ansible-inventory --host 会读取 Inventory,并输出指定主机合并后的变量。
ansible-inventory -i inventory/hosts.yml --host web01预期输出类似:
{
"ansible_host": "<IP>",
"ansible_port": 2222,
"ansible_user": "ops",
"environment_name": "production",
"http_port": 8080
}实际 JSON 字段顺序可能不同,但关键结果应一致:ansible_port 为 2222,environment_name 为 production,同时仍继承 ansible_user 与 http_port。
验证组级视角
当变量文件增多时,还可以先查看完整 Inventory 展开结果,确认主机是否进入预期组,以及变量是否挂在正确范围。
ansible-inventory -i inventory/hosts.yml --graph预期输出的核心结构类似:
@all:
|--@ungrouped:
|--@web:
| |--web01输出的缩进和附加内容可能因 Ansible 版本不同而略有差异,但 web01 应出现在 web 组下。
把公共配置放到最合适的组级范围,再用主机变量表达少量例外,可以避免 Inventory 逐渐演变成大量重复配置。修改连接参数或环境差异后,先用 ansible-inventory 检查合并结果,再执行真正的远程任务。