基础设施即代码 / 系统课时

使用 Fact Cache 降低采集开销

使用 Fact Cache 降低采集开销

在成百上千台主机上反复执行短 Playbook 时,默认 Facts 采集可能比真正的任务更耗时。本课用持久化 Fact Cache 配合 smart 采集策略,让有效缓存直接复用,并把 TTL、手工清理和变更场景定义成清晰的刷新边界。

学习目标

  • 理解 Facts 重复采集为何会放大 SSH、模块启动和主机端执行开销。
  • 配置 jsonfile Fact Cache,并验证首次采集与后续缓存命中的差异。
  • 使用 TTL 与强制清理控制缓存新鲜度,避免把过期系统信息带入任务判断。

看清重复采集的成本

gather_facts: true 会在普通任务前调用 Facts 采集逻辑,获取操作系统、网络接口、内存、挂载点等信息。单台主机的开销通常不大,但主机数量和 Playbook 调用频率同时上升后,连接建立、Python 模块执行和结果回传会被重复支付。

Fact Cache 的作用不是“永远不采集”,而是把已经获得的 ansible_facts 持久化。配合 gathering = smart 时,Ansible 在缓存仍有效时直接复用;缓存过期、被清理或不存在时,再回到受管主机采集。

Fact Cache 的采集、命中与刷新数据流

配置持久化缓存

实验目录使用内置 jsonfile 缓存插件,便于直接观察缓存文件。下面三个文件是一个可运行的最小环境;node1 使用本机连接,只是为了复现实验,换成 SSH Inventory 后机制不变。

ansible.cfg:

ini
[defaults]
inventory = ./inventory.ini
gathering = smart
fact_caching = jsonfile
fact_caching_connection = ./.ansible/facts
fact_caching_timeout = 3600

inventory.ini:

ini
[lab]
node1 ansible_connection=local

site.yml:

yaml
---
- name: Read cached facts
  hosts: lab
  gather_facts: true
  tasks:
    - name: Show distribution
      ansible.builtin.debug:
        msg: "{{ inventory_hostname }} -> {{ ansible_distribution }} {{ ansible_distribution_version }}"

fact_caching_timeout = 3600 表示缓存有效期为 3600 秒。缓存目录必须对运行 ansible-playbook 的用户可写;生产环境还应限制目录权限,因为 Facts 可能包含主机名、地址、挂载点等基础设施信息。

验证缓存命中

先创建缓存目录并执行第一次 Playbook:

bash
mkdir -p .ansible/facts
ansible-playbook site.yml

预期输出会包含一次 Facts 采集;发行版实际值可能不同:

text
PLAY [Read cached facts] *******************************************************

TASK [Gathering Facts] ********************************************************
ok: [node1]

TASK [Show distribution] ******************************************************
ok: [node1] => {
    "msg": "node1 -> <VALUE> <VALUE>"
}

PLAY RECAP ********************************************************************
node1 : ok=2 changed=0 unreachable=0 failed=0

在 TTL 内再次执行相同 Playbook:

bash
ansible-playbook site.yml

预期输出中不再出现 TASK [Gathering Facts],调试任务直接使用缓存中的 Facts:

text
PLAY [Read cached facts] *******************************************************

TASK [Show distribution] ******************************************************
ok: [node1] => {
    "msg": "node1 -> <VALUE> <VALUE>"
}

PLAY RECAP ********************************************************************
node1 : ok=1 changed=0 unreachable=0 failed=0

这里的关键指标不是“缓存文件存在”,而是第二次执行确实跳过了采集阶段。若仍看到 Gathering Facts,优先检查当前 ansible.cfg 是否生效、缓存目录是否可写,以及缓存是否已超过 TTL。

划定刷新边界

TTL 应按 Facts 的用途决定。只用于发行版、CPU 架构等低频变化信息时,可以设置较长周期;如果任务依赖 IP、挂载点、内存或云实例元数据等可能变化的信息,就应缩短 TTL,或在基础设施变更后主动失效。

需要在下一次运行前清空当前 Inventory 主机的 Facts 缓存时,可使用:

bash
ansible-playbook site.yml --flush-cache

预期结果是重新出现 Facts 采集任务,然后写入新的缓存:

text
TASK [Gathering Facts] ********************************************************
ok: [node1]

不要把 Fact Cache 当成一致性数据库。扩容、网卡变更、挂载调整或镜像升级之后,缓存是否仍可信应由变更流程决定;多控制节点环境还应改用所有控制节点都能访问的共享缓存后端。真正有效的优化,是只缓存允许短暂陈旧的数据,并让“什么时候必须重新采集”成为项目规则。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Fact Cache 降低采集开销

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通