Модуль telekom_mms.icinga_director.icinga_dependency_template — управление шаблонами зависимостей в Icinga2

Примечание

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

Краткое описание
Параметры
Примечания
Примеры

Краткое описание

Добавление или удаление шаблона зависимости в Icinga2 через API director.

Параметры

Параметр	Комментарии
api_timeout integer	Тайм-аут по умолчанию в секундах для ожидания завершения транзакции. По умолчанию: `10`
append boolean	Не перезаписывать объект целиком, а добавлять указанные свойства. Примечание: добавление к существующим vars, imports или другим спискам/словарям невозможно. Необходимо перезаписать весь список/словарь. Примечание: переменные, заданные по умолчанию, также будут применены, даже если они не заданы. Варианты: `false` `true`
client_cert path	Файл цепочки сертификатов в формате PEM для аутентификации SSL-клиента. Этот файл также может содержать ключ; если ключ включён, параметр `client_key` не требуется.
client_key path	Файл в формате PEM, содержащий закрытый ключ для аутентификации SSL-клиента. Если `client_cert` содержит и сертификат, и ключ, этот параметр не требуется.
disable_checks boolean	Отключать ли проверки при сбое этой зависимости. Варианты: `false` `true`
disable_notifications boolean	Отключать ли уведомления при сбое этой зависимости. Варианты: `false` `true`
force boolean	Если `yes`, не получать кэшированную копию. Варианты: `false` ← (по умолчанию) `true`
force_basic_auth boolean	Передавать учётные данные, указанные с помощью `url_username` и `url_password`, в HTTP-заголовке. Варианты: `false` ← (по умолчанию) `true`
http_agent string	Значение заголовка, используемое для идентификации; обычно отображается в журналах веб-сервера. По умолчанию: `"ansible-httpget"`
ignore_soft_states boolean	Игнорировать ли мягкие состояния при расчёте доступности. Варианты: `false` `true`
object_name псевдонимы: name string / обязательный	Имя правила применения зависимости Icinga.
parent_host string	Родительский узел.
parent_service string	Родительская служба. Если параметр не указан, этот объект зависимости считается зависимостью узла.
period string	Название периода времени, определяющего, когда должно срабатывать это уведомление.
state string	Состояние функции применения. Варианты: `"present"` ← (по умолчанию) `"absent"`
states list / elements=string	Состояния узла/службы, о которых требуется получать уведомления. Варианты: `"Critical"` `"Down"` `"OK"` `"Unknown"` `"Up"` `"Warning"` По умолчанию: `[]`
url string / обязательный	URL HTTP, HTTPS или FTP в формате (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 добавлено в ansible-core 2.11	Использовать GSSAPI для аутентификации; обычно это Kerberos или Kerberos с аутентификацией Negotiate. Для этого необходимо установить библиотеку 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` ← (по умолчанию)
zone string	Зона кластера Icinga.

Примечания

Примечание

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

Примеры

- name: Add dependency template to icinga
  telekom_mms.icinga_director.icinga_dependency_template:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: footdependencytemplate
    period: "24/7"

- name: Add dependency template to icinga with customization
  telekom_mms.icinga_director.icinga_dependency_template:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: footdependencytemplatecustom
    disable_checks: true
    disable_notifications: true
    ignore_soft_states: false
    period: "24/7"
    zone: master
    states:
      - Warning
      - Critical

- name: Update dependency template with ignore_soft_states
  telekom_mms.icinga_director.icinga_dependency_template:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: footdependencytemplateappend
    ignore_soft_states: true
    append: true

Авторы

Gianmarco Mameli (@gianmarco-mameli)

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

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