constructed – Использует Jinja2 для построения переменных и групп на основе существующего инвентаря
Новая версия 2.4.
Описание
- Использует файл конфигурации YAML с допустимым расширением YAML или
.configдля определения выражений переменных и условных выражений групп - Условные выражения Jinja2, которые определяют принадлежность хоста к группе.
- Выражения Jinja2 вычисляются и присваиваются переменным
- Для шаблонизации можно использовать только переменные, уже доступные из предыдущих инвентаризаций или кэша фактов.
- Когда strict равен False, неверные выражения игнорируются (предполагается, что переменные отсутствуют).
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| compose словарь | По умолчанию: {} | Создать переменные из выражений Jinja2. | |
| groups словарь | По умолчанию: {} | Добавить хосты в группу на основе условных выражений Jinja2. | |
| keyed_groups список | По умолчанию: [] | Добавить хосты в группу на основе значений переменной. | |
| plugin - / обязательно |
| токен, который гарантирует, что это исходный файл для плагина 'constructed'. | |
| strict булево |
| Если yes сделать недействительные записи ошибкой, иначе пропустить и продолжить.Поскольку в выражениях можно использовать факты, они могут не всегда быть доступны, и мы игнорируем эти ошибки по умолчанию. |
Примеры
# inventory.config file in YAML format
plugin: constructed
strict: False
compose:
var_sum: var1 + var2
# this variable will only be set if I have a persistent fact cache enabled (and have non expired facts)
# `strict: False` will skip this instead of producing an error if it is missing facts.
server_type: "ansible_hostname | regex_replace ('(.{6})(.{2}).*', '\\2')"
groups:
# simple name matching
webservers: inventory_hostname.startswith('web')
# using ec2 'tags' (assumes aws inventory)
development: "'devel' in (ec2_tags|list)"
# using other host properties populated in inventory
private_only: not (public_dns_name is defined or ip_address is defined)
# complex group membership
multi_group: (group_names|intersection(['alpha', 'beta', 'omega']))|length >= 2
keyed_groups:
# this creates a group per distro (distro_CentOS, distro_Debian) and assigns the hosts that have matching values to it,
# using the default separator "_"
- prefix: distro
key: ansible_distribution
# the following examples assume the first inventory is from contrib/inventory/ec2.py
# this creates a group per ec2 architecture and assign hosts to the matching ones (arch_x86_64, arch_sparc, etc)
- prefix: arch
key: ec2_architecture
# this creates a group per ec2 region like "us_west_1"
- prefix: ""
separator: ""
key: ec2_region
# this creates a common parent group for all ec2 availability zones
- key: ec2_placement
parent_group: all_ec2_zones
Статус
- Данный инвентарь не гарантирует обратной совместимости. [превью]
- Этот инвентарь поддерживается сообществом 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.8/plugins/inventory/constructed.html