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

Примечание

Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев, вы можете использовать короткое имя модуля constructed, даже без указания collections: ключевого слова. Несмотря на это, рекомендуется использовать FQCN для удобной ссылки на документацию модуля и для избежания конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Новое в версии 2.4: of ansible.builtin

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

Описание

Использует файл конфигурации 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 the `aws_ec2` plugin
    # this creates a group per ec2 architecture and assign hosts to the matching ones (arch_x86_64, arch_sparc, etc)
    - prefix: arch
      key: architecture

    # this creates a group per ec2 region like "us_west_1"
    - prefix: ""
      separator: ""
      key: placement.region

    # this creates a common parent group for all ec2 availability zones
    - key: placement.availability_zone
      parent_group: all_ec2_zones

© 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/constructed_inventory.html