Ansible 如何禁用 gather_facts 提升简单任务执行速度？

在大规模批量执行简单命令或文件分发场景下，禁用事实收集是降低 Ansible 执行耗时的关键手段。对于不需要获取主机系统信息的任务，直接在 Playbook 中设置 gather_facts: no 可显著减少连接开销和解析时间。

核心结论：禁用事实收集能跳过 setup 模块执行，但需确保任务不依赖 ansible_ 开头的变量。

核心配置方法

推荐在 Playbook 的 Play 层级单独控制，避免全局配置影响其他依赖事实的任务。

---
- hosts: all
  gather_facts: no
  tasks:
    - name: Run simple command
      command: echo "hello"

若确认所有任务均无需事实信息，可在 ansible.cfg 中全局关闭：

[defaults]
gathering = False

禁用事实收集主要节省了 setup 模块的执行时间及 JSON 数据解析开销。在主机数量较多时，累积效果明显。

1. 使用 profile-tasks 分析耗时

通过 `--profile-tasks` 参数可以查看每个任务的耗时分布，直观对比禁用前后的差异：

ansible-playbook -i inventory site.yml `--profile-tasks`

开启事实收集时，输出顶部通常会显示 setup 模块耗时；禁用后该条目消失，总耗时相应减少。

2. 使用 time 命令对比

在 Shell 层面使用 time 命令包裹执行，记录整体墙钟时间：

time ansible-playbook -i inventory site.yml

建议在同一网络环境下多次执行取平均值，以排除网络波动干扰。

1. 验证是否生效

使用 -v 或 -vv 参数运行 Playbook，观察输出日志。如果禁用成功，日志中不会出现 Gathering Facts 相关的任务步骤。

ansible-playbook -i inventory site.yml -v

2. 隐式依赖风险

某些第三方 Role 可能隐式调用了事实变量，禁用后会导致任务失败报错 undefined variable。建议在禁用前搜索代码库：

grep -r "ansible_" roles/ playbooks/

3. 条件判断失效

如果 when 条件中使用了事实变量（如 when: ansible_os_family == "RedHat"），禁用后条件无法评估，可能导致任务意外跳过或报错。此时需显式传递变量或仅在特定 Play 中禁用。

4. 动态 Inventory 脚本

部分动态 Inventory 脚本依赖事实收集来补充主机信息，禁用后可能影响主机分组逻辑，需检查 Inventory 插件文档。