модуль purestorage.flasharray.purefa_ds — настройка службы каталогов FlashArray

Примечание

Этот модуль входит в коллекцию purestorage.flasharray (версия 1.42.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install purestorage.flasharray. Для работы с этим модулем требуются дополнительные компоненты. Подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: purestorage.flasharray.purefa_ds.

Добавлено в purestorage.flasharray 1.0.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Задание или удаление конфигурации службы каталогов. На данный момент отсутствует возможность настройки сертификатов SSL. Для выполнения этой дополнительной настройки используйте графический интерфейс FlashArray.
Чтобы изменить существующую конфигурацию службы каталогов, сначала необходимо удалить её, а затем создать заново с новыми настройками.

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

python >= 3.3
purestorage >= 1.19
py-pure-client >= 1.26.0
netaddr
requests
pycountry
urllib3

Параметры

Параметр	Описание
api_token string	Токен API FlashArray для пользователя с привилегиями администратора.
base_dn string	Задаёт базовую часть различающегося имени (DN) групп службы каталогов. База должна состоять только из компонентов домена (DC). Для base_dn автоматически задаётся значение по умолчанию при вводе URI: оно формируется путём извлечения компонентов домена из URI. В базовом DN для каждого компонента домена необходимо указать DC=, а несколько компонентов DC следует разделять запятыми.
bind_password string	Задаёт пароль учётной записи пользователя bind_user.
bind_user string	Задаёт имя пользователя, которое можно использовать для привязки к каталогу и отправки запросов к нему. Для Active Directory введите имя пользователя — часто называемое sAMAccountName или User Logon Name, — учётная запись которого используется для поиска в каталоге. Для OpenLDAP введите полный DN пользователя.
certificate string добавлено в purestorage.flasharray 1.24.0	Сертификат центра сертификации (CA), подписавшего сертификаты серверов каталогов. Он используется для проверки подлинности настроенных серверов. Действительный подписанный сертификат в формате PEM (в кодировке Base64). Включает строки «-----BEGIN CERTIFICATE-----» и «-----END CERTIFICATE-----».
check_peer boolean добавлено в purestorage.flasharray 1.24.0	Проверять ли подлинность сервера, если указан сертификат. Варианты: `false` ← (по умолчанию) `true`
context string добавлено в purestorage.flasharray 1.39.0	Имя участника флота, на котором выполняется операция. Для этого массив, получающий запрос, должен быть участником флота, а контекст с указанным именем должен относиться к тому же флоту. По умолчанию: `""`
disable_warnings boolean добавлено в purestorage.flasharray 1.29.0	Отключает предупреждения о небезопасных сертификатах в журналах отладки. Варианты: `false` ← (по умолчанию) `true`
dstype string	Тип службы каталогов, с которой выполняется работа. Варианты: `"management"` ← (по умолчанию) `"data"`
enable boolean	Включает или отключает поддержку службы каталогов. Варианты: `false` ← (по умолчанию) `true`
fa_url string	IPv4-адрес или имя узла для управления FlashArray.
force_bind_password boolean добавлено в purestorage.flasharray 1.14.0	Принудительно сбрасывает пароль привязки, даже если пароль пользователя привязки не изменился. Если задано значение false и значение bind_user не изменилось, пароль сбрасываться не будет. Варианты: `false` `true` ← (по умолчанию)
state string	Создание, удаление или проверка конфигурации службы каталогов. Варианты: `"absent"` `"present"` ← (по умолчанию) `"test"`
uri list / elements=string	Список, содержащий до 30 URI серверов каталогов. Каждый URI должен включать схему ldap:// или ldaps:// (для LDAP через SSL), имя узла и доменное имя либо IP-адрес. Например, ldap://ad.company.com настраивает службу каталогов с именем узла «ad» в домене «company.com» и указывает на использование незашифрованного протокола LDAP.
user_login string	Атрибут входа пользователя в структуре настроенных LDAP-серверов. Обычно это поле атрибута, содержащее уникальное имя пользователя для входа. Значение по умолчанию — sAMAccountName для Active Directory или uid для всех остальных служб каталогов.
user_object string	Значение класса объектов для пользователя управления LDAP. По умолчанию используется User для серверов Active Directory, posixAccount или shadowAccount для серверов OpenLDAP в зависимости от типа группы сервера либо person для всех остальных серверов каталогов.

Примечания

Примечание

Для этого модуля требуются библиотеки Python purestorage и py-pure-client.
Для отдельных модулей могут потребоваться дополнительные библиотеки Python.
Если аргументы fa_url и api_token не передаются модулю напрямую, необходимо задать переменные окружения PUREFA_URL и PUREFA_API.

Примеры

- name: Delete existing directory service
  purestorage.flasharray.purefa_ds:
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Update empty directory service (disabled)
  purestorage.flasharray.purefa_ds:
    dstype: management
    uri: "ldap://lab.purestorage.com"
    base_dn: "DC=lab,DC=purestorage,DC=com"
    bind_user: Administrator
    bind_password: password
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Enable existing directory service
  purestorage.flasharray.purefa_ds:
    enable: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Disable existing directory service
  purestorage.flasharray.purefa_ds:
    enable: false
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Update empty directory service (enabled)
  purestorage.flasharray.purefa_ds:
    enable: true
    dstype: management
    uri: "ldap://lab.purestorage.com"
    base_dn: "DC=lab,DC=purestorage,DC=com"
    bind_user: Administrator
    bind_password: password
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Upload CA certificate for management DNS and check peer
  purestorage.flasharray.purefa_ds:
    enable: true
    dstype: management
    certificate: "{{lookup('file', 'ca_cert.pem') }}"
    check_peer: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Авторы

Команда Ansible Pure Storage (@sdodsley)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/purestorage/flasharray/purefa_ds_module.html