telekom_mms.icinga_director.icinga_host_template модуль — Управление шаблонами хостов в Icinga2

Примечание

Этот модуль входит в коллекцию telekom_mms.icinga_director (версия 2.1.2).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install telekom_mms.icinga_director.

Чтобы использовать его в книге задач, укажите: telekom_mms.icinga_director.icinga_host_template.

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

Описание
Параметры
Примечания
Примеры

Описание

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

Параметры

Параметр	Комментарии
accept_config boolean добавлен в telekom_mms.icinga_director 1.9.0	Указывает, настроен ли агент для приема конфигурации. Варианты: `false` `true`
address string	Адрес хоста. Обычно IPv4-адрес, но может быть любого типа, с которым может работать ваш плагин проверки.
address6 string	IPv6-адрес хоста. Обычно IPv6-адрес, но может быть любого типа, с которым может работать ваш плагин проверки.
append boolean добавлен в telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а добавлять определенные свойства. Примечание - Добавление к существующим переменным, импортам или любому другому списку/словарям невозможно. Вы должны перезаписать весь список/словарь. Примечание - Переменные, заданные по умолчанию, также будут применены, даже если они не заданы. Варианты: `false` `true`
check_command string	Имя команды проверки. Хотя это необязательно определять в директоре, вы всё равно должны указать check_command в хосте или шаблоне хоста.
check_interval string	Ваш обычный интервал проверки.
check_period string	Имя временного интервала, определяющего, когда этот объект должен контролироваться. По умолчанию не ограничен.
check_timeout string	Таймаут команды проверки в секундах. Переопределяет атрибут таймаута CheckCommand.
client_cert path	Файл цепочки сертификатов в формате PEM, используемый для аутентификации клиента SSL. Этот файл также может содержать ключ, и если ключ включен, `client_key` не требуется.
client_key path	Файл в формате PEM, содержащий ваш закрытый ключ для аутентификации клиента SSL. Если `client_cert` содержит и сертификат, и ключ, этот параметр не требуется.
command_endpoint string	Конечная точка, на которой выполняются команды.
disabled boolean	Отключенные объекты не будут развернуты. Варианты: `false` ← (по умолчанию) `true`
display_name string	Альтернативное имя для этого хоста. Может быть псевдонимом хоста или строкой, помогающей пользователям идентифицировать этот хост.
enable_active_checks boolean	Включить активную проверку этого объекта. Варианты: `false` `true`
enable_event_handler boolean	Включить обработчики событий для этого объекта. Варианты: `false` `true`
enable_flapping boolean	Включить обнаружение флаттера для этого объекта. Варианты: `false` `true`
enable_notifications boolean	Отправлять уведомления для этого объекта. Варианты: `false` `true`
enable_passive_checks boolean	Принимать результаты пассивных проверок для этого объекта. Варианты: `false` `true`
enable_perfdata boolean	Обрабатывать данные производительности, предоставляемые этим объектом. Варианты: `false` `true`
event_command string	Команда события для хоста, которая вызывается при каждом выполнении проверки, если соответствуют эти условия: Хост находится в мягком состоянии Состояние хоста изменяется на жесткое состояние Состояние хоста восстанавливается из мягкого или жесткого состояния в OK/Включено

