Files
kenaito-lab/image/tools-ansible/ansible/ansible.cfg
T
odboy 208e1ed1a7 feat: ansible 镜像内置自定义 ansible.cfg 与 hosts 清单
- Dockerfile 增加 COPY ansible/ansible.cfg、ansible/hosts 到 /etc/ansible/
- ansible/ansible.cfg 改为裁剪后的实用配置:整份默认配置已移到
  ansible.default/ 作参考,镜像内只保留日常运维会调的项
- 修正 ini 不支持行尾注释导致的 DEFAULT_TIMEOUT 解析报错,
  注释统一移到配置项上一行
- 保留 gather_subset 以加速事实收集,并关闭 deprecation_warnings
  静默其 2.16 弃用告警
2026-05-16 21:37:47 +08:00

97 lines
4.2 KiB
INI
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Ansible 常用配置(ansible-core 2.16,镜像 kenaito:ansible 内使用)
#
# 优先级:命令行参数 > 环境变量(ANSIBLE_xxx) > 本文件 > Ansible 内置默认值。
# 本文件只保留日常运维真正会调的项,其余默认值足够用;
# 完整选项清单与说明见 ansible.default/ansible.zh.cfg(英文原版为 ansible.default/ansible.cfg)。
#
# 格式说明:ini 风格,[段名] 开头,key=value;行首 # 或 ; 为注释。
# 改了这里记得确认生效位置:ansible --version 输出的 config file 一栏。
[defaults]
# ---------------------------------------------------------------------------
# 基本行为
# ---------------------------------------------------------------------------
# 并发主机数。默认 5 偏保守;批量执行可提高到 20~50,视目标网络与 CPU 而定
forks = 20
# 默认清单。镜像里 hosts 与本文件同目录;也可以用 -i 指定,或改用 group_vars/host_vars
#inventory = /etc/ansible/hosts
# 默认策略:linear 按任务逐批推进;free 让每台主机尽快跑完自己的任务
strategy = linear
# 只收集常用事实(网络、硬件、虚拟化等),可明显加快执行;
# 需要完整事实时在 playbook 里单独写 gather_facts,或把 gather_subset 改回 all
# 注意:gather_subset 在 ansible-core 2.18 起被移除,2.16 运行时会报 DEPRECATION WARNING;
# 因镜像锁定 2.16.3 而保留,告警已在下方 deprecation_warnings 统一关闭
gather_subset = !min,network,hardware,virtual
# 事实收集策略:implicit 每次隐式收集;smart 有缓存时优先用缓存;explicit 不自动收集
gathering = smart
# 配合 gathering=smart 使用内存缓存(进程级,跨次运行不持久;要持久可换 jsonfile/redis)
fact_caching = memory
# 被控节点执行模块用的 Python 解释器。auto 会自动探测常见路径(系统自带 3.8+ 优先);
# 目标机是编译版 Python 等非标准路径时,改成绝对路径;auto_silent 与 auto 相同但不打告警
interpreter_python = auto_silent
# 失败时生成 .retry 文件,方便 ansible-playbook site.yml --limit @site.retry 只重跑失败主机
retry_files_enabled = True
retry_files_save_path = ~/.ansible/retry
# 日志。默认不落盘;排查问题时打开,注意日志同样包含敏感信息
#log_path = /var/log/ansible/ansible.log
# 输出与交互
# 注意:Ansible 的配置文件不识别行尾注释,# 只能写在行首独占一行,否则注释会被当成值的一部分
# 想要更紧凑的 stdout,把 stdout_callback 换成 yaml
stdout_callback = default
# 隐藏 skipped 任务,输出更干净
display_skipped_hosts = False
# 关闭弃用告警:gather_subset 在 2.16 已被标记弃用,每次运行都会刷一条告警
# 代价是其它弃用信息也一并静默,排查时可临时改回 True
deprecation_warnings = False
# 清单为空时的告警,容器里跑 adhoc 命令常遇到
localhost_warning = False
# True 时任一主机失败即终止整个 play
any_errors_fatal = False
# 超时与性能
# 连接插件默认超时(秒),慢网络可调大
timeout = 30
# 开启 pipelining 减少 SSH 往返、显著提速;
# 注意:become 场景下要求被控机 sudoers 不能有 requiretty,否则会报错
pipelining = True
# 主机密钥校验。内网首次连接可关掉,避免卡在 fingerprint 确认;
# 公网环境建议保持默认 True 并预先分发 known_hosts
host_key_checking = False
[privilege_escalation]
# 提权(become)全局默认值。通常按需在命令行用 -b / -K 或在 playbook 里设置;
# 这里给出常见的内网 sudo 配置
become = False
become_method = sudo
become_user = root
#become_ask_pass = False
[ssh_connection]
# SSH 连接层配置
# 连接复用:同一主机的多次任务只建一次 SSH 连接,批量执行时提速明显
ssh_args = -o ControlMaster=auto -o ControlPersist=60s
# 连接复用套接字目录;路径带主机/端口/用户哈希,避免多用户互相覆盖
control_path_dir = /tmp/.ansible-cp
control_path = %(directory)s/%%h-%%p-%%r
[colors]
# 终端颜色,按习惯调整即可
ok = green
changed = yellow
skip = cyan
unreachable = bright red
verbose = blue
warn = bright purple