ansible.builtin.junit 回调 – 将剧本输出写入 JUnit 文件。

注意

此回调插件是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，您可以使用简短的插件名称 junit。但是，我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.junit，以便轻松链接到插件文档并避免与可能具有相同回调插件名称的其他集合冲突。

回调插件

此插件是一个**聚合回调**。它会在已配置的 stdout 回调旁边添加额外的控制台输出。有关回调插件的更多信息，请参见回调插件。

概要

  • 此回调将剧本输出写入 JUnit 格式的 XML 文件。

  • 任务在报告中显示如下：‘ok’：通过；‘failed’ 且任务名称中包含 ‘EXPECTED FAILURE’：通过；‘failed’ 且任务名称中包含 ‘TOGGLE RESULT’：通过；‘ok’ 且任务名称中包含 ‘TOGGLE RESULT’：失败；因异常导致 ‘failed’：错误；其他原因导致 ‘failed’：失败；‘skipped’：跳过。

需求

以下需求是在执行此回调的本地控制器节点上所需的。

  • 在配置中启用

参数

参数

注释

fail_on_change

字符串

将任何报告为“已更改”的任务视为 JUnit 测试失败

默认值： false

配置

fail_on_ignore

字符串

即使设置了 ignore_on_error，也将失败的任务视为 JUnit 测试失败

默认值： false

配置

hide_task_arguments

字符串

在 Ansible 2.8 中添加

隐藏任务的参数

默认值： false

配置

include_setup_tasks_in_report

字符串

是否应将设置任务包含在最终报告中

默认值： true

配置

output_dir

字符串

写入 XML 文件的目录。

默认值： "~/.ansible.log"

配置

replace_out_of_tree_path

字符串

在 ansible-core 2.12.3 中添加

用给定的占位符替换树外相对任务路径的目录部分

默认值： "none"

配置

task_class

字符串

将输出配置为每个 YAML 文件一个类

默认值： false

配置

task_relative_path

字符串

在 Ansible 2.8 中添加

将输出配置为使用相对于给定目录的相对路径

默认值： "none"

配置

test_case_prefix

字符串

在 Ansible 2.8 中添加

仅当任务具有此值作为前缀时才将其视为测试用例。此外，失败的任务将被记录为失败的测试用例。

默认值： "<empty>"

配置

提示

每个条目类型的配置项具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。