8.0Ansible配置文件

概览

控制Ansible行为的方式有很多&＃xff0c;基本分为如下4种&＃xff1a;

1. 配置文件
2. 命令行参数
3. playbook关键词
4. 变量

比如主机清单位置&＃xff0c;默认是/etc/ansible/hosts&＃xff0c;也可以通过命令行参数- i更改&＃xff0c;也可以通过修改配置文件更换默认主机清单位置&＃xff1b;playbook里可以控制执行用户&＃xff0c;在主机变量里也可以控制

上面4种配置方法&＃xff0c;优先级从低到高&＃xff0c;简单来说就是后面定义的内容会覆盖前面的&＃xff0c;配置文件的优先级是最低的&＃xff0c;本篇文章重点说一说Ansible常用的一些配置项

配置文件路径

Ansible按照下面的顺序寻找配置文件&＃xff0c;首先找到的被使用&＃xff0c;不再进行后续查找(即被忽略)

1. ANSIBLE_CONFIG 环境变量
2. ansible.cfg 当前路径
3. ~/.ansible.cfg 家目录
4. /etc/ansible/ansible.cfg

如果我们希望测试一份配置文件&＃xff0c;而不想影响其它配置文件&＃xff0c;可以像下面这样

ANSIBLE_CONFIG&＃61;/tmp/ansible.cfg ansible all -m ping
#这种情况变量 ANSIBLE_CONFIG &＃xff0c;仅仅对当前这一行命令生效


配置文件注释

分为两种情况

1 注释书写在开头部分(顶格写或者前面是空格)&＃xff0c;使用 # 或 ;

# cat /etc/ansible/ansible.cfg
# config file for ansible -- https://ansible.com/
# &＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;&＃61;# nearly all parameters can be overridden in ansible-playbook
...


2 注释在中间&＃xff0c;只能使用; (不太常用)

cat /etc/ansible/ansible.cfg
...
inventory &＃61; /etc/ansible/hosts ; This points to the file that lists your hosts
...


配置的基本格式

如果是全新安装&＃xff0c;可以参考cat /etc/ansible/ansible.cfg&＃xff1b;该配置文件的线上地址是https://raw.githubusercontent.com/ansible/ansible/devel/examples/ansible.cfg&＃xff0c;其基本格式如下

# 注释
# 注释
# 下面这个 [defaults] 是分组名称
[defaults]
inventory &＃61; /etc/ansible/hosts
#library &＃61; ~/.ansible/plugins/modules:/usr/share/ansible/plugins/modules[inventory]
# List of enabled inventory plugins and the order in which they are used.
#enable_plugins &＃61; host_list, script, auto, yaml, ini, toml


ansible-config

ansible的配置项有很多&＃xff0c;不同ansible版本配置项略有不同&＃xff0c;绝大多数无需关注&＃xff0c;不用更改。最方便的得知我们当前安装的ansible版本有哪些可用的配置项&＃xff0c;是使用ansible-config命令

• 查看帮助

[root&＃64;192_168_31_106 ~]# ansible-config -h
usage: ansible-config [-h] [--version] [-v] {list,dump,view} ...View ansible configuration.positional arguments:{list,dump,view}list Print all config optionsdump Dump configurationview View configuration fileoptional arguments:--version show program&＃39;s version number, config file location,configured module search path, module location, executablelocation and exit-h, --help show this help message and exit-v, --verbose verbose mode (-vvv for more, -vvvv to enable connectiondebugging)


• 查看全部可用配置项

ansible-config list


比如我们想要更改默认主机清单的位置&＃xff0c;可以搜索inventory关键词&＃xff0c;查看帮助&＃xff0c;示例如下

• 导出当前配置文件(如果需要进行必要的合并)

ansible-config dump[root&＃64;192_168_31_106 ~]# ansible-config dump > /tmp/tmp.txt && fgrep &＃39;/etc/ansible&＃39; /tmp/tmp.txt
DEFAULT_FORKS(/etc/ansible/ansible.cfg) &＃61; 20
DEFAULT_HOST_LIST(default) &＃61; [u&＃39;/etc/ansible/hosts&＃39;]
DEFAULT_ROLES_PATH(default) &＃61; [u&＃39;/root/.ansible/roles&＃39;, u&＃39;/usr/share/ansible/roles&＃39;, u&＃39;/etc/ansible/roles&＃39;]


参考常用配置项

全部配置项可以使用上文ansible-config命令得到&＃xff0c;也可以直接到官方文档里查看(见文章最后的参考资料)&＃xff0c;下面介绍一下常用的配置项

• defaults 分组下常用配置

一个示例

#1 主机清单的位置&＃xff0c;还可以设置成目录&＃xff0c;此时目录里的文件名不关键&＃xff0c;主要是文件里内容中括号的部分&＃xff0c;作为机器分组的名称
inventory &＃61; /etc/ansible/hosts
比如说&＃xff0c;我们可以有下面的目录结构
# tree inventory
├── web
├── golang
├── griddns
├── group_vars
│   ├── admin5_php-fpm_bx.yml
│   ├── admin5_php-fpm_yf3.yml
│   ├── all.yml
│   ├── bt_ctorrent_bx.yml
│   ├── bt_hwraid_bx.yml
│   ├── ceph_bx.yml
│   ├── ceph_dbl.yml
├── host_vars
│   ├── 10.13.32.100.yml
│   ├── 10.13.32.101.yml
│   ├── 10.13.32.102.yml
│   ├── 10.13.32.103.yml
│   ├── 10.13.32.104.yml
│   ├── 10.13.32.110.yml#2 并发执行的数量
forks &＃61; 5#3 目标机器的SSH端口
remote_port &＃61; 26387#4 角色查找路径
roles_path &＃61; /usr/local/myansible/roles#5 SSH连接超时时间
timeout &＃61; 10


参考资料

https://docs.ansible.com/ansible/latest/reference_appendices/config.html
https://docs.ansible.com/ansible/latest/cli/ansible-config.html
https://docs.ansible.com/ansible/latest/reference_appendices/general_precedence.html