telekom_mms.icinga_director.icinga_director_inventory inventory — возвращает инвентарь Ansible из Icinga
Примечание
Этот плагин инвентаризации входит в коллекцию telekom_mms.icinga_director (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install telekom_mms.icinga_director.
Чтобы использовать её в плейбуке, укажите: telekom_mms.icinga_director.icinga_director_inventory.
Краткое описание
- Возвращает инвентарь Ansible из Icinga
Параметры
Параметр | Комментарии |
|---|---|
client_cert path | Файл цепочки сертификатов в формате PEM для аутентификации SSL-клиента. Этот файл также может содержать ключ. Если ключ включён в файл, параметр `client_key` указывать не требуется. |
client_key path | Файл в формате PEM, содержащий закрытый ключ для аутентификации SSL-клиента. Если `client_cert` содержит и сертификат, и ключ, этот параметр указывать не требуется. |
compose dictionary | Создавать переменные на основе выражений Jinja2. По умолчанию: |
force boolean | Если Варианты:
|
force_basic_auth boolean | Передавать учётные данные, указанные с помощью `url_username` и `url_password`, в HTTP-заголовке. Варианты:
|
groups dictionary | Добавлять узлы в группы на основе условий Jinja2. По умолчанию: |
http_agent string | Заголовок, используемый для идентификации; обычно отображается в журналах веб-сервера. По умолчанию: |
keyed_groups list / elements=dictionary | Добавлять узлы в группы на основе значений переменной. По умолчанию: |
|
default_value string добавлено в ansible-core 2.12 |
Значение по умолчанию, если значение переменной узла равно Этот параметр нельзя использовать одновременно с |
|
key string |
Ключ входного словаря, используемый для создания групп. |
|
parent_group string |
Родительская группа для группы по ключу. |
|
prefix string |
Имя группы по ключу будет начинаться с этого префикса. По умолчанию: |
|
separator string |
Разделитель, используемый для создания имени группы по ключу. По умолчанию: |
|
trailing_separator boolean добавлено в ansible-core 2.12 |
Установите для этого параметра значение Этот параметр нельзя использовать одновременно с Варианты:
|
leading_separator boolean добавлено в ansible-core 2.11 | Используется совместно с По умолчанию имя группы по ключу, для которой не задан префикс или разделитель, начинается с подчёркивания. Это происходит потому, что префикс по умолчанию — Установите для этого параметра значение Если имя группы формируется на основе отображения, разделитель по-прежнему используется для объединения элементов. Чтобы вовсе не использовать разделитель в имени группы, задайте для группы по ключу пустую строку в качестве разделителя. Варианты:
|
plugin string / обязательный | Имя плагина Варианты:
|
strict boolean | Если Поскольку в выражениях можно использовать факты, они могут быть доступны не всегда, поэтому по умолчанию такие ошибки игнорируются. Варианты:
|
url string / обязательный | URL Icinga для подключения |
url_password string | Пароль для HTTP-аутентификации Basic. Если параметр `url_username` не указан, параметр `url_password` использоваться не будет. |
url_username string | Имя пользователя для HTTP-аутентификации Basic. Этот параметр можно использовать без `url_password` для сайтов, допускающих пустые пароли. |
use_extra_vars boolean добавлено в ansible-core 2.11 | Объединять дополнительные переменные с доступными переменными для композиции (наивысший приоритет). Варианты:
Конфигурация:
|
use_gssapi boolean добавлено в ansible-core 2.11 | Использовать GSSAPI для аутентификации; обычно это Kerberos или Kerberos с аутентификацией Negotiate. Требуется установленная библиотека Python `gssapi <https://github.com/pythongssapi/python-gssapi>`. Учётные данные GSSAPI можно указать с помощью `url_username`/ `url_password` или с помощью переменной среды GSSAPI `KRB5CCNAME`, задающей пользовательский кэш учётных данных Kerberos. Аутентификация NTLM `не` поддерживается, даже если механизм GSSAPI для NTLM установлен. Варианты:
|
use_proxy boolean | Если задано значение `no`, прокси использоваться не будет, даже если он указан в переменной среды на целевых узлах. Варианты:
|
validate_certs boolean | Если задано значение `no`, SSL-сертификаты проверяться не будут. Используйте этот параметр только на сайтах под вашим личным контролем, где применяются самоподписанные сертификаты. Варианты:
|
Примечание
Указанные выше записи конфигурации для каждого типа записи (переменная Ansible, переменная среды и т. д.) расположены в порядке возрастания приоритета. Например, переменная, расположенная ниже в списке, переопределяет переменную, расположенную выше. Типы записей также упорядочены по приоритету от низкого к высокому. Например, запись в ansible.cfg (расположенная выше в списке) переопределяется переменной Ansible (расположенной ниже в списке).
Примечания
Примечание
- На этом этапе инвентари ещё не завершены, поэтому автоматически заполненные группы
allиungroupedбудут отражать только то, что в них явно добавили предыдущие источники инвентаризации. - Во время построения инвентаря «магические переменные» времени выполнения недоступны. Например,
groupsиhostvarsещё не существуют.
Примеры
plugin: telekom_mms.icinga_director.icinga_director_inventory
url: 'https://example.com'
url_username: foo
url_password: bar
force_basic_auth: False
strict: False
# use the object_name you defined as hostname
compose:
hostname: object_name
# create a group based on the operating system defined in a custom variable
keyed_groups:
- prefix: os
key: vars.HostOS
# create groups based on jinja templates
# here we create a group called "rb" if the host variable "check_period" is "24/7"
groups:
rb: check_period == "24/7"
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/telekom_mms/icinga_director/icinga_director_inventory_inventory.html