如何获取Ansible playbook运行失败信息

Ansible playbook运行失败时，可以通过以下几种方式获取失败信息：

基础概念

Ansible是一个自动化IT工具，用于配置管理系统、部署软件和执行任务。Playbook是Ansible的剧本文件，使用YAML格式编写，定义了一系列的任务和执行步骤。

获取失败信息的优势

快速定位问题：及时获取失败信息有助于快速定位问题所在，提高故障排除效率。
自动化监控：可以集成到持续集成/持续部署（CI/CD）流程中，实现自动化监控和报警。

类型

标准输出：Playbook运行时的标准输出会显示任务的执行情况和错误信息。
日志文件：Ansible可以将执行日志记录到指定的日志文件中。
回调插件：使用回调插件可以在特定事件发生时执行自定义操作，如发送邮件通知。

应用场景

自动化部署：在软件部署过程中，及时获取失败信息以便快速修复。
系统维护：在进行系统配置和维护时，监控任务执行状态。
监控报警：集成到监控系统中，当任务失败时触发报警。

获取失败信息的方法

方法一：查看标准输出

运行Playbook时，直接查看命令行输出：

ansible-playbook your_playbook.yml

失败的任务会在输出中显示错误信息和堆栈跟踪。

方法二：配置日志文件

在ansible.cfg文件中配置日志路径：

[defaults]
log_path = /var/log/ansible.log

这样，所有的执行日志都会被记录到指定的文件中。

方法三：使用回调插件

编写或使用现有的回调插件来处理失败事件。例如，创建一个自定义回调插件custom_callback.py：

from ansible.plugins.callback import CallbackBase

class CallbackModule(CallbackBase):
    CALLBACK_VERSION = 2.0
    CALLBACK_TYPE = 'notification'
    CALLBACK_NAME = 'custom_callback'

    def v2_runner_on_failed(self, result, **kwargs):
        host = result._host
        print(f"Task failed on {host.name}: {result.task_name}")
        print(result._result)

然后在ansible.cfg中启用这个插件：

[defaults]
callback_plugins = /path/to/callback_plugins

示例代码

假设我们有一个简单的Playbook example.yml：

---
- hosts: webservers
  tasks:
    - name: Ensure Apache is installed
      yum:
        name: httpd
        state: present
    - name: Start Apache service
      service:
        name: httpd
        state: started

运行Playbook并查看失败信息：

ansible-playbook example.yml

如果某个任务失败，例如yum模块找不到指定的包，输出会显示类似以下内容：

TASK [Ensure Apache is installed] *********************************************
fatal: [webserver1]: FAILED! => {"changed": false, "msg": "No package httpd available.", "results": []}