系列文章
Ansible 介绍和架构
Ansible 安装和入门
配置控制机器和受控机器
目录
- 系列文章
- [什么是 Ansible Inventory文件？](#什么是 Ansible Inventory文件？)
- 库存文件的基本结构
- Inventory文件的高级特性
- 参考
什么是 Ansible Inventory文件？
Ansible inventory file是 Ansible 用来了解要操作哪些主机及其相关信息的一个文件。库存文件通常位于 /etc/ansible/hosts，但也可以通过 --inventory-file 或环境变量 ANSIBLE_INVENTORY 指定其他位置。
库存文件的基本结构
库存文件的格式类似于 INI 文件，但具有自己的特性。以下是库存文件中的一些基本元素：
定义主机和组
- 组：使用方括号
[ ]来定义组名。 - 主机：每行一个主机名或 IP 地址或域名，直接写在组定义下方。
示例：
[web_servers]
host1.example.com
host2.example.com
[databases]
db1.example.com
db2.example.com定义主机变量
- 在主机名后面添加空格或制表符，然后列出变量名和值。
示例：
[web_servers]
host1.example.com http_port=80 maxRequestsPerChild=808
host2.example.com http_port=303 maxRequestsPerChild=909定义组变量
- 使用
[组名:vars]来定义组的变量。 - 在 [组名:vars] 下定义的变量适用于该组内的所有主机。
示例：
[atlanta]
host1
host2
[atlanta:vars]
ntp_server=ntp.atlanta.example.com
proxy=proxy.atlanta.example.com定义复合组
- 复合组由其他组构成，使用
[组名:children]来定义子组。 - 子组可以是其他复合组或简单组。
示例：
[southeast:children]
atlanta
raleigh
[southeast:vars]
some_server=foo.southeast.example.com
halon_system_timeout=30
self_destruct_countdown=60
escape_pods=2- [southeast:children] 定义了一个复合组 southeast，它包含了 atlanta 和 raleigh 两个子组
- [southeast:vars] 定义了 southeast 组的变量。这些变量可以被 southeast 组内的所有主机（包括 atlanta 和 raleigh 组中的主机）使用
定义主机连接属性
- 可以为每个主机定义连接属性，如 SSH 端口、用户名等。
示例：
[targets]
localhost ansible_connection=local
other1.example.com ansible_connection=ssh ansible_ssh_user=mpdehaan
other2.example.com ansible_connection=ssh ansible_ssh_user=mdehaan简写模式
- 可以使用简写模式来定义一系列相似的主机名。
示例：
[webservers]
www[01:50].example.com
[databases]
db-[a:f].example.comInventory文件的高级特性
分文件定义变量
-
可以使用单独的 YAML 文件来定义主机或组的变量。
-
文件路径通常为：
/etc/ansible/host_vars/hostname
/etc/ansible/group_vars/groupname -
如果在 playbook 和 inventory 目录下都有 host_vars 和 group_vars 目录，则 playbook 目录下的配置会覆盖 inventory 目录下的配置。
示例：
/etc/ansible/host_vars/foosball
/etc/ansible/group_vars/raleigh/db_settings
/etc/ansible/group_vars/raleigh/cluster_settings动态库存
- 动态库存允许从外部数据源（如云提供商 API）获取库存信息。
- 动态库存脚本必须输出 JSON 或 YAML 数据。
示例：
bash
#!/usr/bin/env python
import json
inventory = {
"_meta": {"hostvars": {}},
"webservers": {"hosts": ["192.168.1.10", "192.168.1.11"], "vars": {"http_port": 80}},
"databases": {"hosts": ["192.168.1.12"]}
}
print(json.dumps(inventory))库存参数
- 库存文件中的参数可以控制 Ansible 与远程主机的交互方式。
例如，定义 SSH 端口、用户名、连接类型等。
示例：
some_host ansible_ssh_port=2222 ansible_ssh_user=manager
aws_host ansible_ssh_private_key_file=/home/example/.ssh/aws.pem
freebsd_host ansible_python_interpreter=/usr/local/bin/python
ruby_module_host ansible_ruby_interpreter=/usr/bin/ruby.1.9.3参考
https://ansible-tran.readthedocs.io/en/latest/docs/intro_inventory.html#host-group