Spec-Zone.ru › Ansible 2.9

constructed – Использует Jinja2 для построения переменных и групп на основе существующего инвентаря

Новая версия с 2.4.

  • Описание
  • Параметры
  • Примеры
  • Статус

Описание

  • Использует файл конфигурации YAML с допустимым расширением YAML или .config для определения выражений переменных и условных выражений группирования
  • Условные выражения Jinja2, которые определяют принадлежность хоста.
  • Выражения Jinja2 вычисляются и назначаются переменным
  • Для шаблонизации можно использовать только переменные, уже доступные из предыдущих инвентаризаций или кэша фактов.
  • Если strict равно False, неверные выражения будут проигнорированы (предполагается, что переменные отсутствовали).

Параметры

Параметр Варианты/Значения по умолчанию Конфигурация Комментарии
compose
словарь
По умолчанию:
{}
Создать переменные из выражений Jinja2.
groups
словарь
По умолчанию:
{}
Добавить хосты в группы на основе условных выражений Jinja2.
keyed_groups
список
По умолчанию:
[]
Добавить хосты в группы на основе значений переменной.
plugin
- / обязательно
    Варианты:
  • constructed
токен, который гарантирует, что это исходный файл для плагина '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 | intersect(['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.9/plugins/inventory/constructed.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API