ansible配置文件常用参数


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
host_key_checking  
host_key_checking = False  禁用验证host_key_checking
 
inventory  
定义库文件位置，脚本，或者存放可通信主机的目录
inventory  =  / etc / ansible / hosts
 
 
library
ansible默认搜寻模块的位置
library  =  / usr / share / ansible
Ansible知道如何搜寻多个用冒号隔开的路径,同时也会搜索在playbook中的“. / library”.
 
log_path 
日志存放位置
默认不开启，ansible将会吧模块加载纪录在系统日志系统中.不包含用密码.
log_path = / var / log / ansible.log
 
module_name
这个是 / usr / bin / ansible的默认模块名（ - m）. 默认是’command’模块. 之前提到过,command模块不支持shell变量,管道,配额. 所以也许你希望把这个参数改为’shell’:
module_name  =  command
 
nocolor 默认ansible会为输出结果加上颜色,用来更好的区分状态信息和失败信息.如果你想关闭这一功能,可以把’nocolor’设置为‘ 1 ’:
nocolor = 0
 
nocows  默认ansible可以调用一些cowsay的特性,使得 / usr / bin / ansible - playbook运行起来更加愉快.为啥呢,因为我们相信系统应该是一 比较愉快的经历.如果你不喜欢cows,你可以通通过将’nocows’设置为‘ 1 ’来禁用这一选项:
nocows = 0
 
poll_interval
对于Ansible中的异步任务(详见 异步操作和轮询）, 这个是设置定义,当具体的poll interval 没有定义时,多少时间回查一下这些任务的状态, 默认值是一个折中选择 15 秒钟.这个时间是个回查频率和任务完成叫回频率和当任务完成时的回转频率的这种:
poll_interval = 15
 
private_key_file
如果你是用pem密钥文件而不是SSH 客户端或秘密啊认证的话,你可以设置这里的默认值,来避免每一次提醒设置密钥文件位置``–ansible - private - keyfile``:
private_key_file = / path / to / file .pem
 
remote_port
这个设置是你系统默认的远程SSH端口,如果不指定,默认为 22 号端口:（建议修改成别的端口）
remote_port  =  22
 
remote_user
这是个ansible使用 / usr / bin / ansible - playbook连接的默认用户名. 注意如果不指定, / usr / bin / ansible默认使用当前用户名称:
remote_user  =  root
 
timeout
这个事默认SSH链接尝试超市时间:
timeout  =  10
 
transport
如果” - c <transport_name>” 选项没有在使用 / usr / bin / ansible 或者  / usr / bin / ansible - playbook 特指的话,这个参数提供了默认通信机制.默认 值为’smart’, 如果本地系统支持 ControlPersist技术的话,将会使用(基于OpenSSH)‘ssh’,如果不支持讲使用‘paramiko’.其他传输选项包括‘local’, ‘chroot’,’jail’等等.
用户通常可以这个设置为‘smart’,让playbook在需要的条件自己选择‘connectin:’参数.
 
record_host_keys
默认设置会记录并验证通过在用户hostfile中新发现的的主机（如果host key checking 被激活的话）. 这个选项在有很多主机的时候将会性能很差.在 这种情况下,建议使用SSH传输代替. 当设置为 False 时, 性能将会提升,在hostkey checking 被禁用时候,建议使用.:
record_host_keys = True
 
scp_if_ssh
又是用户操控一个一个没有开启SFTP协议的远程系统.如果这个设置为 True ,scp将代替用来为远程主机传输文件:
scp_if_ssh = False     如果没有遇到这样的问题没有必要来修改这个设置.当然修改这个设置也没有什么明显的弊端.大部分的系统环境都默认支持SFTP, 通常情况下不需要修改.
 
pipelining
在不通过实际文件传输的情况下执行ansible模块来使用管道特性,从而减少执行远程模块SSH操作次数.如果开启这个设置,将显著提高性能. 然而当使用”sudo:”操作的时候, 你必须在所有管理的主机的 / etc / sudoers中禁用’requiretty’.
 
默认这个选项为了保证与sudoers requiretty的设置（在很多发行版中时默认的设置）的兼容性是禁用的. 但是为了提高性能强烈建议开启这个设置.详见:doc:playbooks_acceleration:
pipelining = False
 
accelerate_port
New  in  version  1.3 .
在急速模式下使用的端口:
accelerate_port  =  5099
 
accelerate_timeout
 
New  in  version  1.4 .  这个设置时用来控制从客户机获取数据的超时时间.如果在这段时间内没有数据传输,套接字连接会被关闭. 一个保持连接（keepalive）数据包通常每 15 秒回发回给控制台,所以这个超时时间不应该低于 15 秒（默认值为 30 秒）:
accelerate_timeout  =  30
 
accelerate_connect_timeout
New  in  version  1.4 .
这个设置空着套接字调用的超时时间.这个应该设置相对比较短.这个和`accelerate_port`连接在回滚到ssh或者paramiko（受限于你默认的连接设置）连接方式之前会尝试三次开始远程加速daemon守护进程.默认设置为 1.0 秒:
accelerate_connect_timeout  =  1.0
注意,这个选项值可以设置为小于 1 秒钟,但是除非你拥有一个速度很快而且很可靠的网络,否则也许这样并不是一个很好的选择.如果你使用英特网访问你的系统,最好提高这个值.
 
 
accelerate_daemon_timeout
 
New  in  version  1.6 .
This setting controls the timeout  for  the accelerated daemon, as measured  in  minutes. The default daemon timeout  is  30  minutes:: 这个控制加速daemon守护进程的超时时间,用分钟来衡量.默认为 30 分钟:
 
accelerate_daemon_timeout  =  30
注意, 在 1.6 版本之前,daemon发起的超时时间是硬编码的.对于 1.6 以后的版本,超时时间是根据daemon上一次活动信息和这个可设置的选项.
 
accelerate_multi_key
 
New  in  version  1.6 .
If enabled, this setting allows multiple private keys to be uploaded to the daemon.  Any  clients connecting to the daemon must also enable this option:: 如果这个选项开启,这个设置将允许多个私钥被加载到daemon. 任何客户端要想连接daemon都需要开启这个选项:
 
accelerate_multi_key  =  yes
通过本地套接字文件连接的通过SSH上传密钥文件到目标节点的新客户端,必须在登陆daemon时使用原始的登陆密钥登陆.