一、Debug模块介绍
Ansible的Debug模块是用于调试Ansible Playbook和任务错误的一个非常实用的模块。它可以输出变量的值、任务执行结果等信息，可以方便地定位问题。
Debug模块可以输出文本信息和变量的值，同时还可以通过指定verbosity参数输出不同级别的调试信息。
下面是Debug模块最基本的使用方法：
- name: 输出变量的值
debug:
var: foo
其中，var参数指定要输出的变量的名称。
二、输出文本信息
Debug模块不仅可以输出变量的值，还可以输出文本信息。这对于调试Playbook和任务错误非常有用。
下面是一个例子，演示了如何输出一段文本：
- name: 输出一段文本
debug:
msg: "Hello, world"
可以看到，msg参数指定了要输出的文本。
三、输出调试信息
Debug模块还可以输出各种级别的调试信息。这对于调试复杂的Playbook和任务非常有用。
下面是Debug模块支持的不同调试级别：
0：输出所有调试信息（默认）1：不输出变量值等详细信息2：只输出关键信息3：只输出指定的信息
下面是演示如何使用verbosity参数输出不同级别的调试信息：
- name: 输出各种级别的调试信息
debug:
msg: "debug message"
verbosity: 2
可以看到，使用verbosity参数可以指定输出的调试级别。
四、Debug模块的使用技巧
1、使用变量名输出变量的值
Debug模块可以通过变量名输出变量的值。这样可以方便地在调试信息中查看变量的实际值，便于定位问题。
例如：
- name: 输出变量的值
debug:
var: foo
可以看到，var参数指定了要输出的变量的名称。
2、使用{{ }}输出变量的值
在Playbook或任务中，可以使用{{ }}语法输出变量的值。这种语法也可以在Debug模块中使用。
例如：
- name: 输出变量的值
debug:
msg: "foo 的值是 {{ foo }}"
可以看到，{{ }}语法可以直接嵌入到输出文本中。
3、使用when参数输出特定条件下的值
当Playbook或任务只在满足特定条件时才会被执行时，可以使用when参数控制Debug模块输出的值。
例如：
- name: 输出变量的值
debug:
var: foo
when: foo is defined
可以看到，when参数指定了条件，只有在foo已定义时才会输出变量的值。
五、Debug模块的高级用法
1、使用register参数注册变量
Debug模块可以通过register参数将变量的值注册为新的变量。这对于在后续任务中使用变量非常有用。
例如：
- name: 注册变量
shell: "grep pattern file.txt | head -1"
register: result
- name: 输出注册的变量
debug:
var: result.stdout
可以看到，在第一个任务中，使用shell模块执行命令，并将命令的输出注册为一个新的变量result。然后在第二个任务中，使用Debug模块输出result.stdout变量的值。
2、使用multiline参数输出多行文本
Debug模块的multiline参数可以输出多行文本。这在调试多行文本变量时非常有用。
例如：
- name: 输出多行文本
debug:
msg: "{{ '\n'.join(multiline_text.splitlines()) }}"
vars:
multiline_text: |
This is a
multiline
text
可以看到，在vars中定义了一个多行文本变量multiline_text，然后使用join和splitlines函数将它转换为单行文本并输出。
3、使用fail参数抛出错误
Debug模块可以使用fail参数抛出一个错误。这在当某些条件不符合时需要终止Playbook或任务时非常有用。
例如：
- name: 检查变量的值
fail:
msg: "变量值不符合要求"
when: foo < 0
可以看到，当foo小于0时，使用fail参数抛出一个错误。这会终止当前的Playbook或任务。
