红帽全球峰会20.13. 额外变量
当您传递问卷调查变量时，它们作为自动化控制器中的额外变量(extra_vars)传递。但是，将额外变量传递给作业模板（就像对问卷调查的操作一样）可能会覆盖从清单和项目传递的其他变量。
默认情况下，extra_vars 标记为 !unsafe，除非您在作业模板的 Extra Variables 部分中指定它们。这些是信任的，因为它们只能由具有足够特权的用户添加或编辑作业模板。例如，嵌套变量在作为提示符输入时不会扩展，因为 Jinja 方括号被视为字符串。有关不安全变量的更多信息，请参阅 Unsafe 或 raw string。
只有在以下条件之一被满足时，传递给作业启动 API 的 extra_vars 才有效：
- 它们与启用的问卷调查中的变量对应。
-
ask_variables_on_launch设置为 True。
Example
为 debug = true 定义了清单的变量。此变量 debug = true 可能会在作业模板问卷调查中被覆盖。
要确保您传递的变量不会被覆盖，请在问卷调查中重新定义变量来确保包括它们。可以在清单、组和主机级别上定义额外的变量。
如果您要指定 ALLOW_JINJA_IN_EXTRA_VARS 参数，请参阅 自动化控制器管理指南中的控制器 提示和 Tricks 部分，以便在控制器 UI 的 Jobs Settings 屏幕中进行配置。
作业模板额外变量字典与问卷调查变量合并。
以下是 YAML 和 JSON 格式的 extra_vars 的一些简化示例：
- YAML 格式的配置：
launch_to_orbit: true satellites: - sputnik - explorer - satcom
launch_to_orbit: true
satellites:
- sputnik
- explorer
- satcom- JSON 格式的配置：
{
"launch_to_orbit": true,
"satellites": ["sputnik", "explorer", "satcom"]
}
{
"launch_to_orbit": true,
"satellites": ["sputnik", "explorer", "satcom"]
}下表记录了自动化控制器中变量优先级的行为（层次结构）与 Ansible 中的变量优先级比较。
| Ansible | 自动化控制器 |
|---|---|
| 角色默认值 | 角色默认值 |
| 动态清单变量 | 动态清单变量 |
| 清单变量 | 自动化控制器清单变量 |
|
清单 | 自动化控制器组变量 |
|
清单 | 自动化控制器主机变量 |
|
Playbook |
Playbook |
|
playbook |
playbook |
| 主机事实 | 主机事实 |
| 注册的变量 | 注册的变量 |
| 设置事实 | 设置事实 |
| Play 变量 | Play 变量 |
|
play | （不支持） |
|
play |
play |
| role 和 include 变量 | role 和 include 变量 |
| 块变量 | 块变量 |
| 任务变量 | 任务变量 |
| 额外变量 | 作业模板额外变量 |
| 作业模板调查(defaults) | |
| 任务启动额外变量 |
20.13.1. 重新启动作业模板
通过设置 launch_type 以重新启动作业来表示重新启动作业，而不是手动 重新启动作业。重新启动行为与启动行为不同，其不会继承 extra_vars。
作业重新启动不会通过继承逻辑。它使用为重新启动的作业计算的相同 extra_vars。
Example
您启动了一个没有 extra_vars 的作业模板，这导致创建名为 j1 的作业。然后，您编辑作业模板并添加 extra_vars （如添加 "{ "hello": "world" }"）。
重新启动 j1 会导致创建 j2，但由于没有继承逻辑，并且 j1 没有 extra_vars，j2 没有任何 extra_vars。
如果您使用您在创建 j1 后添加的 extra_vars 启动作业模板，则创建重新启动作业(j3)包含 extra_vars。重新启动 j3 会导致创建 j4，这还包括 extra_vars。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}