如何解决 Ansible 中的“fatal: [localhost]: FAILED!”错误

简介

Ansible 是一个强大的基础设施自动化工具，但有时它可能会遇到难以解决的错误。在本教程中，我们将探讨如何解决 Ansible 中的 “fatal: [localhost]: FAILED!” 错误，指导你完成识别、诊断和解决此问题的过程。

Skills Graph

识别 “fatal: [localhost]: FAILED!” 错误

Ansible 中的 “fatal: [localhost]: FAILED!” 错误是一个常见问题，当 Ansible 无法在本地主机（localhost）上执行任务时就会出现。此错误可能由于各种原因引起，有效识别根本原因对于解决问题至关重要。

理解错误

“fatal: [localhost]: FAILED!” 错误通常表示 Ansible 在本地主机上执行任务时遇到了问题。当 Ansible 无法连接到本地主机，或者任务本身未能成功执行时，就会出现此错误。

确定原因

要确定 “fatal: [localhost]: FAILED!” 错误的原因，可以先检查 Ansible 输出中是否有任何其他信息或错误消息。这些消息可以为潜在问题提供有价值的线索。

$ ansible-playbook my_playbook.yml
fatal: [localhost]: FAILED! => {"changed": false, "msg": "Failed to set permissions on the temporary files Ansible needs to create when becoming an unprivileged user. For information on working around this, see https://docs.ansible.com/ansible/become.html#becoming-an-unprivileged-user."}

在上面的示例中，错误消息表明 Ansible 在成为非特权用户时无法为其需要创建的临时文件设置必要的权限。

故障排除策略

为了有效地排除 “fatal: [localhost]: FAILED!” 错误，可以考虑以下策略：

1. 检查 Ansible 配置：确保你的 Ansible 配置（包括 ansible.cfg 文件）设置正确，并且授予了 Ansible 在本地主机上执行任务所需的权限。

2. 验证 Ansible 版本：确保你使用的是兼容版本的 Ansible。旧版本可能在某些功能或特性上存在问题。

3. 检查 Ansible 日志：查看 Ansible 日志中是否有任何其他信息或错误消息，以帮助你确定问题的根本原因。

4. 测试连接性：通过运行简单的临时命令（如 ansible localhost -m ping）来验证 Ansible 是否可以连接到本地主机。

5. 检查任务权限：如果错误与权限问题相关，请确保运行 Ansible 的用户具有在本地主机上执行任务所需的权限。

通过遵循这些步骤，你可以有效地确定 “fatal: [localhost]: FAILED!” 错误的根本原因，并采取必要的措施来解决问题。

诊断 “fatal: [localhost]: FAILED!” 错误

一旦你识别出了 “fatal: [localhost]: FAILED!” 错误，下一步就是诊断潜在问题。这包括收集更多关于该错误的信息并分析可能的原因。

收集 Ansible 日志

诊断错误的首要步骤之一是检查 Ansible 日志。Ansible 提供了详细的日志信息，可帮助你确定问题的根本原因。你可以通过使用 -vvv 标志运行 Ansible 来启用更详细的日志记录：

$ ansible-playbook my_playbook.yml -vvv

详细输出将提供有关剧本执行的更详细信息，包括可能发生的任何错误或警告。

分析错误消息

错误消息本身可以为潜在问题提供有价值的线索。查找任何有助于你识别问题的特定信息或错误代码。在某些情况下，错误消息甚至可能提供指向 Ansible 文档的直接链接或建议的解决方案。

fatal: [localhost]: FAILED! => {"changed": false, "msg": "Failed to set permissions on the temporary files Ansible needs to create when becoming an unprivileged user. For information on working around this, see https://docs.ansible.com/ansible/become.html#becoming-an-unprivileged-user."}

在上面的示例中，错误消息表明问题与 Ansible 在成为非特权用户时需要创建的临时文件的权限有关。

验证 Ansible 配置

诊断 “fatal: [localhost]: FAILED!” 错误的另一个重要步骤是验证你的 Ansible 配置。确保你的 ansible.cfg 文件设置正确，并且授予了 Ansible 在本地主机上执行任务所需的权限。

你还可以尝试运行一个简单的临时命令来测试 Ansible 与本地主机之间的连接性：

$ ansible localhost -m ping

如果此命令失败，可能表明你的 Ansible 设置或本地主机配置存在更严重的问题。

通过遵循这些步骤，你可以有效地诊断 “fatal: [localhost]: FAILED!” 错误，并收集必要的信息以进入解决问题的下一阶段。

解决 “fatal: [localhost]: FAILED!” 错误

在识别并诊断出 “fatal: [localhost]: FAILED!” 错误之后，下一步就是解决该问题。根据根本原因，你可以采用多种策略来解决此问题。

解决权限问题

如果错误与权限问题相关，你可以尝试以下解决方案：

1. 确保权限正确：验证运行 Ansible 的用户具有在本地主机上执行任务所需的权限。你可以尝试使用 become 或 sudo 选项以提升权限运行 Ansible。

$ ansible-playbook my_playbook.yml --become

2. 配置 Ansible 的权限提升设置：调整 Ansible 配置中的 become 设置，以确保 Ansible 在必要时能够正确提升权限。

[privilege_escalation]
become=True
become_method=sudo
become_user=root

解决连接问题

如果错误与 Ansible 和本地主机之间的连接问题相关，你可以尝试以下解决方案：

1. 验证 Ansible 安装：确保 Ansible 已正确安装且满足必要的依赖项。

2. 检查本地主机配置：验证本地主机配置正确且 Ansible 可访问。这可能包括检查防火墙设置、SSH 配置或其他与网络相关的设置。

3. 使用本地连接插件：如果问题仍然存在，你可以尝试使用 local 连接插件直接在本地主机上执行任务，绕过任何潜在的连接问题。

- hosts: localhost
  connection: local
  tasks:
    - name: Run a local command
      command: echo "Hello, LabEx!"

针对特定错误进行故障排除

根据你遇到的特定错误消息或问题，可能还有其他故障排除步骤可供采取。参考 Ansible 文档或社区资源，以获取有关解决更复杂或特定的 “fatal: [localhost]: FAILED!” 错误的指导。

通过遵循这些策略，你应该能够有效地解决 Ansible 中的 “fatal: [localhost]: FAILED!” 错误，并确保你的剧本在本地主机上顺利执行。

总结

在本 Ansible 教程结束时，你将更好地理解如何处理 “fatal: [localhost]: FAILED!” 错误，从而在使用 Ansible 时能够更有效地进行故障排除和解决问题。这些知识将帮助你简化基于 Ansible 的基础设施管理和自动化工作流程。