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

注意

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

回调插件

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

摘要

  • 此回调将 playbook 输出写入 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>"

配置

提示

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