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

注意

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

回调插件

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

概要

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

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

要求

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

  • 在配置中启用

参数

参数

注释

fail_on_change

字符串

将任何报告“changed”的任务视为 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>"

配置

提示

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