telekom_mms.icinga_director.icinga_director_inventory инвентаризация – Возвращает Ansible инвентаризацию из Icinga
Примечание
Этот плагин инвентаризации входит в состав коллекции telekom_mms.icinga_director (версия 2.1.2).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет 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 путь | Файл цепочки сертификатов в формате PEM, используемый для аутентификации клиента по протоколу SSL. Этот файл также может содержать ключ, и если ключ включен, `client_key` не требуется. |
client_key путь | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации клиента по протоколу SSL. Если `client_cert` содержит как сертификат, так и ключ, этот параметр не требуется. |
compose словарь | Создать переменные из выражений jinja2. Значение по умолчанию: |
force булево | Если Варианты:
|
force_basic_auth булево | Указанные в `url_username` и `url_password` учетные данные должны передаваться в HTTP-заголовке. Варианты:
|
groups словарь | Добавить хосты в группу на основе условных выражений Jinja2. Значение по умолчанию: |
http_agent строка | Заголовок для идентификации, обычно отображается в логах веб-сервера. Значение по умолчанию: |
keyed_groups список / элементы=словарь | Добавить хосты в группу на основе значений переменной. Значение по умолчанию: |
|
default_value строка добавлено в ansible-core 2.12 |
Значение по умолчанию, когда значение переменной хоста — пустая строка. Этот параметр взаимоисключающий с |
|
key строка |
Ключ из входного словаря, используемый для создания групп |
|
parent_group строка |
родительская группа для группы с ключом |
|
prefix строка |
Имя группы с ключом будет начинаться с этого префикса Значение по умолчанию: |
|
separator строка |
Разделитель, используемый для построения имени группы с ключом Значение по умолчанию: |
|
trailing_separator булево добавлено в ansible-core 2.12 |
Установите этот параметр в Этот параметр взаимоисключающий с Варианты:
|
leading_separator булево добавлено в ansible-core 2.11 | Используется совместно с keyed_groups. По умолчанию, у группы с ключом, у которой нет префикса или разделителя, имя начинается с символа подчеркивания. Это происходит потому, что значение по умолчанию для префикса — пустая строка, а для разделителя — «_». Установите этот параметр в False, чтобы исключить ведущий символ подчеркивания (или другой разделитель), если префикс не указан. Если имя группы получено из отображения, разделитель по-прежнему используется для конкатенации элементов. Чтобы вообще не использовать разделитель в имени группы, установите разделитель для группы с ключом в пустую строку. Варианты:
|
plugin строка / обязательно | Имя плагина Варианты:
|
strict булево | Если Так как в выражениях можно использовать факты, они могут не всегда быть доступны, и по умолчанию эти ошибки игнорируются. Варианты:
|
url строка / обязательно | URL Icinga для подключения |
url_password строка | Пароль для использования в аутентификации HTTP Basic. Если параметр `url_username` не указан, параметр `url_password` не будет использоваться. |
url_username строка | Имя пользователя для использования в аутентификации HTTP Basic. Этот параметр может использоваться без `url_password` для сайтов, допускающих пустые пароли. |
use_extra_vars логическое добавлен в ansible-core 2.11 | Объединить дополнительные переменные в доступные переменные для композиции (высший приоритет). Варианты:
Настройка:
|
use_gssapi логическое добавлен в 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 логическое | Если `нет`, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. Варианты:
|
validate_certs логическое | Если `нет`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах с использованием самозаверяющих сертификатов. Варианты:
|
Примеры
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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/telekom_mms/icinga_director/icinga_director_inventory_inventory.html