generator – Использует Jinja2 для построения хостов и групп из шаблонов
Новое в версии 2.6.
Описание
- Использует файл конфигурации YAML с допустимым YAML или
.configрасширением для определения выражений var и условных выражений групп - Создает шаблон, описывающий каждый хост, и затем использует независимые слои конфигурации
- Каждый элемент каждого слоя комбинируется для создания хоста для каждой комбинации слоёв
- Родительские группы могут быть определены со ссылкой на хосты и другие группы, используя те же переменные шаблона
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| hosts - | Ключ name — это шаблон, используемый для генерации имён хостов на основе опции layers. Каждая переменная в имени расширяется для создания декартова произведения всех возможных комбинаций слоёв.Ключ parents — это список родительских групп, к которым относится хост. Каждый элемент parent содержит ключ name, снова расширенный из шаблона, и необязательный ключ parents, который перечисляет его родителей.Родители также могут содержать vars, который представляет собой словарь переменных, который всегда устанавливается для этой переменной. Это может обеспечить лёгкий доступ к имени группы. Например, установите переменную application, которая устанавливается в значение имени слоя application. | ||
| layers - | Словарь слоёв, где ключ — имя слоя, используемое как имя переменной в ключах host name и parents. Каждое значение слоя — это список возможных значений для этого слоя. | ||
| plugin - / обязательно |
| Токен, гарантирующий, что это исходный файл для плагина «generator». |
Примеры
# inventory.config file in YAML format
plugin: generator
strict: False
hosts:
name: "{{ operation }}-{{ application }}-{{ environment }}-runner"
parents:
- name: "{{ operation }}-{{ application }}-{{ environment }}"
parents:
- name: "{{ operation }}-{{ application }}"
parents:
- name: "{{ operation }}"
- name: "{{ application }}"
- name: "{{ application }}-{{ environment }}"
parents:
- name: "{{ application }}"
vars:
application: "{{ application }}"
- name: "{{ environment }}"
vars:
environment: "{{ environment }}"
- name: runner
layers:
operation:
- build
- launch
environment:
- dev
- test
- prod
application:
- web
- api
Статус
- Данный инвентаризация не гарантирует обратной совместимости. [превью]
- Этот инвентарь содержится сообществом Ansible. [сообщество]
Авторы
- НЕИЗВЕСТНО
Подсказка
Если вы заметите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
Подсказка
Элементы конфигурации для каждого типа имеют порядок приоритета от низкого к высокому. Например, переменная, которая находится ниже в списке, переопределит переменную, расположенную выше.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/plugins/inventory/generator.html