community.general.ipa_hostgroup – Управление группой хостов FreeIPA

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать его в книге задач, укажите: community.general.ipa_hostgroup.

Описание
Параметры
Примеры
Возвращаемые значения

Описание

Добавление, изменение и удаление группы хостов IPA с помощью API IPA.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cn строка / обязательно		Имя группы хостов. Не может быть изменено, так как является уникальным идентификатором. псевдонимы: имя
description строка		Описание.
host список / элементы=строка		Список хостов, входящих в группу хостов. Если передан пустой список, все хосты будут удалены из группы. Если параметр опущен, хосты не будут проверяться или изменятся. Если параметр передан, все назначенные хосты, которые не указаны, будут удалены из группы.
hostgroup список / элементы=строка		Список групп хостов, входящих в данную группу хостов. Если передан пустой список, все группы хостов будут удалены из группы. Если параметр опущен, группы хостов не будут проверяться или изменятся. Если параметр передан, все назначенные группы хостов, которые не указаны, будут удалены из группы.
ipa_host строка	По умолчанию: "ipa.example.com"	IP-адрес или имя хоста сервера IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_HOST`. Если ни переменная окружения `IPA_HOST`, ни значение не указаны в задаче, тогда DNS будет использоваться для попытки обнаружения сервера FreeIPA. Необходимая запись в FreeIPA — это запись «ipa-ca». Если ни запись DNS, ни переменная окружения `IPA_HOST`, ни значение не доступны в задаче, то будет использовано значение по умолчанию. Механизм обратного вызова переменных окружения добавлен в Ansible 2.5.
ipa_pass строка		Пароль административного пользователя. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_PASS`. Обратите внимание, что если доступна библиотека «urllib_gssapi», можно использовать GSSAPI для аутентификации на сервере FreeIPA. Если доступна переменная окружения `KRB5CCNAME`, модуль будет использовать этот кеш учетных данных Kerberos для аутентификации на сервере FreeIPA. Если доступна переменная окружения `KRB5_CLIENT_KTNAME`, и `KRB5CCNAME` нет; модуль будет использовать этот ключ Kerberos для аутентификации. Если GSSAPI недоступен, использование «ipa_pass» обязательно. Механизм обратного вызова переменных окружения добавлен в Ansible 2.5.
ipa_port целое число	По умолчанию: 443	Порт сервера FreeIPA/IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_PORT`. Если ни переменная окружения `IPA_PORT`, ни значение не указаны в задаче, то устанавливается значение по умолчанию. Механизм обратного вызова переменных окружения добавлен в Ansible 2.5.
ipa_prot строка	Варианты: http https ←	Протокол, используемый сервером IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_PROT`. Если ни переменная окружения `IPA_PROT`, ни значение не указаны в задаче, то устанавливается значение по умолчанию. Механизм обратного вызова переменных окружения добавлен в Ansible 2.5.
ipa_timeout целое число	По умолчанию: 10	Устанавливает тайм-аут бездействия (в секундах) для подключения. Для операций с большими объёмами данных может потребоваться увеличить это значение, чтобы избежать таймаута от сервера IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_TIMEOUT`. Если ни переменная окружения `IPA_TIMEOUT`, ни значение не указаны в задаче, то устанавливается значение по умолчанию.
ipa_user строка	По умолчанию: "admin"	Используемый административный учётная запись на сервере IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_USER`. Если ни переменная окружения `IPA_USER`, ни значение не указаны в задаче, то устанавливается значение по умолчанию. Механизм обратного вызова переменных окружения добавлен в Ansible 2.5.
state строка	Варианты: absent disabled enabled present ←	Состояние, которое необходимо обеспечить.
validate_certs булево	Варианты: no yes ←	Это относится только если `ipa_prot` является https. Если установлено значение `no`, сертификаты SSL не будут проверены. Это значение следует устанавливать только в `no` на сайтах под собственным контролем, использующих самозаверяющие сертификаты.

Примеры

- name: Ensure host-group databases is present
  community.general.ipa_hostgroup:
    name: databases
    state: present
    host:
    - db.example.com
    hostgroup:
    - mysql-server
    - oracle-server
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

- name: Ensure host-group databases is absent
  community.general.ipa_hostgroup:
    name: databases
    state: absent
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

Возвращаемые значения

Общие возвращаемые значения описаны в здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
hostgroup словарь	всегда	Группа хостов, как возвращается API IPA.

Авторы

Thomas Krahn (@Nosmoht)

© 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/ipa_hostgroup_module.html