telekom_mms.icinga_director.icinga_hostgroup модуль — Управление группами хостов в 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_hostgroup.

Новое в telekom_mms.icinga_director 1.0.0

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

Описание

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

Параметры

Параметр	Комментарии
append boolean added in telekom_mms.icinga_director 1.25.0	Не перезаписывать весь объект, а добавлять определенные свойства. Примечание - Добавление к существующим переменным, импортам или любому другому списку/словарю невозможно. Вы должны перезаписать полный список/словарь. Примечание - Переменные, установленные по умолчанию, также будут применены, даже если они не установлены. Варианты: `false` `true`
assign_filter string	Это позволяет настроить фильтр назначений. Пожалуйста, не стесняйтесь комбинировать столько вложенных операторов, сколько хотите.
client_cert path	Файл цепочки сертификатов в формате PEM, который будет использоваться для проверки подлинности клиента SSL. Этот файл также может включать ключ, и если ключ включен, `client_key` не требуется.
client_key path	Файл в формате PEM, содержащий ваш закрытый ключ, который будет использоваться для проверки подлинности клиента SSL. Если `client_cert` содержит и сертификат, и ключ, этот параметр не требуется.
display_name string	Альтернативное отображаемое имя для этой группы. Если вам интересно, как это может быть полезно, просто оставьте это поле пустым.
force boolean	Если `yes` не получить кэшированную копию. Варианты: `false` ← (default) `true`
force_basic_auth boolean	Учётные данные, указанные с помощью `url_username` и `url_password`, должны передаваться в заголовке HTTP. Варианты: `false` ← (default) `true`
http_agent string	Заголовок для идентификации, обычно отображается в логах веб-сервера. По умолчанию: `"ansible-httpget"`
object_name aliases: name string / required	Имя объекта Icinga для этой группы хостов.
state string	Применить состояние функции. Варианты: `"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 string	Имя пользователя для использования в HTTP-авторизации. Этот параметр может использоваться без `url_password` для сайтов, которые допускают пустые пароли.
use_gssapi boolean added in ansible-core 2.11	Использовать GSSAPI для выполнения аутентификации, обычно это для Kerberos или Kerberos через аутентификацию Negotiate. Требуется установка библиотеки Python gssapi. Учётные данные для GSSAPI могут быть указаны с помощью `url_username`/`url_password` или с помощью переменной среды GSSAPI `KRB5CCNAME`, которая указывает настраиваемый кэш учетных данных Kerberos. Аутентификация NTLM не поддерживается, даже если механизм GSSAPI для NTLM был установлен. Варианты: `false` ← (default) `true`
use_proxy boolean	Если `no`, прокси использоваться не будет, даже если он определен в переменной среды на целевых хостах. Варианты: `false` `true` ← (default)
validate_certs boolean	Если `no`, SSL-сертификаты проверяться не будут. Это следует использовать только на лично контролируемых сайтах, использующих самозаверяющие сертификаты. Варианты: `false` `true` ← (default)

Примечания

Примечание

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

Примеры

- name: Create hostgroup
  telekom_mms.icinga_director.icinga_hostgroup:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: foohostgroup
    display_name: foohostgroup

- name: Update hostgroup
  telekom_mms.icinga_director.icinga_hostgroup:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: foohostgroup
    assign_filter: 'host.name="foohost"'
    append: true

- name: Update hostgroup using multiple contiditions in assign_filter
  telekom_mms.icinga_director.icinga_hostgroup:
    state: present
    url: "{{ icinga_url }}"
    url_username: "{{ icinga_user }}"
    url_password: "{{ icinga_pass }}"
    object_name: foohostgroup
    assign_filter: 'host.vars.something="{{ your_var_here }}"|host.vars.something_else="anything"'
    append: true
  vars:
    your_var_here: foo

Авторы

Sebastian Gumprich (@rndmh3ro)

Ссылки на сборник

© 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_hostgroup_module.html