ansible.cfg 配置文件的常见配置项及其说明

配置项 说明 默认值
defaults 默认配置部分
inventory 指定清单文件的位置,可以是文件路径、目录或动态清单脚本。 /etc/ansible/hosts
remote_user 默认的远程用户 root
host_key_checking 是否启用主机密钥检查。设置为 False 跳过 SSH 主机密钥验证。 True
ask_pass 是否在执行时提示输入 SSH 密码 False
ask_become_pass 是否在执行时提示输入 sudo 密码 False
become 是否启用权限提升(例如使用 sudo)。 False
become_method 权限提升方法(如 sudosu)。 sudo
become_user 权限提升后的目标用户 root
gathering 是否启用事实收集功能(收集主机信息)。 smart(智能收集,根据主机是否需要事实收集来决定)
ansible_managed 管理文件的注释信息 Ansible managed
timeout 网络连接超时时间(秒)。 10
stdout_callback 控制输出格式,常用的有 defaultjson default
deprecation_warnings 是否显示废弃功能的警告 True
log_path 日志输出文件路径,如果为空则不保存日志 None
ssh_connection SSH 连接配置部分
ssh_args 配置 SSH 连接时使用的参数 -o ControlMaster=auto -o ControlPersist=60s
scp_if_ssh 是否使用 SCP 协议进行文件传输 True
control_path 控制连接的路径,控制多次连接复用 ~/.ansible/cp/ansible-ssh-%%h-%%p-%%r
pipelining 是否启用管道化传输,减少 SSH 执行时间 False
privilege_escalation 权限提升配置部分
become_exe 提升权限时使用的命令 sudo
inventory 清单相关配置部分
enable_plugins 启用的清单插件 host_list, script, yaml
accelerate 是否启用加速功能,提升执行效率 False
roles_path 角色路径,指定存放 Ansible 角色的目录 ./roles
library 自定义模块库路径,指定存放自定义模块的路径 /usr/share/ansible/plugins/modules
filter_plugins 自定义过滤器插件路径 /usr/share/ansible/plugins/filter
callback_enabled 启用的回调插件 profile_tasks
command_warnings 是否显示命令执行时的警告信息 True