t_systems_mms.icinga_director.icinga_command – Управление командами в 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.
Новое в версии 1.0.0: плагина t_systems_mms.icinga_director
Обзор
- Добавление или удаление команды в Icinga2 через API директора.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| arguments словарь |
Аргументы команды. | |
| client_cert путь |
Файл цепочки сертификатов в формате PEM, используемый для проверки подлинности клиента SSL. В этом файле может быть также указан ключ, и если ключ включен, client_key не требуется. |
|
| client_key путь |
Файл в формате PEM, содержащий ваш закрытый ключ, используемый для проверки подлинности клиента SSL. Если client_cert содержит и сертификат, и ключ, этот параметр не нужен. |
|
| command строка |
Команда, которую Icinga должен выполнить. Требуется, когда состояние равно present.Абсолютные пути принимаются как предоставленные, относительные пути дополняются "PluginDir + ", допускаются аналогичные префиксы. Пробелы будут приводить к разделению пути команды и самостоятельных аргументов. Обратите внимание, что в настоящее время мы не поддерживаем пробелы в именах и путях плагинов. |
|
| command_type строка |
|
Команды проверки плагинов необходимы при выполнении проверок вашей инфраструктуры. Команды уведомлений будут использоваться для уведомления ваших пользователей. Команды событий позволяют запускать определенные действия при возникновении проблем. Некоторые люди используют их для механизмов автоматического исправления, таких как перезапуск служб или перезагрузка систем при определенных пороговых значениях. |
| 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 строка |
Дополнительный таймаут команды. Допустимые значения — секунды или длительности с постфиксом конкретного параметра (например, 1m или 3m 30s). | |
| url строка/обязательно |
URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password строка |
Пароль для использования в аутентификации HTTP Basic. Если параметр url_username не указан, параметр url_password не будет использован. |
|
| url_username строка |
Имя пользователя для использования в аутентификации HTTP Basic. Этот параметр может быть использован без 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
t_systems_mms.icinga_director.icinga_command:
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"
disabled: false
object_name: centreon-plugins
imports:
- centreon-plugins-template
timeout: "1m"
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
t_systems_mms.icinga_director.icinga_command:
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_2
Авторы
- Sebastian Gumprich (@rndmh3ro)
© 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_module.html
