Ansible 是一款强大的 IT 自动化工具，可简化基础设施管理与部署。Ansible 的关键任务之一是「收集信息（Gathering Facts）」，即收集有关目标主机的信息。然而，此任务有时会遇到问题，导致 Ansible 剧本出现故障。本教程将指导你排查 Ansible 中「收集信息」任务的故障，帮助你识别并解决常见问题，以及根据特定需求定制信息收集过程。
Ansible 是一款强大的自动化工具，它允许你以声明式的方式管理和配置基础设施。Ansible 的关键特性之一是它能够收集有关受管主机的信息，这些信息本质上是关于系统的信息，例如操作系统、网络接口、已安装的软件包等等。
Ansible 信息是 Ansible 工作流程的重要组成部分，因为它们提供了有价值的信息，可用于你的剧本中进行决策和采取行动。
Ansible 信息是在你运行 Ansible 剧本时由 setup 模块自动收集的一组变量。这些信息存储在 ansible_facts 字典中，你可以在剧本中访问和使用它。
以下是一个如何访问一些 Ansible 信息的示例：
- hosts: all
tasks:
- name: Print Ansible facts
debug:
var: ansible_facts这将打印出 Ansible 为受管主机收集的所有信息。
Ansible 信息之所以重要，有以下几个原因：
条件执行：你可以使用 Ansible 信息根据受管主机的状态有条件地执行任务。例如，你可以仅在运行特定操作系统的主机上安装特定的软件包。
动态清单：Ansible 信息可用于动态生成受管主机的清单，从而更轻松地管理大型和复杂的基础设施。
故障排除：Ansible 信息可为排查受管主机上的问题提供有价值的信息，例如网络连接、磁盘空间等等。
定制：你可以通过编写自定义信息模块来扩展 Ansible 信息集，从而允许你收集有关基础设施的其他信息。
通过理解并有效地使用 Ansible 信息，你可以创建更健壮、更灵活的 Ansible 剧本，以适应基础设施不断变化的需求。
虽然 Ansible 的信息收集通常是一个顺利的过程，但你偶尔可能会遇到阻止成功收集信息的问题。以下是一些常见问题及其解决方案：
如果 Ansible 无法连接到受管主机，它将无法收集信息。请确保你拥有正确的 SSH 凭证，并且受管主机可从控制节点访问。
你可以通过运行以下命令来测试连接：
ansible all -m ping如果 ping 模块失败，你需要在继续收集信息之前排查连接问题。
Ansible 需要提升权限才能收集某些信息，例如与系统软件包、服务和配置相关的信息。如果你正在使用的用户账户没有必要的权限，可能会遇到权限提升错误。
要解决此问题，你可以：
become 或 become_user 选项来提升用户账户的权限。Ansible 信息收集的默认超时时间为 10 秒。如果受管主机的响应时间超过 10 秒，Ansible 将认为信息收集失败。
你可以通过在剧本或 Ansible 配置文件中设置 gathering_timeout 选项来增加超时时间：
- hosts: all
gather_facts:
gather_timeout: 30在某些情况下，Ansible 在收集信息时可能会遇到错误，例如缺少依赖项或不支持的平台。你可以通过以下方式排查这些问题：
setup 模块的要求。通过理解并解决这些常见问题，你可以确保 Ansible 能够成功收集必要的信息，为你的自动化工作流程提供支持。
虽然 Ansible 的内置信息收集功能很强大，但有时你可能需要收集额外的信息或定制信息收集过程。LabEx 提供了几种方法来扩展和定制 Ansible 的信息收集功能。
Ansible 允许你编写自己的信息模块，以收集有关受管主机的额外信息。这些自定义信息模块可以用 Ansible 支持的任何语言编写，如 Python、Bash 或 PowerShell。
以下是一个用 Python 编写的自定义信息模块示例，用于收集 Ubuntu 22.04 系统上已安装软件包的信息：
#!/usr/bin/env python
from ansible.module_utils.basic import AnsibleModule
def main():
module = AnsibleModule(
argument_spec=dict(),
supports_check_mode=True
)
packages = []
with open('/var/lib/dpkg/status', 'r') as f:
for line in f:
if line.startswith('Package:'):
packages.append(line.split(':')[1].strip())
module.exit_json(changed=False, ansible_facts={'installed_packages': packages})
if __name__ == '__main__':
main()要使用此自定义信息模块，你可以将其包含在 Ansible 剧本中：
- hosts: all
gather_facts: false
tasks:
- name: Gather custom facts
ansible.builtin.setup:
gather_subset:
- custom
register: custom_facts
- name: Print custom facts
debug:
var: custom_facts.ansible_facts.installed_packages这将收集已安装软件包的列表，并将其作为 Ansible 信息提供。
Ansible 支持信息缓存，通过减少收集信息所需的时间，可以提高剧本的性能。你可以通过在 Ansible 配置文件或剧本中配置 fact_caching 选项来启用信息缓存。
以下是使用 memory 信息缓存插件启用信息缓存的示例：
- hosts: all
gather_facts: true
strategy: free
vars:
ansible_facts_cache_plugin: memory
ansible_facts_cache_timeout: 86400 ## 1 天这将在内存中缓存收集到的信息 24 小时，减少后续运行时收集信息所需的时间。
通过利用自定义信息模块和信息缓存，你可以扩展 Ansible 的信息收集功能，以更好地满足你的特定需求，并提高自动化工作流程的性能。
在本 Ansible 教程中，你将学习如何排查「收集信息」任务的故障，这是 Ansible 工作流程中的关键步骤。你将探讨常见问题，发现定制信息收集的技巧，并优化你的 Ansible 部署以提高效率和可靠性。在本指南结束时，你将具备在 Ansible 项目中有效管理和排查「收集信息」任务故障的知识和技能。
