ansible.builtin.host_group_vars 变量 – 负责加载 group_vars 和 host_vars

注意

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

摘要

  • 将 YAML 变量加载到 group_vars/ 和 host_vars/ 目录中相应的组/主机。

  • 文件通过扩展名限制为 .yaml、.json、.yml 或无扩展名。

  • 隐藏文件（以“.”开头）和备份文件（以“~”结尾）以及目录将被忽略。

  • 仅适用于作为现有路径的清单源。

  • 从 2.10 开始，此插件需要启用，并且默认情况下已启用。

需求

以下需求在执行此变量的本地控制器节点上是必需的。

  • 在配置中启用

参数

参数

注释

_valid_extensions

列表 / 元素=字符串

在查找“变量”文件时检查所有这些扩展名，这些文件应该是 YAML 或 JSON 或这些文件的加密版本。

这会影响 vars_files、include_vars、inventory 和 vars 插件等。

默认值： [".yml", ".yaml", ".json"]

配置

阶段

字符串

在 ansible-base 2.10 中添加

控制何时可以执行此变量插件。

将此选项设置为 all 将在导入清单后以及任务需要时运行变量插件。

将此选项设置为 task 将仅在任务需要时运行变量插件。

将此选项设置为 inventory 将仅在解析清单后运行变量插件。

如果省略此选项，则使用全局 RUN_VARS_PLUGINS 配置来确定何时执行变量插件。

选择

  • "all"

  • "task"

  • "inventory"

配置

提示

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