ansible.builtin.yaml inventory – 使用特定的 YAML 文件作为清单源。

注意

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

摘要

  • 基于 YAML 的清单，应以 all 组开头，并包含主机/变量/子组条目。

  • 主机条目可以定义子条目，这些子条目将被视为变量。

  • 变量条目是正常的组变量。

  • 子组是“子组”，它们也可以有自己的变量/主机/子组等等。

  • 文件必须具有有效的扩展名，在配置中定义。

参数

参数

注释

yaml_extensions

列表 / 元素=字符串

包含 YAML 的文件的“有效”扩展名列表

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

配置

注释

注意

  • 如果要为清单文件内的 all 组设置变量，则 all 组必须是文件中的第一个条目。

  • 默认情况下在配置中启用。

示例

all: # keys must be unique, i.e. only one 'hosts' per group
    hosts:
        test1:
        test2:
            host_var: value
    vars:
        group_all_var: value
    children:   # key order does not matter, indentation does
        other_group:
            children:
                group_x:
                    hosts:
                        test5   # Note that one machine will work without a colon
                #group_x:
                #    hosts:
                #        test5  # But this won't
                #        test7  #
                group_y:
                    hosts:
                        test6:  # So always use a colon
            vars:
                g2_var2: value3
            hosts:
                test4:
                    ansible_host: 127.0.0.1
        last_group:
            hosts:
                test1 # same host as above, additional group membership
            vars:
                group_last_var: value

提示

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