t_systems_mms.icinga_director.icinga_command_template – Управление шаблонами команд в Icinga2
Примечание
Этот плагин входит в коллекцию t_systems_mms.icinga_director (версия 1.13.0).
Для его установки используйте: ansible-galaxy collection install t_systems_mms.icinga_director.
Для использования в книге задач укажите: t_systems_mms.icinga_director.icinga_command_template.
Новое в версии 1.1.0: модуля t_systems_mms.icinga_director
Описание
- Добавление или удаление шаблона команды в Icinga2 через API директора.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| arguments словарь | Аргументы шаблона команды. | |
| client_cert путь | Файл цепочки сертификатов в формате PEM, используемый для проверки подлинности клиента по протоколу SSL. Этот файл также может содержать ключ, и если ключ включен, client_key не требуется. | |
| client_key путь | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для проверки подлинности клиента по протоколу SSL. Если client_cert содержит и сертификат, и ключ, этот параметр не требуется. | |
| command строка | Команда, которую Icinga должен выполнить. Абсолютные пути принимаются как указано, относительные пути предваряются "PluginDir + ", разрешаются аналогичные префиксы констант. Пробелы приводят к разделению пути к команде и отдельных аргументов. Обратите внимание, что в настоящее время мы не поддерживаем пробелы в именах и путях плагинов. | |
| command_type строка |
| Команды плагина Check необходимы при выполнении проверок вашей инфраструктуры. Команды уведомлений используются при уведомлении ваших пользователей. Команды событий позволяют запускать определенные действия при возникновении проблем. Некоторые люди используют их для механизмов автоматического исправления, например, для перезапуска служб или перезагрузки систем при определенных пороговых значениях. |
| disabled булево |
| Отключенные объекты не будут развернуты. |
| force булево |
| Если yes, не будет получена кэшированная копия.Псевдоним thirsty устарел и будет удален в версии 2.13.Псевдонимы: thirsty |
| force_basic_auth булево |
| Указанные учетные данные с параметрами url_username и url_password должны передаваться в HTTP-заголовке. |
| http_agent строка | Значение по умолчанию: "ansible-httpget" | Заголовок для идентификации, обычно появляется в журналах веб-сервера. |
| imports список / элементы=строка | Импортируемые шаблоны, добавляйте столько, сколько нужно. Обратите внимание, что порядок импорта свойств из нескольких шаблонов имеет значение - последний импортированный шаблон имеет приоритет. | |
| object_name строка / обязательно | Имя шаблона команды. Псевдонимы: name | |
| state строка |
| Применить состояние функции. |
| timeout строка | Необязательный таймаут команды. Разрешены значения в секундах или длительности с указанным единицей измерения (например, 1м или 3м 30с). | |
| url строка / обязательно | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password строка | Пароль для использования в HTTP-аутентификации по принципу «имя пользователя/пароль». Если параметр url_username не указан, параметр url_password не будет использоваться. | |
| url_username строка | Имя пользователя для использования в HTTP-аутентификации по принципу «имя пользователя/пароль». Этот параметр может быть использован без url_password для сайтов, которые допускают пустые пароли | |
| use_gssapi булево добавлен в 2.11 ansible.builtin |
| Использование GSSAPI для выполнения аутентификации, как правило, это для аутентификации Kerberos или Kerberos через Negotiate. Требуется установка Python-библиотеки gssapi. Учетные данные для GSSAPI можно указать с помощью url_username/url_password или переменной среды GSSAPI KRB5CCNAME, которая задает кэширование учетных данных Kerberos.Аутентификация NTLM not поддерживается, даже если механизм GSSAPI для NTLM был установлен. |
| use_proxy булево |
| Если no, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. |
| validate_certs булево |
| Если no, сертификаты SSL не будут проверены.Это следует использовать только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. |
| vars словарь | Настраиваемые свойства шаблона команды. | |
| zone строка | Зона кластера Icinga. Позволяет вручную переопределить решения Директора о том, куда развернуть вашу конфигурацию. Вам следует воздержаться от этого, если вы не хорошо понимаете, как работает стек кластера Icinga. |
Примечания
Примечание
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create command template
t_systems_mms.icinga_director.icinga_command_template:
state: present
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
arguments:
'--authpassphrase':
value: $snmpv3_priv_key$
'--authprotocol':
value: $snmpv3_auth_protocol$
'--critical':
value: $centreon_critical$
'--filter':
value: $centreon_filter$
'--hostname':
value: $snmp_address$
'--maxrepetitions':
value: $centreon_maxrepetitions$
'--mode':
value: $centreon_mode$
'--plugin':
value: $centreon_plugin$
'--privpassphrase':
value: $snmpv3_auth_key$
'--privprotocol':
value: $snmpv3_priv_protocol$
'--snmp-community':
value: $snmp_community$
'--snmp-timeout':
value: $snmp_timeout$
'--snmp-username':
value: $snmpv3_user$
'--snmp-version':
value: $snmp_version$
'--subsetleef':
value: $centreon_subsetleef$
'--verbose':
set_if: $centreon_verbose$
'--warning':
value: $centreon_warning$
command: "/opt/centreon-plugins/centreon_plugins.pl"
command_type: "PluginCheck"
object_name: centreon-plugins-template
timeout: "2m"
disabled: false
vars:
centreon_maxrepetitions: 20
centreon_subsetleef: 20
centreon_verbose: false
snmp_address: $address$
snmp_timeout: 60
snmp_version: '2'
snmpv3_auth_key: authkey
snmpv3_priv_key: privkey
snmpv3_user: user
- name: Create command template
t_systems_mms.icinga_director.icinga_command_template:
state: present
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
command: "/opt/centreon-plugins/centreon_plugins_2.pl"
object_name: centreon-plugins-template-2
Авторы
- Lars Krahl (@mmslkr)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/t_systems_mms/icinga_director/icinga_command_template_module.html