Spec-Zone.ru › Ansible 2.11

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
строка
    Варианты:
  • PluginCheck ←
  • PluginNotification
  • PluginEvent
Команды плагина 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
строка
    Варианты:
  • present ←
  • absent
Применить состояние функции.
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

Spec-Zone.ru

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