t_systems_mms.icinga_director.icinga_host – Управление хостами в Icinga2
Примечание
Этот плагин входит в состав коллекции t_systems_mms.icinga_director (версия 1.13.0).
Для его установки используйте: ansible-galaxy collection install t_systems_mms.icinga_director.
Для использования в playbook, укажите: t_systems_mms.icinga_director.icinga_host.
Новое в версии 1.0.0: плагина t_systems_mms.icinga_director
Обзор
- Добавление или удаление хоста в Icinga2 через API директора.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| accept_config boolean добавлен в версии 1.9.0 t_systems_mms.icinga_director |
| Указывает, настроен ли агент на прием конфигурации. |
| address string | Адрес хоста. Обычно IPv4 адрес, но может быть любого типа, с которым может работать ваш плагин проверки. | |
| address6 string добавлен в версии 1.4.0 t_systems_mms.icinga_director | Адрес хоста IPv6. Обычно IPv6 адрес, но может быть любого типа, с которым может работать ваш плагин проверки. | |
| check_command string | Имя команды проверки. Хотя это не требуется для определения в директоре, вам все равно нужно указать check_command для хоста или шаблона хоста. | |
| client_cert path | Файл цепочки сертификатов в формате PEM, используемый для проверки подлинности клиента по протоколу SSL. Этот файл также может содержать ключ, и если ключ включен, client_key не требуется. | |
| client_key path | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для проверки подлинности клиента по протоколу SSL. Если client_cert содержит как сертификат, так и ключ, этот параметр не требуется. | |
| disabled boolean |
| Отключенные объекты не будут развернуты. |
| display_name string | Альтернативное имя для этого хоста. Может быть псевдонимом хоста или любой строкой, помогающей пользователям идентифицировать этот хост. | |
| force boolean |
| Если yes не получить кэшированную копию.Псевдоним thirsty устарел и будет удален в версии 2.13.псевдонимы: thirsty |
| force_basic_auth boolean |
| Указанные с помощью url_username и url_password учетные данные должны передаваться в заголовке HTTP. |
| groups list / elements=string | Значение по умолчанию: [] | Группы хостов, которые должны быть напрямую назначены этому узлу. Группы хостов могут быть полезны по различным причинам. Вы можете назначить проверки сервисов на основе назначенной группы хостов. Они также часто используются как инструмент для обеспечения ограниченных представлений в Icinga Web 2. Группы хостов можно напрямую назначить отдельным хостам или шаблонам хостов. Вы также можете рассмотреть возможность назначения групп хостов с помощью правил применения. |
| has_agent boolean добавлен в версии 1.9.0 t_systems_mms.icinga_director |
| Установлен ли на этом хосте агент Icinga 2. |
| http_agent string | Значение по умолчанию: "ansible-httpget" | Заголовок, используемый для идентификации, обычно отображается в журналах веб-сервера. |
| imports list / elements=string | Выберите шаблон хоста. Требуется, когда состояние present. | |
| master_should_connect boolean добавлен в версии 1.9.0 t_systems_mms.icinga_director |
| Должен ли родительский (главный) узел активно пытаться подключиться к этому агенту. |
| notes string добавлен в версии 1.8.0 t_systems_mms.icinga_director | Дополнительные заметки об этом объекте. | |
| notes_url string добавлен в версии 1.8.0 t_systems_mms.icinga_director | Ссылка на дополнительные заметки об этом объекте. Разделяйте несколько ссылок, например, "'http://url1' 'http://url2'". Максимальная длина — 255 символов. | |
| object_name string / required | Имя объекта Icinga для этого хоста. Обычно это полное имя хоста, но это может быть любая строка. Для удобства пользователей настоятельно рекомендуется использовать осмысленные имена для шаблонов. Например, «generic-host» неинформативно, «Стандартный сервер Linux» понятнее. псевдонимы: name | |
| state string |
| Состояние применяемой функции. |
| url string / required | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password string | Пароль для использования в аутентификации HTTP по основанию. Если параметр url_username не указан, параметр url_password не будет использоваться. | |
| url_username string | Имя пользователя для использования в аутентификации 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 dictionary | Пользовательские свойства хоста. | |
| zone string | Установить зону. |
Примечания
Примечание
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create a host in icinga
t_systems_mms.icinga_director.icinga_host:
state: present
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
disabled: false
object_name: "foohost"
address: "127.0.0.1"
address6: "::1"
display_name: "foohost"
groups:
- "foohostgroup"
imports:
- "foohosttemplate"
vars:
dnscheck: "no"
check_command: hostalive
notes: "example note"
notes_url: "'http://url1' 'http://url2'"
has_agent: true
master_should_connect: true
accept_config: true
Авторы
- 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_host_module.html
