ipa_hostgroup - Управление группой хостов FreeIPA
Новое в версии 2.3.
Краткое описание
- Добавление, изменение и удаление группы хостов IPA с использованием API IPA
Параметры
| параметр | обязательно | по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| cn | да | Имя группы хостов. Не может быть изменено, так как является уникальным идентификатором. псевдонимы: имя | ||
| description | нет | Описание | ||
| host | нет | Список хостов, которые принадлежат группе хостов. Если передан пустой список, все хосты будут удалены из группы. Если параметр опущен, хосты не будут проверены или изменены. Если параметр передан, все назначенные хосты, которые не указаны, будут удалены из группы. | ||
| hostgroup | нет | Список групп хостов, которые принадлежат этой группе хостов. Если передан пустой список, все группы хостов будут удалены из группы. Если параметр опущен, группы хостов не будут проверены или изменены. Если параметр передан, все назначенные группы хостов, которые не указаны, будут удалены из группы. | ||
| ipa_host | нет | ipa.example.com | IP-адрес или имя хоста сервера IPA | |
| ipa_pass | да | Пароль административного пользователя | ||
| ipa_port | нет | 443 | Порт сервера IPA | |
| ipa_prot | нет | https |
| Протокол, используемый сервером IPA |
| ipa_user | нет | admin | Используемая административная учетная запись на сервере IPA | |
| state | нет | present |
| Состояние, которое необходимо обеспечить. |
| validate_certs | нет | True | Это применимо только если 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 и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/ipa_hostgroup_module.html
