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

注意

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

概要

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

  • 文件扩展名仅限于 .yaml、.json、.yml 或无扩展名之一。

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

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

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

要求

以下要求需要在执行此 vars 的本地控制器节点上满足。

  • 在配置中启用

参数

参数

注释

_valid_extensions

列表 / 元素=字符串

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

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

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

配置

stage

字符串

在 ansible-base 2.10 中添加

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

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

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

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

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

选择

  • "all"

  • "task"

  • "inventory"

配置

提示

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