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

配置主机与组变量

配置主机与组变量

同一套 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 与变量目录

假设项目采用下面的文件布局:

text
inventory/
├── hosts.yml
├── group_vars/
│   ├── all.yml
│   └── web.yml
└── host_vars/
    └── web01.yml

hosts.yml 只负责描述主机和组关系,并为 web01 指定实际连接地址。

yaml
all:
  children:
    web:
      hosts:
        web01:
          ansible_host: <IP>

group_vars/all.yml 保存所有主机共享的连接用户和默认端口。

yaml
ansible_user: ops
ansible_port: 22
environment_name: common

group_vars/web.yml 保存 Web 组自己的应用配置。

yaml
http_port: 8080

最后用 host_vars/web01.yml 表达单机例外,例如该主机的 SSH 服务监听在其他端口,并把环境名称覆盖为生产环境。

yaml
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,并输出指定主机合并后的变量。

bash
ansible-inventory -i inventory/hosts.yml --host web01

预期输出类似:

json
{
    "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 展开结果,确认主机是否进入预期组,以及变量是否挂在正确范围。

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

预期输出的核心结构类似:

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

输出的缩进和附加内容可能因 Ansible 版本不同而略有差异,但 web01 应出现在 web 组下。

把公共配置放到最合适的组级范围,再用主机变量表达少量例外,可以避免 Inventory 逐渐演变成大量重复配置。修改连接参数或环境差异后,先用 ansible-inventory 检查合并结果,再执行真正的远程任务。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置主机与组变量

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

登录哪都通