community.general.icinga2_host – Управление хостом в Icinga2
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в книге задач, укажите: community.general.icinga2_host.
Обзор
- Добавление или удаление хоста в Icinga2 через API.
- См. https://www.icinga.com/docs/icinga2/latest/doc/12-icinga2-api/
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| check_command строка | Значение по умолчанию: "hostalive" | Команда, используемая для проверки состояния хоста. |
| client_cert путь | Файл цепочки сертификатов в формате PEM, используемый для аутентификации клиента SSL. Этот файл также может содержать ключ, и если ключ включен, client_key не требуется. | |
| client_key путь | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации клиента SSL. Если client_cert содержит как сертификат, так и ключ, этот параметр не требуется. | |
| display_name строка | Имя, используемое для отображения хоста. Если не указано, используется значение параметра name. | |
| force булево |
| Если yes не получать кэшированную копию.Псевдоним thirsty устарел и будет удален в версии 2.13.Псевдонимы: thirsty |
| force_basic_auth булево |
| httplib2, библиотека, используемая модулем uri, отправляет информацию об аутентификации только тогда, когда веб-сервис отвечает на первоначальный запрос статусом 401. Поскольку некоторые службы базовой аутентификации не отправляют должным образом 401, попытки входа могут завершиться неудачей. Этот параметр принудительно отправляет заголовок базовой аутентификации при первоначальном запросе. |
| http_agent строка | Значение по умолчанию: "ansible-httpget" | Заголовок для идентификации, обычно отображается в логах веб-сервера. |
| ip строка / обязательно | IP-адрес хоста. | |
| name строка / обязательно | Имя, используемое для создания/удаления хоста. Оно не обязательно должно быть полным доменным именем (FQDN), но должно быть уникальным. | |
| state строка |
| Состояние применяемого параметра. |
| template строка | Шаблон, используемый для определения хоста. Шаблон нельзя изменить после создания объекта. | |
| url строка | URL HTTP, HTTPS или FTP в формате (http|https|ftp)://[пользователь[:пароль]]@хост.домен[:порт]/путь | |
| url_password строка | Пароль для использования в базовой аутентификации HTTP. Если параметр url_username не указан, параметр url_password не будет использоваться. | |
| url_username строка | Имя пользователя для использования в базовой аутентификации HTTP. Этот параметр может использоваться без url_password для сайтов, которые разрешают пустые пароли. | |
| use_proxy булево |
| Если no, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. |
| validate_certs булево |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах, использующих самозаверенные сертификаты. |
| variables словарь | Словарь переменных. | |
| zone строка | Зона, из которой должен осуществляться мониторинг этого хоста. |
Примеры
- name: Add host to icinga
community.general.icinga2_host:
url: "https://icinga2.example.com"
url_username: "ansible"
url_password: "a_secret"
state: present
name: "{{ ansible_fqdn }}"
ip: "{{ ansible_default_ipv4.address }}"
variables:
foo: "bar"
delegate_to: 127.0.0.1
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| data словарь | всегда | Структура данных, используемая для создания, изменения или удаления хоста |
| name строка | всегда | Имя, используемое для создания, изменения или удаления хоста |
Авторы
- Jurgen Brand (@t794104)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/icinga2_host_module.html
