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、清单和变量插件等。

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

配置

阶段

字符串

在 ansible-base 2.10 中添加

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

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

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

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

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

选择

  • "全部"

  • "任务"

  • "清单"

配置

提示

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