t_systems_mms.icinga_director.icinga_endpoint – Управление конечными точками в Icinga2
Примечание
Этот плагин является частью коллекции t_systems_mms.icinga_director (версия 1.13.0).
Для его установки используйте: ansible-galaxy collection install t_systems_mms.icinga_director
Чтобы использовать его в книге задач, укажите: t_systems_mms.icinga_director.icinga_endpoint
Новое в версии 1.5.0: из t_systems_mms.icinga_director
Обзор
- Добавление или удаление конечной точки в Icinga2 через API директора.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| client_cert путь | Файл цепочки сертификатов в формате PEM, используемый для аутентификации клиента по SSL. Этот файл также может содержать ключ, и если ключ включен, client_key не требуется. | |
| client_key путь | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации клиента по SSL. Если client_cert содержит как сертификат, так и ключ, этот параметр не требуется. | |
| force логическое значение |
| Если yes не получить кэшированную копию.Псевдоним thirsty устарел и будет удален в версии 2.13.псевдонимы: thirsty |
| force_basic_auth логическое значение |
| Указанные с помощью url_username и url_password учетные данные должны передаваться в заголовке HTTP. |
| host строка | Имя хоста/IP-адрес удалённой инстанции Icinga 2. | |
| http_agent строка | По умолчанию: "ansible-httpget" | Заголовок для идентификации, обычно отображается в журналах веб-сервера. |
| log_duration строка | Продолжительность хранения логов повторного воспроизведения при потере соединения. По умолчанию 1 день (86400 секунд). Атрибут задается в секундах. Если log_duration установлен в 0, повторное воспроизведение логов отключено. Вы также можете указать значение в удобочитаемом формате, например, 10m для 10 минут или 1h для одного часа. | |
| object_name строка / обязательно | Имя объекта Icinga для этой конечной точки. Обычно это полное имя хоста, но это может быть любой тип строки. Для упрощения работы ваших пользователей настоятельно рекомендуется использовать осмысленные имена для шаблонов. Например, «generic-endpoint» неинформативно, «Стандартный сервер Linux» понятнее. псевдонимы: name | |
| port целое число | Имя службы/порт удалённой инстанции Icinga 2. По умолчанию 5665. | |
| state строка |
| Применение состояния функции. |
| 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 не будут проверены.Это следует использовать только на контролируемых вами сайтах, использующих самозаверенные сертификаты. |
| zone строка | Имя зоны, к которой принадлежит эта конечная точка. |
Примечания
Примечание
- Этот модуль поддерживает режим проверки.
Примеры
- name: Create an endpoint in icinga
t_systems_mms.icinga_director.icinga_endpoint:
state: present
url: "{{ icinga_url }}"
url_username: "{{ icinga_user }}"
url_password: "{{ icinga_pass }}"
object_name: "fooendpoint"
host: "127.0.0.1"
zone: "foozone"
Авторы
- Aaron Bulmahn (@arbu)
© 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_endpoint_module.html
