自定义Ansible回调功能：CallbackBase()的详细介绍

Ansible是一种自动化工具，用于部署、配置和管理计算机系统。Ansible回调是一种机制，可以在任务执行期间，实时获取和处理Ansible的输出信息。CallbackBase()是Ansible中的一个回调基类，它提供了一个扩展点，允许用户根据自己的需求自定义回调功能。

CallbackBase()提供了一组可以被用户重载的方法，以便根据需要来处理不同的回调事件。以下是CallbackBase()类中一些常用方法的详细介绍：

1. v2_runner_on_failed(self, result, ignore_errors=False)：当一个任务失败时调用。result参数是一个字典，其中包含有关任务结果的详细信息。ignore_errors参数指示任务失败是否被忽略。

def v2_runner_on_failed(self, result, ignore_errors=False):
    # 自定义处理失败任务的逻辑
    pass

2. runner_on_ok(self, host, result)：当一个任务执行成功时调用。host参数是任务所在的主机对象，result参数是一个字典，包含了任务的结果信息。

def v2_runner_on_ok(self, host, result):
    # 自定义处理任务成功的逻辑
    pass

3. v2_runner_on_unreachable(self, result)：当一个任务无法访问时调用。result参数是一个字典，包含了任务的结果信息。

def v2_runner_on_unreachable(self, result):
    # 自定义处理无法访问的任务的逻辑
    pass

4. v2_playbook_on_stats(self, stats)：在播放书过程中收集统计信息时调用。stats参数是一个包含统计信息的对象。

def v2_playbook_on_stats(self, stats):
    # 自定义处理播放书统计信息的逻辑
    pass

使用CallbackBase()需要继承该类并重载上述的方法。以下是一个简单的使用例子：

from ansible.plugins.callback import CallbackBase

class CustomCallback(CallbackBase):
    def v2_runner_on_ok(self, host, result):
        # 自定义处理任务成功的逻辑
        print("任务执行成功")

    def v2_runner_on_failed(self, result, ignore_errors=False):
        # 自定义处理失败任务的逻辑
        print("任务执行失败")

    def v2_runner_on_unreachable(self, result):
        # 自定义处理无法访问的任务的逻辑
        print("无法访问主机")

    def v2_playbook_on_stats(self, stats):
        # 自定义处理播放书统计信息的逻辑
        print("播放书统计信息")

# 使用自定义回调
callback = CustomCallback()

在上面的示例中，我们定义了一个CustomCallback类，并重载了v2_runner_on_ok()、v2_runner_on_failed()、v2_runner_on_unreachable()和v2_playbook_on_stats()方法来处理不同的回调事件。在这个例子中，我们只是简单地在每个重载的方法中打印一条信息，你可以根据你的需求编写更复杂的逻辑。

使用CustomCallback类作为回调对象，可以使用ansible-playbook或ansible-playbook-api来执行Ansible任务，并触发回调事件。例如，使用ansible-playbook执行playbook并触发回调：

ansible-playbook -i inventory.ini playbook.yml -e 'callback_enabled=True' -e 'callback_plugins=plugin_dir'

在这个例子中，callback_enabled参数用于启用回调功能，callback_plugins参数指定了回调插件的文件夹路径。

总结起来，Ansible的CallbackBase()类提供了一个扩展点，允许用户根据自己的需求来自定义回调功能。通过继承CallbackBase()类，并重载其中的方法，可以实现对不同回调事件的自定义处理逻辑。使用自定义回调可以更灵活地处理Ansible的输出信息，并根据实际需求进行相应的操作。