ansible.builtin.yaml – Использует определённый YAML-файл в качестве источника инвентаризации.
Примечание
Этот модуль входит в состав ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать сокращённое имя модуля yaml, даже не указывая ключевое слово collections:. Несмотря на это, рекомендуется использовать полное имя класса (FQCN) для удобной ссылки на документацию модуля и для избежания конфликтов с другими коллекциями, которые могут иметь такое же имя модуля.
Добавлено в версии 2.4: of ansible.builtin
Описание
- Инвентаризация на основе YAML, должна начинаться с группы
allи содержать записи hosts/vars/children. - Записи хостов могут иметь вложенные записи, которые будут обрабатываться как переменные.
- Записи vars являются обычными переменными группы.
- Children — это «дочерние группы», которые также могут иметь свои собственные vars/hosts/children и так далее.
- Файл ДОЛЖЕН иметь допустимое расширение, определённое в конфигурации.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| yaml_extensions список / элементы=строка | По умолчанию: [".yaml", ".yml", ".json"] | записи ini: [defaults] [inventory_plugin_yaml] переменная окружения:ANSIBLE_YAML_FILENAME_EXT переменная окружения:ANSIBLE_INVENTORY_PLUGIN_EXTS | список допустимых расширений для файлов, содержащих YAML |
Примечания
Примечание
- Если вы хотите задать переменные для группы
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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/yaml_inventory.html