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

注意

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

回调插件 

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

概要 

此回调将剧本输出写入 JUnit 格式的 XML 文件。
任务在报告中显示如下：'ok'：通过；带有 'EXPECTED FAILURE' 的 'failed' 任务：通过；带有 'TOGGLE RESULT' 的 'failed' 任务：通过；带有 'TOGGLE RESULT' 的 'ok' 任务：失败；因异常导致的 'failed'：错误；因其他原因导致的 'failed'：失败；'skipped'：跳过

需求 

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

在配置中启用

参数 

参数	注释
fail_on_change 字符串	将任何报告为“已更改”的任务视为 JUnit 测试失败默认值： `false` 配置环境变量：`JUNIT_FAIL_ON_CHANGE`
fail_on_ignore 字符串	即使设置了 ignore_on_error，也将失败的任务视为 JUnit 测试失败默认值： `false` 配置环境变量：`JUNIT_FAIL_ON_IGNORE`
hide_task_arguments 字符串在 Ansible 2.8 中添加	隐藏任务的参数默认值： `false` 配置环境变量：`JUNIT_HIDE_TASK_ARGUMENTS`
include_setup_tasks_in_report 字符串	最终报告中是否应包含设置任务默认值： `true` 配置环境变量：`JUNIT_INCLUDE_SETUP_TASKS_IN_REPORT`
output_dir 字符串	写入 XML 文件的目录。默认值： `"~/.ansible.log"` 配置环境变量：`JUNIT_OUTPUT_DIR`
replace_out_of_tree_path 字符串在 ansible-core 2.12.3 中添加	将树外相对任务路径的目录部分替换为给定的占位符默认值： `"none"` 配置环境变量：`JUNIT_REPLACE_OUT_OF_TREE_PATH`
task_class 字符串	配置输出为每个 yaml 文件一个类默认值： `false` 配置环境变量：`JUNIT_TASK_CLASS`
task_relative_path 字符串在 Ansible 2.8 中添加	配置输出以使用相对于给定目录的相对路径默认值： `"none"` 配置环境变量：`JUNIT_TASK_RELATIVE_PATH`
test_case_prefix 字符串在 Ansible 2.8 中添加	仅当任务具有此值作为前缀时才将其视为测试用例。此外，失败的任务将被记录为失败的测试用例。默认值： `"<empty>"` 配置环境变量：`JUNIT_TEST_CASE_PREFIX`

提示

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