community.general.ipa_group – Управление группой FreeIPA

Примечание

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

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

Для использования в плейбуке укажите: community.general.ipa_group.

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

Обзор

Добавление, изменение и удаление групп на сервере IPA

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cn строка / обязательно		Каноническое имя. Не может быть изменено, так как является уникальным идентификатором. псевдонимы: name
description строка		Описание группы.
external булево	Варианты: no yes	Разрешить добавление внешних не-IPA членов из доверенных доменов.
gidnumber строка		GID (используйте этот параметр для его ручного задания). псевдонимы: gid
group список / элементы=строка		Список имён групп, назначенных данной группе. Если передан пустой список, все группы будут удалены из этой группы. Если параметр опущен, назначенные группы не будут проверяться или изменяться. Группы, которые уже назначены, но не переданы, будут удалены.
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.
nonposix булево	Варианты: no yes	Создать как группу non-POSIX.
state строка	Варианты: absent present ←	Требуемое состояние
user список / элементы=строка		Список имён пользователей, назначенных данной группе. Если передан пустой список, все пользователи будут удалены из этой группы. Если параметр опущен, назначенные пользователи не будут проверяться или изменяться. Пользователи, которые уже назначены, но не переданы, будут удалены.
validate_certs булево	Варианты: no yes ←	Это применимо только если `ipa_prot` равен https. Если установлено значение `no`, сертификаты SSL не будут проверены. Это следует устанавливать только в `no` для сайтов, контролируемых лично, с использованием самозаверяемых сертификатов.

Примеры

- name: Ensure group is present
  community.general.ipa_group:
    name: oinstall
    gidnumber: '54321'
    state: present
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

- name: Ensure that groups sysops and appops are assigned to ops but no other group
  community.general.ipa_group:
    name: ops
    group:
    - sysops
    - appops
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

- name: Ensure that users linus and larry are assign to the group, but no other user
  community.general.ipa_group:
    name: sysops
    user:
    - linus
    - larry
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

- name: Ensure group is absent
  community.general.ipa_group:
    name: sysops
    state: absent
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

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

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

Ключ	Возвращаемое значение	Описание
group словарь	всегда	Группа, возвращённая 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_group_module.html