ipa_hostgroup — Управление группой хостов FreeIPA
Новая версия 2.3.
Обзор
- Добавление, изменение и удаление группы хостов IPA с использованием API IPA
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cn обязательно | Имя группы хостов. Не может быть изменено, так как является уникальным идентификатором. псевдонимы: имя | |
| description | Описание | |
| host | Список хостов, входящих в группу хостов. Если передан пустой список, все хосты будут удалены из группы. Если параметр опущен, хосты не будут проверены или изменены. Если параметр передан, все назначенные хосты, которые не указаны, будут удалены из группы. | |
| hostgroup | Список групп хостов, входящих в эту группу хостов. Если передан пустой список, все группы хостов будут удалены из группы. Если параметр опущен, группы хостов не будут проверены или изменены. Если параметр передан, все назначенные группы хостов, которые не указаны, будут удалены из группы. | |
| ipa_host | Значение по умолчанию: ipa.example.com | IP-адрес или имя хоста сервера IPA. Если значение не указано в задаче, будет использовано значение переменной среды IPA_HOST. Если и переменная среды IPA_HOST, и значение не указаны в задаче, используется значение по умолчанию.Механизм обратного вызова переменных среды добавлен в версии 2.5. |
| ipa_pass обязательно | Пароль административного пользователя. Если значение не указано в задаче, будет использовано значение переменной среды IPA_PASS. Если и переменная среды IPA_PASS, и значение не указаны в задаче, используется значение по умолчанию.Механизм обратного вызова переменных среды добавлен в версии 2.5. | |
| ipa_port | Значение по умолчанию: 443 | Порт сервера FreeIPA/IPA. Если значение не указано в задаче, будет использовано значение переменной среды IPA_PORT. Если и переменная среды IPA_PORT, и значение не указаны в задаче, используется значение по умолчанию.Механизм обратного вызова переменных среды добавлен в версии 2.5. |
| ipa_prot |
| Протокол, используемый сервером IPA. Если значение не указано в задаче, будет использовано значение переменной среды IPA_PROT. Если и переменная среды IPA_PROT, и значение не указаны в задаче, используется значение по умолчанию.Механизм обратного вызова переменных среды добавлен в версии 2.5. |
| ipa_user | Значение по умолчанию: admin | Используемый административный аккаунт на сервере IPA. Если значение не указано в задаче, будет использовано значение переменной среды IPA_USER. Если и переменная среды IPA_USER, и значение не указаны в задаче, используется значение по умолчанию.Механизм обратного вызова переменных среды добавлен в версии 2.5. |
| state |
| Состояние для обеспечения. |
| validate_certs | Значение по умолчанию: yes | Это применимо только если ipa_prot равно https.Если установлено в no, сертификаты SSL не будут проверены.Это следует установить в no только для сайтов, контролируемых лично, использующих самозаверенные сертификаты. |
Примеры
# Ensure host-group databases is present
- 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
# Ensure host-group databases is absent
- ipa_hostgroup:
name: databases
state: absent
ipa_host: ipa.example.com
ipa_user: admin
ipa_pass: topsecret
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| hostgroup dict | всегда | Группа хостов, как возвращается 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.5/modules/ipa_hostgroup_module.html
