Spec-Zone.ru › Ansible

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

Если yes, не использовать кэшированную копию.

Варианты:

  • false ← (по умолчанию)
  • true

force_basic_auth

boolean

Передавать учётные данные, указанные с помощью `url_username` и `url_password`, в HTTP-заголовке.

Варианты:

  • false ← (по умолчанию)
  • true

groups

dictionary

Добавлять узлы в группы на основе условий Jinja2.

По умолчанию: {}

http_agent

string

Заголовок, используемый для идентификации; обычно отображается в журналах веб-сервера.

По умолчанию: "ansible-httpget"

keyed_groups

list / elements=dictionary

Добавлять узлы в группы на основе значений переменной.

По умолчанию: []

default_value

string

добавлено в ansible-core 2.12

Значение по умолчанию, если значение переменной узла равно None или является пустой строкой.

Этот параметр нельзя использовать одновременно с keyed_groups[].trailing_separator.

key

string

Ключ входного словаря, используемый для создания групп.

parent_group

string

Родительская группа для группы по ключу.

prefix

string

Имя группы по ключу будет начинаться с этого префикса.

По умолчанию: ""

separator

string

Разделитель, используемый для создания имени группы по ключу.

По умолчанию: "_"

trailing_separator

boolean

добавлено в ansible-core 2.12

Установите для этого параметра значение false, чтобы не добавлять keyed_groups[].separator после переменной узла, если её значение равно None или является пустой строкой.

Этот параметр нельзя использовать одновременно с keyed_groups[].default_value.

Варианты:

  • false
  • true ← (по умолчанию)

leading_separator

boolean

добавлено в ansible-core 2.11

Используется совместно с keyed_groups.

По умолчанию имя группы по ключу, для которой не задан префикс или разделитель, начинается с подчёркивания.

Это происходит потому, что префикс по умолчанию — "", а разделитель по умолчанию — "_".

Установите для этого параметра значение false, чтобы не добавлять начальное подчёркивание (или другой разделитель), если префикс не задан.

Если имя группы формируется на основе отображения, разделитель по-прежнему используется для объединения элементов.

Чтобы вовсе не использовать разделитель в имени группы, задайте для группы по ключу пустую строку в качестве разделителя.

Варианты:

  • false
  • true ← (по умолчанию)

plugin

string / обязательный

Имя плагина

Варианты:

  • "telekom_mms.icinga_director.icinga_director_inventory"

strict

boolean

Если yes, считать недопустимые записи критической ошибкой; в противном случае пропускать их и продолжать выполнение.

Поскольку в выражениях можно использовать факты, они могут быть доступны не всегда, поэтому по умолчанию такие ошибки игнорируются.

Варианты:

  • false ← (по умолчанию)
  • true

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

Объединять дополнительные переменные с доступными переменными для композиции (наивысший приоритет).

Варианты:

  • false ← (по умолчанию)
  • true

Конфигурация:

  • Запись INI:

    [inventory_plugins]
    use_extra_vars = false
    
  • Переменная среды: ANSIBLE_INVENTORY_USE_EXTRA_VARS

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 установлен.

Варианты:

  • false ← (по умолчанию)
  • true

use_proxy

boolean

Если задано значение `no`, прокси использоваться не будет, даже если он указан в переменной среды на целевых узлах.

Варианты:

  • false
  • true ← (по умолчанию)

validate_certs

boolean

Если задано значение `no`, SSL-сертификаты проверяться не будут.

Используйте этот параметр только на сайтах под вашим личным контролем, где применяются самоподписанные сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

Примечание

Указанные выше записи конфигурации для каждого типа записи (переменная 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"

Авторы

  • Sebastian Gumprich (@rndmh3ro)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

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