Модуль telekom_mms.icinga_director.icinga_dependency_apply — управление правилами применения зависимостей в 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_apply.

Добавлено в telekom_mms.icinga_director 2.3.0

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

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

Добавляет или удаляет правило применения зависимостей в Icinga2 через API Director.

Параметры

Параметр	Комментарии
api_timeout integer	Тайм-аут по умолчанию в секундах для ожидания завершения транзакции. По умолчанию: `10`
append boolean	Не перезаписывать объект целиком, а добавить заданные свойства. Примечание: добавлять значения к существующим спискам или словарям vars, imports и другим спискам/словарям нельзя. Необходимо перезаписать весь список/словарь. Примечание: переменные, заданные по умолчанию, также будут применены, даже если они не заданы. Варианты: `false` `true`
apply_to string	Указывает, к каким объектам относится это уведомление: к узлам или службам. Обязательный параметр, если state равно `present`. Варианты: `"host"` `"service"`
assign_filter string	Фильтр, для которого будет применяться правило применения службы.
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`
imports list / элементы=string	Шаблоны, которые можно импортировать; добавьте столько, сколько требуется. Обязательный параметр, если state равно `present`. Обратите внимание: порядок импорта свойств из нескольких шаблонов имеет значение — при конфликте используется значение из последнего шаблона. Обязательный параметр, если state равно `present`.
object_name псевдонимы: name string / обязательный	Имя правила применения зависимостей Icinga.
parent_host string	Родительский узел. Можно ссылаться на пользовательские переменные узла через $host.vars.varname$
parent_service string	Родительская служба. Если не указана, этот объект зависимости считается зависимостью узла. Можно ссылаться на пользовательские переменные узла через $host.vars.varname$
period string	Название периода времени, определяющего, когда следует отправлять это уведомление.
state string	Состояние функции применения. Варианты: `"present"` ← (по умолчанию) `"absent"`
states list / элементы=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 apply to icinga
  telekom_mms.icinga_director.icinga_dependency_apply:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: foodependencyapply
    imports:
      - footdependencytemplate
    apply_to: host
    assign_filter: 'host.name="foohost"'

- name: Add dependency apply to icinga with customization
  telekom_mms.icinga_director.icinga_dependency_apply:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: foodependencyapplycustom
    imports:
      - footdependencytemplate
    apply_to: host
    parent_host: $host.vars.variable$
    assign_filter: 'host.name="foohost"'
    disable_checks: true
    disable_notifications: true
    ignore_soft_states: false
    period: "24/7"
    zone: master
    states:
      - Critical
      - Warning

- name: Update dependency apply rule with ignore_soft_states
  telekom_mms.icinga_director.icinga_dependency_apply:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: foodependencyapply
    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_apply_module.html