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

使用动态 Inventory 插件

使用动态 Inventory 插件

静态清单适合固定主机,但云实例会随扩缩容、发布和故障替换不断变化。本课用 AWS EC2 动态 Inventory 插件直接查询实例,并依据标签生成环境与角色分组,最终让 Playbook 始终面向“当前真实主机集”执行。

学习目标

  • 理解动态 Inventory 插件从外部系统查询主机并生成变量、分组的过程
  • 配置 amazon.aws.aws_ec2,用标签映射环境与角色组
  • 使用 ansible-inventory 验证发现结果,并识别凭据、命名与缓存方面的常见问题

动态 Inventory 解决什么问题

动态 Inventory 的核心不是“自动写一份 hosts 文件”,而是在 Ansible 解析 Inventory 时调用插件,从云 API、CMDB 或其他外部系统实时取得对象,再把返回字段转换成主机变量和组。Playbook 仍然通过 hosts: 匹配组,不需要知道某台实例何时创建或删除。

动态 Inventory 从云 API 到 Playbook 分组的解析链路

这种模式尤其适合实例生命周期短、标签体系稳定的环境。真正需要治理的是“外部元数据如何映射为 Ansible 组”,而不是维护一长串 IP。

配置 EC2 Inventory 插件

先安装插件所在的 collection,并确保控制节点能够通过 IAM Role、环境变量或其他受支持方式访问 AWS API。不要把长期 Access Key 直接写进 Inventory 文件。

bash
ansible-galaxy collection install amazon.aws

预期输出会包含 collection 安装成功信息;版本号和安装路径会随环境不同:

text
amazon.aws:<VERSION> was installed successfully

创建 inventory.aws_ec2.yml。aws_ec2 插件要求 Inventory 源文件使用可识别的文件名后缀,下面的配置只发现 us-west-2 中处于运行状态的实例。

yaml
plugin: amazon.aws.aws_ec2
regions:
  - us-west-2

filters:
  instance-state-name: running

hostnames:
  - tag:Name

compose:
  ansible_host: private_ip_address

keyed_groups:
  - key: tags.Environment
    prefix: env
    separator: _
  - key: tags.Role
    prefix: role
    separator: _

filters 在云端查询阶段缩小候选集合;hostnames 决定 Ansible Inventory 中的主机名;compose 把云字段映射为连接变量;keyed_groups 则把标签值转换成组名。若实例标签 Environment=prod、Role=web,它会进入 env_prod 与 role_web 组。

验证主机与分组

在真正运行 Playbook 前,先查看 Inventory 图。这个步骤能把“插件是否成功查询”和“Playbook 是否匹配正确目标”分开排查。

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

预期输出类似下面的结构;实际主机名、组以及数量取决于当前云账号中的实例标签:

text
@all:
  |--@env_prod:
  |  |--<HOST>
  |--@role_web:
  |  |--<HOST>

如果需要确认某台主机最终得到的连接地址和变量,再执行 ansible-inventory -i inventory.aws_ec2.yml --host <HOST>。只有当主机既在预期组中,又得到正确的 ansible_host,才应进入批量执行阶段。

在 Playbook 中消费动态组

Inventory 的来源变成动态后,Playbook 的写法不需要随之复杂化。可以继续用组名和组交集表达运行环境,例如只选择生产环境中的 Web 主机:

yaml
- name: Check production web nodes
  hosts: "env_prod:&role_web"
  gather_facts: false

  tasks:
    - name: Verify connectivity
      ansible.builtin.ping:

运行时仍然把动态 Inventory 文件传给 -i:

bash
ansible-playbook -i inventory.aws_ec2.yml check-web.yml

预期输出中,每个被动态选中的主机都会返回 pong;主机名数量取决于当时的云资源:

text
ok: [<HOST>] => {
    "changed": false,
    "ping": "pong"
}

动态 Inventory 的价值就在这里:Playbook 只声明“我要哪类主机”,实例清单由事实来源决定。规模继续增大时,可以再评估插件缓存以降低 API 调用,但缓存 TTL 必须与主机变更速度匹配,不能为了省查询而接受过期目标集。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用动态 Inventory 插件

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

登录哪都通