t_systems_mms.icinga_director.icinga_host_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_host_template.
Новое в версии 1.2.0: из t_systems_mms.icinga_director
Обзор
- Добавление или удаление шаблона хоста в Icinga2 через API директора.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| accept_config boolean добавлено в 1.9.0 из t_systems_mms.icinga_director |
| Указывает, настроен ли агент для принятия конфигурации. |
| address строка | Адрес хоста. Обычно IPv4 адрес, но может быть любого типа, с которым может работать ваш плагин проверки. | |
| address6 строка | Адрес хоста IPv6. Обычно IPv6 адрес, но может быть любого типа, с которым может работать ваш плагин проверки. | |
| check_command строка | Имя команды проверки. Хотя это необязательно для определения в директоре, вам все равно нужно предоставить check_command в хосте или шаблоне хоста. | |
| check_interval строка | Регулярный интервал проверки. | |
| client_cert путь | Файл цепочки сертификатов в формате PEM, используемый для аутентификации клиента SSL. Этот файл также может содержать ключ, и если ключ включен, client_key не требуется. | |
| client_key путь | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации клиента SSL. Если client_cert содержит и сертификат, и ключ, этот параметр не требуется. | |
| disabled boolean |
| Отключенные объекты не будут развернуты. |
| display_name строка | Альтернативное имя для этого хоста. Возможно, псевдоним хоста или строка, помогающая пользователям идентифицировать этот хост. | |
| force boolean |
| Если yes не получать кешированную копию.Псевдоним thirsty устарел и будет удален в версии 2.13.псевдонимы: thirsty |
| force_basic_auth boolean |
| Указанные с помощью url_username и url_password учетные данные должны передаваться в HTTP-заголовке. |
| groups список / элементы=строка | По умолчанию: [] | Группы хостов, которые должны быть непосредственно назначены этому узлу. Группы хостов могут быть полезны по разным причинам. Вы можете назначать проверки служб на основе назначенных групп хостов. Они также часто используются как инструмент для принудительного ограничения представлений в Icinga Web 2. Группы хостов могут быть непосредственно назначены отдельным хостам или шаблонам хостов. Вы также можете рассмотреть возможность назначения групп хостов с помощью правил применения. |
| has_agent boolean добавлено в 1.9.0 из t_systems_mms.icinga_director |
| Установлен ли на этом хосте агент Icinga 2. |
| http_agent строка | По умолчанию: "ansible-httpget" | Заголовок для идентификации, обычно отображается в журналах веб-сервера. |
| imports список / элементы=строка | Выберите шаблон хоста. | |
| master_should_connect boolean добавлено в 1.9.0 из t_systems_mms.icinga_director |
| Должен ли родительский (главный) узел активно пытаться подключиться к этому агенту? |
| notes строка добавлено в 1.8.0 из t_systems_mms.icinga_director | Дополнительные заметки для этого объекта. | |
| notes_url строка добавлено в 1.8.0 из t_systems_mms.icinga_director | URL, указывающий на дополнительные заметки для этого объекта. Укажите несколько URL через пробел, например "'http://url1' 'http://url2'". Максимальная длина составляет 255 символов. | |
| object_name строка / обязательно | Имя объекта Icinga для этого шаблона хоста. Обычно это полное имя хоста, но это может быть любая строка. Для удобства пользователей настоятельно рекомендуется использовать осмысленные имена для шаблонов. Например, "generic-host" неинформативно, "Стандартный сервер Linux" понятнее. псевдонимы: name | |
| state строка |
| Состояние применяемой функции. |
| url строка / обязательно | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password строка | Пароль для использования в HTTP-аутентификации по основанию. Если параметр url_username не указан, параметр url_password не будет использован. | |
| url_username строка | Имя пользователя для использования в HTTP-аутентификации по основанию. Этот параметр может быть использован без url_password для сайтов, которые допускают пустые пароли | |
| use_gssapi boolean добавлено в 2.11 из ansible.builtin |
| Использовать GSSAPI для выполнения аутентификации, обычно для аутентификации Kerberos или Kerberos через Negotiate. Требуется установка Python-библиотеки gssapi. Учетные данные для GSSAPI можно указать с помощью url_username/url_password или переменной среды GSSAPI KRB5CCNAME, которая определяет пользовательский кеш учетных данных Kerberos.Аутентификация NTLM not поддерживается, даже если механизм GSSAPI для NTLM установлен. |
| use_proxy boolean |
| Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах. |
| validate_certs boolean |
| Если no, сертификаты SSL не будут проверены.Это следует использовать только на контролируемых вами сайтах, использующих самозаверенные сертификаты. |
| vars словарь | Пользовательские свойства хоста. | |
| zone строка | Установить зону. |
Примечания
Примечание
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create host template
t_systems_mms.icinga_director.icinga_host_template:
state: present
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
object_name: foohosttemplate
display_name: foohosttemplate
disabled: false
check_command: dummy
check_interval: 90s
groups:
- "foohostgroup"
imports:
- ''
notes: "example note"
notes_url: "'http://url1' 'http://url2'"
has_agent: true
master_should_connect: true
accept_config: true
Авторы
- Michaela Mattes (@michaelamattes)
© 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_host_template_module.html
