ansible.builtin.yaml инвентаризация – Использует определенный YAML-файл в качестве источника инвентаризации.

Примечание

Этот плагин инвентаризации входит в состав ansible-core и включён во все установки Ansible. В большинстве случаев можно использовать короткое имя плагина yaml. Однако мы рекомендуем использовать полное имя коллекции (FQCN) ansible.builtin.yaml для простоты ссылки на документацию плагина и для избежания конфликтов с другими коллекциями, которые могут иметь то же имя плагина инвентаризации.

Описание
Параметры
Примечания
Примеры

Описание

YAML-инвентаризация, должна начинаться с группы all и содержать записи hosts/vars/children.
Записи хостов могут иметь вложенные записи, которые будут обрабатываться как переменные.
Записи vars — это обычные групповые переменные.
Children — это «дочерние группы», которые также могут иметь свои собственные vars/hosts/children и так далее.
Файл ДОЛЖЕН иметь допустимое расширение, определённое в конфигурации.

Параметры

Параметр	Комментарии
yaml_extensions список / элементы=строка	Список «допустимых» расширений для файлов, содержащих YAML По умолчанию: `[".yaml", ".yml", ".json"]` Конфигурация: Записи INI: [defaults] yaml_valid_extensions = .yaml, .yml, .json [inventory_plugin_yaml] yaml_valid_extensions = .yaml, .yml, .json Переменная среды: `ANSIBLE_YAML_FILENAME_EXT` Переменная среды: `ANSIBLE_INVENTORY_PLUGIN_EXTS`

Параметр

Комментарии

yaml_extensions

список / элементы=строка

Список «допустимых» расширений для файлов, содержащих YAML

По умолчанию: [".yaml", ".yml", ".json"]

Конфигурация:

Записи INI:

[defaults]
yaml_valid_extensions = .yaml, .yml, .json

[inventory_plugin_yaml]
yaml_valid_extensions = .yaml, .yml, .json

Переменная среды: ANSIBLE_YAML_FILENAME_EXT
Переменная среды: ANSIBLE_INVENTORY_PLUGIN_EXTS

Примечания

Примечание

Если вы хотите задать переменные для группы 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

Подсказка

Записи конфигурации для каждого типа записи имеют порядок приоритетов от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ansible/builtin/yaml_inventory.html