0%

Ansible系列 : Inventory文件

Ansible通过inventory文件来配置主机清单,默认文件路径为/etc/ansible/hosts,也可以在自己的管理目录下创建inventory文件。

Inventory参数

参数 说明
ansible_ssh_host 远程的主机名
ansible_ssh_port 远程的端口
ansible_ssh_user SSH远程的用户
ansible_ssh_pass ssh密码
ansible_sudo_pass 建议使用–ask-sudo-pass选项
ansible_sudo_exe sudo路径
ansible_connection 连接方式,如local,ssh或paramiko
ansible_ssh_private_key_file ssh的私钥文件
ansible_shell_type 目标系统的shell类型,默认为sh
ansible_python_interpreter 目标主机的python路径

主机与组

inventory文件的基本格式如下:

1
2
3
4
5
6
7
8
9
10
10.0.139.163

[appserver]
10.0.139.161
10.0.139.162
10.255.210.15

[dbserver]
10.255.210.10
10.255.210.15

appserver和dbserver是自定义的组,一个主机可以属于多个不同的组,例如10.255.210.15属于appserver同时也可以属于dbserver,我们可以通过组来管理组下面的所有主机。

当主机列表存在一些静态IP地址,希望设置对应的主机别名,而不是配置/etc/hosts,可以通过下列方式定义

1
app1 ansible_ssh_port=30 ansible_ssh_host=10.0.139.163

主机格式还支持模糊匹配,例如我们可以用下列格式表示app1到app20这20台主机。

1
app[1:20].example.com

组与组之间还能进行嵌套

1
2
3
4
5
6
7
8
9
10
[k8s]
10.255.210.9

[db]
10.255.210.10
10.255.210.15

[server:children]
k8s
db

查看server包含的主机

1
2
3
4
5
[root@h-luhx-254 ~]# ansible server --list-host -i /data/ansible/Inventory/hosts 
hosts (3):
10.255.210.9
10.255.210.10
10.255.210.15

变量配置

对于主机或组,可以定义一系列变量,提供给playbook调用。例如http端口,文件路径等等

主机和组都可以设定变量

1
2
3
4
5
6
7
8
9
10
11
12
13
14
[k8s]
10.255.210.9 docker_path=/data/docker

[db]
10.255.210.10
10.255.210.15

[db:vars]
db_port=3306
version=8.0.23

[server:children]
k8s
db

编写一个简单的playbook作业

1
2
3
4
5
6
[root@h-luhx-254 playbook]# cat /data/ansible//playbook/test.yaml 
- hosts: db
gather_facts: False
tasks:
- name: display variable from inventory file
debug: msg="The {{ inventory_hostname }} Value is {{ db_port }}"

查看变量值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
[root@h-luhx-254 playbook]# ansible-playbook test.yaml -i /data/ansible/Inventory -k
SSH password:

PLAY [db] *************************************************************************************************************************************************************************

TASK [display variable from inventory file] ***************************************************************************************************************************************
ok: [10.255.210.10] => {
"msg": "The 10.255.210.10 Value is 3306"
}
ok: [10.255.210.15] => {
"msg": "The 10.255.210.15 Value is 3306"
}

PLAY RECAP ************************************************************************************************************************************************************************
10.255.210.10 : ok=1 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
10.255.210.15 : ok=1 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0

变量还可以保存在单独的文件中,格式为YAML,如下列文件

1
2
3
4
5
[root@h-luhx-254 Inventory]# mkdir /data/ansible/Inventory/{group_vars,host_vars}
[root@h-luhx-254 Inventory]# cat /data/ansible/Inventory/group_vars/db
---
db_port: 3306
db_version: 8.0.23

动态Inventory

除了前面基于文本的方式来记录intentory配置信息,Ansible也支持在其它软件系统中保存配置信息。例如EC2、Cobbler、Zabbix等外部系统。

存放主机信息的程序可以使用任何语言开发,其运行结果必须返回Json格式,同时需要支持--list和--host两个选项,--list用于返回所有的主机组信息,每个组包含的host,children、vars,_meta用于存放主机变量;–host则用于指定具体的host。大致格式如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"docker": {
"hosts": [
"10.255.210.9"
]
},
"mysql": {
"hosts": [
"10.255.210.10",
"10.255.210.15"
],
"vars": {
"mysql_port": 22,
"mysql_version": "8.0.23"
}
}
}

在设计外部系统配置信息时,可以将Inventory配置信息记录在MySQL数据库中,再通过Python脚本获取数据并返回上述格式的JSON结果。