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 словарь |
всегда | Группа хостов, как возвращается API IPA. |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. поддержку и обслуживание модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. в этом разделе.
Автор
- 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.6/modules/ipa_hostgroup_module.html
