使用 setup 模块探索事实
导出并浏览主机的事实树
使用 setup 模块探索事实 是 CoddyKit 上的免费 Ansible Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Ansible Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Ansible Academy 课程共包含 4 节课。
事实收集器
隐藏的收集事实步骤实际上由一个模块完成：setup 模块。您可以自行调用它进行探索。🌟
运行 setup 临时命令
使用 -m setup 将临时命令指向某台主机，就能将其完整的事实树直接输出到终端。
ansible host1 -m setup它返回 JSON
输出是 ansible_facts 下的一个大型 JSON 对象。每个键都是一个事实，之后可以在剧本中使用。
"ansible_facts": {
"distribution": "Ubuntu"
}信息量很大
完整转储可能包含数百行。为了找到所需内容，您可以筛选事实，而不是滚动浏览全部内容。
按模式筛选
setup 模块接受一个 filter 参数。传入一个通配模式，它就只返回匹配的事实键。
ansible host1 -m setup -a "filter=ansible_distribution*"常用的事实键
有用的键包括 ansible_distribution、ansible_os_family、ansible_memtotal_mb，以及用于网络配置的 ansible_default_ipv4。
嵌套的网络事实
有些事实是嵌套的。主机的主要 IP 位于 ansible_default_ipv4 中，您需要继续访问其中的 address 键。
ansible_default_ipv4:
address: 10.0.0.5剧本中的 setup
您也可以将 setup 列为一个任务，在剧本执行过程中重新收集事实，这在您更改主机上的某些内容后很有用。
- name: Refresh facts
ansible.builtin.setup:限制收集范围
gather_subset 选项可以缩小收集范围，例如只收集网络事实，这样在只需要部分信息时 setup 的运行速度会更快。
- ansible.builtin.setup:
gather_subset:
- network先探索，再构建
先运行 setup 是一个很好的习惯。查看主机上的实际事实名称，然后就能放心地在任务中引用它们。
只读且安全
setup 模块只读取信息，不会更改主机上的任何内容。您可以随时运行它进行调查。
快速检查
如何将单台主机的事实转储到屏幕上？
回顾
您使用 setup 模块转储并筛选事实，在依赖它们构建剧本之前，先了解了实际的键名称。✨
常见问题解答
「使用 setup 模块探索事实」课时是免费的吗？
是的 — 「使用 setup 模块探索事实」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Ansible Academy 课程的其余内容，请升级到 CoddyKit PRO。 Ansible Academy 课程共包含 4 节课。
「使用 setup 模块探索事实」这节课中我会学到什么？
导出并浏览主机的事实树 你通过在浏览器中直接运行的动手代码来练习 Ansible Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Ansible Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Ansible Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「使用 setup 模块探索事实」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Ansible Academy 课中编写并运行代码吗？
能。每节 Ansible Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 什么是事实及其重要性
- 使用 setup 模块探索事实
- 在任务中使用 ansible_facts
- 禁用事实收集以提升速度