Spec-Zone.ru › Ansible

telekom_mms.icinga_director.icinga_endpoint модуль — Управление конечными точками в Icinga2

Примечание

Этот модуль входит в состав коллекции 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_endpoint.

Новое в telekom_mms.icinga_director 1.5.0

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

Описание

  • Добавление или удаление конечной точки в Icinga2 через API директора.

Параметры

Параметр

Комментарии

append

boolean

added in telekom_mms.icinga_director 1.25.0

Не перезаписывать весь объект, а добавлять определенные свойства.

Примечание - Добавление к существующим переменным, импортам или любому другому списку/словарю невозможно. Вы должны перезаписать весь список/словарь.

Примечание - Переменные, установленные по умолчанию, также будут применены, даже если не установлены.

Варианты:

  • false
  • true

client_cert

path

Файл цепочки сертификатов в формате PEM, который будет использоваться для проверки подлинности клиента SSL.

Этот файл также может включать ключ, и если ключ включен, client_key не требуется.

client_key

path

Файл в формате PEM, содержащий ваш закрытый ключ, который будет использоваться для проверки подлинности клиента SSL.

Если client_cert содержит и сертификат, и ключ, этот параметр не требуется.

force

boolean

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

Варианты:

  • false ← (default)
  • true

force_basic_auth

boolean

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

Варианты:

  • false ← (default)
  • true

host

string

Имя хоста/IP-адрес удаленного экземпляра Icinga 2.

http_agent

string

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

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

log_duration

string

Продолжительность хранения журналов воспроизведения при потере соединения. По умолчанию 1d (86400 секунд). Атрибут указывается в секундах. Если log_duration установлен в 0, воспроизведение журналов отключено. Вы также можете указать значение в удобочитаемом формате, например 10m для 10 минут или 1h для одного часа.

object_name

aliases: name

string / required

Имя объекта Icinga для этой конечной точки.

Обычно это полное имя хоста, но это может быть практически любая строка.

Для упрощения работы ваших пользователей мы настоятельно рекомендуем использовать осмысленные имена для шаблонов.

Например, «generic-endpoint» выглядит некрасиво, «Стандартный Linux-сервер» проще понять.

port

integer

Имя службы/порт удаленного экземпляра Icinga 2. По умолчанию 5665.

state

string

Применить состояние функции.

Варианты:

  • "present" ← (default)
  • "absent"

url

string / required

HTTP, HTTPS или FTP URL в формате (http|https|ftp)://[user[:pass]]@host.domain[:port]/path

url_password

string

Пароль для использования в HTTP-авторизации.

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

url_username

string

Имя пользователя для использования в HTTP-авторизации.

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

use_gssapi

boolean

added in ansible-core 2.11

Использовать GSSAPI для выполнения аутентификации, обычно это Kerberos или Kerberos через аутентификацию Negotiate.

Требуется установка библиотеки Python gssapi.

Учётные данные для GSSAPI могут быть указаны с помощью url_username/url_password или с помощью переменной среды GSSAPI KRB5CCNAME, которая указывает настраиваемый кеш учетных данных Kerberos.

Аутентификация NTLM не поддерживается, даже если механизм GSSAPI для NTLM был установлен.

Варианты:

  • false ← (default)
  • true

use_proxy

boolean

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

Варианты:

  • false
  • true ← (default)

validate_certs

boolean

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

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

Варианты:

  • false
  • true ← (default)

zone

string

Имя зоны, к которой относится этот конечный пункт.

Примечания

Примечание

  • Этот модуль поддерживает режим проверки.

Примеры

- name: Create an endpoint in icinga
  telekom_mms.icinga_director.icinga_endpoint:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: "fooendpoint"
    host: "127.0.0.1"
    zone: "foozone"

- name: Update an endpoint in icinga
  telekom_mms.icinga_director.icinga_endpoint:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: "fooendpoint"
    host: "127.0.0.1"
    zone: "foozone"
    port: 5665
    append: true

Авторы

  • Aaron Bulmahn (@arbu)

Ссылки на сборку

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

© 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_endpoint_module.html

Spec-Zone.ru

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