flapping_threshold_high string	Верхняя граница флаттеринга в процентах для сервиса, который считается флаттерингующим
flapping_threshold_low string	Нижняя граница флаттеринга в процентах для сервиса, который считается не флаттерингующим
force boolean	Если `yes` не получить кэшированную копию. Choices: `false` ← (default) `true`
force_basic_auth boolean	Учётные данные, указанные с помощью `url_username` и `url_password`, должны передаваться в HTTP-заголовке. Choices: `false` ← (default) `true`
groups list / elements=string	Группы хостов, которые должны быть напрямую назначены этому узлу. Группы хостов могут быть полезны по разным причинам. Вы можете назначать проверки сервисов на основе назначенной группы хостов. Они также часто используются в качестве инструмента для обеспечения ограниченного доступа в Icinga Web 2. Группы хостов могут быть напрямую назначены отдельным хостам или шаблонам хостов. Вы также можете рассмотреть возможность назначения групп хостов с помощью правил применения. Default: `[]`
has_agent boolean added in telekom_mms.icinga_director 1.9.0	Установлен ли на этом хосте агент Icinga 2. Choices: `false` `true`
http_agent string	Заголовок для идентификации, обычно отображается в логах веб-сервера. Default: `"ansible-httpget"`
icon_image string	URL, указывающий на значок для этого объекта. Попробуйте «tux.png» для значков относительно public/img/icons или «cloud» (без расширения) для элементов из шрифта значков Icinga
icon_image_alt string	Альтернативный текст, который будет показан, если вышеуказанный значок отсутствует
imports list / elements=string	Выберите шаблон хоста.
master_should_connect boolean added in telekom_mms.icinga_director 1.9.0	Должен ли родительский (главный) узел активно пытаться подключиться к этому агенту. Choices: `false` `true`
max_check_attempts string	Определяет, после скольких попыток проверки достигается новое жёсткое состояние.
notes string added in telekom_mms.icinga_director 1.8.0	Дополнительные заметки для этого объекта.
notes_url string added in telekom_mms.icinga_director 1.8.0	URL, указывающий на дополнительные заметки для этого объекта. Разделяйте несколько URL-адресов следующим образом: “’http://url1’ ‘http://url2’”. Максимальная длина составляет 255 символов.
object_name aliases: name string / required	Имя объекта Icinga для этого шаблона хоста. Обычно это полное доменное имя хоста, но это может быть практически любая строка. Для упрощения работы вашим пользователям мы настоятельно рекомендуем использовать осмысленные имена для шаблонов. Например, «generic-host» — это некрасиво, «Стандартный Linux-сервер» — понятнее.
retry_interval string	Интервал повтора, будет применён после изменения состояния, если не будет достигнуто следующее жёсткое состояние.
state string	Применить состояние функции. Choices: `"present"` ← (default) `"absent"`
url string / required	URL HTTP, HTTPS или FTP в формате (http\|https\|ftp)://[user[:pass]]@host.domain[:port]/path
url_password string	Пароль для использования в HTTP-авторизации. Если параметр `url_username` не указан, параметр `url_password` использоваться не будет.

url_username строка	Имя пользователя для использования в HTTP-аутентификации по принципу «вход-пароль». Этот параметр может быть использован без `url_password` для сайтов, разрешающих пустые пароли
use_gssapi булево добавлено в 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 булево	Если `no`, прокси не будет использоваться, даже если он определен в переменной окружения на целевых хостах. Варианты: `false` `true` ← (по умолчанию)
validate_certs булево	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах под личным контролем, использующих самозаверенные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vars словарь	Настраиваемые свойства хоста.
volatile булево	Является ли данный чек изменчивым. Варианты: `false` `true`
zone строка	Установить зону.

Примечания

Примечание

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

Примеры

- name: Create host template
  telekom_mms.icinga_director.icinga_host_template:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    accept_config: true
    check_command: hostalive
    check_interval: 90s
    check_timeout: 60
    command_endpoint: fooendpoint
    disabled: false
    display_name: foohosttemplate
    enable_active_checks: true
    enable_event_handler: false
    enable_flapping: false
    enable_notifications: true
    enable_passive_checks: false
    enable_perfdata: false
    flapping_threshold_high: "30.0"
    flapping_threshold_low: "25.0"
    has_agent: true
    icon_image_alt: "alt text"
    icon_image: "http://url1"
    master_should_connect: true
    max_check_attempts: 3
    object_name: foohosttemplate
    retry_interval: "1m"
    volatile: false
    groups:
      - "foohostgroup"
    imports:
      - ''
    vars:
      dnscheck: "no"

- name: Update host template
  telekom_mms.icinga_director.icinga_host_template:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: foohosttemplate
    notes: "example note"
    notes_url: "'http://url1' 'http://url2'"
    append: true

Авторы

Michaela Mattes (@michaelamattes)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/telekom_mms/icinga_director/icinga_host_template_module.html