Spec-Zone.ru › Ansible

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

булево

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

Варианты:

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

force_basic_auth

булево

Указанные в `url_username` и `url_password` учетные данные должны передаваться в HTTP-заголовке.

Варианты:

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

groups

словарь

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

Значение по умолчанию: {}

http_agent

строка

Заголовок для идентификации, обычно отображается в логах веб-сервера.

Значение по умолчанию: "ansible-httpget"

keyed_groups

список / элементы=словарь

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

Значение по умолчанию: []

default_value

строка

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

Значение по умолчанию, когда значение переменной хоста — пустая строка.

Этот параметр взаимоисключающий с keyed_groups[].trailing_separator

key

строка

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

parent_group

строка

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

prefix

строка

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

Значение по умолчанию: ""

separator

строка

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

Значение по умолчанию: "_"

trailing_separator

булево

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

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

Этот параметр взаимоисключающий с keyed_groups[].default_value

Варианты:

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

leading_separator

булево

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

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

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

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

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

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

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

Варианты:

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

plugin

строка / обязательно

Имя плагина

Варианты:

  • "telekom_mms.icinga_director.icinga_director_inventory"

strict

булево

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

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

Варианты:

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

url

строка / обязательно

URL Icinga для подключения

url_password

строка

Пароль для использования в аутентификации HTTP Basic.

Если параметр `url_username` не указан, параметр `url_password` не будет использоваться.

url_username

строка

Имя пользователя для использования в аутентификации HTTP Basic.

Этот параметр может использоваться без `url_password` для сайтов, допускающих пустые пароли.

use_extra_vars

логическое

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

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

Варианты:

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

Настройка:

  • Запись INI:

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

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

Варианты:

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

use_proxy

логическое

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

Варианты:

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

validate_certs

логическое

Если `нет`, сертификаты SSL не будут проверены.

Это следует использовать только на контролируемых сайтах с использованием самозаверяющих сертификатов.

Варианты:

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

Примеры

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–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

Spec-Zone.ru

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