ansible.builtin.yaml – Использует определённый YAML-файл в качестве источника инвентаризации.
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев, вы можете использовать короткое имя модуля yaml, даже не указывая ключевое слово collections:. Несмотря на это, мы рекомендуем использовать полное имя (FQCN) для лёгкой ссылки на документацию по модулю и для избежания конфликтов с другими коллекциями, которые могут иметь такое же имя модуля.
Новое в версии 2.4: от 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/yaml_inventory.html