基础设施即代码 / 系统课时
使用动态 Inventory 插件
使用动态 Inventory 插件
静态清单适合固定主机,但云实例会随扩缩容、发布和故障替换不断变化。本课用 AWS EC2 动态 Inventory 插件直接查询实例,并依据标签生成环境与角色分组,最终让 Playbook 始终面向“当前真实主机集”执行。
学习目标
- 理解动态 Inventory 插件从外部系统查询主机并生成变量、分组的过程
- 配置
amazon.aws.aws_ec2,用标签映射环境与角色组 - 使用
ansible-inventory验证发现结果,并识别凭据、命名与缓存方面的常见问题
动态 Inventory 解决什么问题
动态 Inventory 的核心不是“自动写一份 hosts 文件”,而是在 Ansible 解析 Inventory 时调用插件,从云 API、CMDB 或其他外部系统实时取得对象,再把返回字段转换成主机变量和组。Playbook 仍然通过 hosts: 匹配组,不需要知道某台实例何时创建或删除。

这种模式尤其适合实例生命周期短、标签体系稳定的环境。真正需要治理的是“外部元数据如何映射为 Ansible 组”,而不是维护一长串 IP。
配置 EC2 Inventory 插件
先安装插件所在的 collection,并确保控制节点能够通过 IAM Role、环境变量或其他受支持方式访问 AWS API。不要把长期 Access Key 直接写进 Inventory 文件。
ansible-galaxy collection install amazon.aws预期输出会包含 collection 安装成功信息;版本号和安装路径会随环境不同:
amazon.aws:<VERSION> was installed successfully创建 inventory.aws_ec2.yml。aws_ec2 插件要求 Inventory 源文件使用可识别的文件名后缀,下面的配置只发现 us-west-2 中处于运行状态的实例。
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 是否匹配正确目标”分开排查。
ansible-inventory -i inventory.aws_ec2.yml --graph预期输出类似下面的结构;实际主机名、组以及数量取决于当前云账号中的实例标签:
@all:
|--@env_prod:
| |--<HOST>
|--@role_web:
| |--<HOST>如果需要确认某台主机最终得到的连接地址和变量,再执行 ansible-inventory -i inventory.aws_ec2.yml --host <HOST>。只有当主机既在预期组中,又得到正确的 ansible_host,才应进入批量执行阶段。
在 Playbook 中消费动态组
Inventory 的来源变成动态后,Playbook 的写法不需要随之复杂化。可以继续用组名和组交集表达运行环境,例如只选择生产环境中的 Web 主机:
- name: Check production web nodes
hosts: "env_prod:&role_web"
gather_facts: false
tasks:
- name: Verify connectivity
ansible.builtin.ping:运行时仍然把动态 Inventory 文件传给 -i:
ansible-playbook -i inventory.aws_ec2.yml check-web.yml预期输出中,每个被动态选中的主机都会返回 pong;主机名数量取决于当时的云资源:
ok: [<HOST>] => {
"changed": false,
"ping": "pong"
}动态 Inventory 的价值就在这里:Playbook 只声明“我要哪类主机”,实例清单由事实来源决定。规模继续增大时,可以再评估插件缓存以降低 API 调用,但缓存 TTL 必须与主机变更速度匹配,不能为了省查询而接受过期目标集。