Модуль netapp.ontap.na_ontap_igroup — конфигурация igroup iSCSI или FC в NetApp ONTAP

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).

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

Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_igroup.

Добавлено в netapp.ontap 2.6.0

Общие сведения
Требования
Параметры
Примечания
Примеры

Общие сведения

Создание, удаление и переименование групп инициаторов (igroup), а также изменение инициаторов, входящих в igroup

Требования

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

Ansible 2.9 или более поздней версии — рекомендуется версия 2.12 или более поздняя.
Python3 — рекомендуется версия 3.9 или более поздняя.
netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib устарела и больше не поддерживается. Используйте её на свой страх и риск.
Физическая или виртуальная кластерная система Data ONTAP; модули поддерживают Data ONTAP 9.1 и более поздние версии, а для поддержки REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр	Описание
bind_portset string	Имя существующего набора портов, который нужно привязать к только что созданной igroup.
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без уведомления. Неизвестные ключи игнорируются.
force_ontap_version string добавлено в netapp.ontap 21.23.0	Переопределение версии ONTAP кластера при использовании REST. Если указанная версия не соответствует целевому кластеру, поведение не определено. Этот параметр предусмотрен как обходное решение в случаях, когда версию кластера не удаётся прочитать из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Значение должно иметь формат 9.10 или 9.10.1; каждый элемент должен быть целым числом. Если для `use_rest` задано значение auto, этот параметр может принудительно переключить модуль на ZAPI в зависимости от версии и возможностей платформы. Игнорируется при использовании ZAPI.
force_remove_initiator псевдонимы: allow_delete_while_mapped boolean	Принудительно удалить инициатор, даже если с этой группой инициаторов сопоставлены существующие LUN. Используйте этот параметр с осторожностью. Варианты: `false` ← (по умолчанию) `true`
from_name string добавлено в netapp.ontap 2.7.0	Имя igroup, которую нужно переименовать в name.
hostname string / обязательный	Имя узла или IP-адрес экземпляра ONTAP.
http_port integer	Переопределение порта по умолчанию (80 или 443) с помощью этого порта
https boolean	Включение и отключение HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при использовании аутентификации с сертификатом SSL, поскольку для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
igroups list / элементы=string добавлено в netapp.ontap 21.3.0	Список igroup, которые нужно сопоставить с igroup. При изменении этот список заменяет существующие igroup или существующие инициаторы. Этот модуль не добавляет и не удаляет отдельные igroup в igroup. Несовместим с initiator_names (initiators) и initiator_objects. Требуется ONTAP 9.9 или более поздней версии.
initiator_group_type псевдонимы: protocol string	Тип группы инициаторов. Обязателен, если `state=present`. Варианты: `"fcp"` `"iscsi"` `"mixed"`
initiator_names псевдонимы: initiator, initiators list / элементы=string добавлено в netapp.ontap 21.4.0	Список инициаторов, которые нужно сопоставить с igroup. WWPN, псевдоним WWPN или имя iSCSI инициатора, который нужно добавить или удалить. При изменении этот список заменяет существующие инициаторы или существующие igroup. Этот модуль не добавляет и не удаляет отдельные инициаторы в igroup. Несовместим с igroups и initiator_objects. Выполняет ту же функцию, что и initiator_objects, но не содержит подопции comment.
initiator_objects list / элементы=dictionary добавлено в netapp.ontap 21.4.0	Список инициаторов, которые нужно сопоставить с igroup; каждый элемент может содержать необязательное поле comment. WWPN, псевдоним WWPN или имя iSCSI инициатора, который нужно добавить или удалить. При изменении этот список заменяет существующие инициаторы или существующие igroup. Этот модуль не добавляет и не удаляет отдельные инициаторы в igroup. Несовместим с initiator_names (initiators) и igroups. Требуется ONTAP 9.9 с поддержкой REST.
comment string	Более подробный комментарий, поскольку WWPN может быть довольно неинформативным.
name string / обязательный	Имя инициатора.
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
lambda_config dictionary добавлено в netapp.ontap 23.4.0	Параметры конфигурации функции прокси-сервера AWS Lambda. Эта опция и её подопции поддерживаются только при использовании REST.
aws_profile string	Имя профиля AWS для аутентификации.
aws_region string / обязательный	Название региона AWS.
function_name string / обязательный	Имя вызываемой функции AWS Lambda.
name string / обязательный	Имя igroup, которой нужно управлять.
ontapi integer	Версия API ONTAP, которую нужно использовать
os_type псевдонимы: ostype string	Тип ОС инициаторов в группе.
password псевдонимы: pass string	Пароль указанного пользователя.
state string	Должна ли указанная Igroup существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda boolean добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выводится предупреждение. Если параметр модуля не поддерживается в REST, возникает ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может возникнуть ошибка. auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае использовать ZAPI. По умолчанию: `"always"`
username псевдонимы: user string	Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительные сведения см. в документации https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью сертификата SSL: файл сертификата клиента SSL и, при необходимости, файл закрытого ключа. Чтобы использовать сертификат, его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs boolean	Если задано значение `no`, сертификаты SSL не будут проверяться. Задавайте это значение только для личных сайтов с самоподписанными сертификатами, которыми вы управляете: `False`. Варианты: `false` `true` ← (по умолчанию)
vserver string / обязательный	Имя используемого vserver.

Примечания

Примечание

Поддерживается режим проверки.
Поддерживаются ZAPI и REST.
При использовании REST поддерживается функция прокси-сервера AWS Lambda. Примеры см. в файле README.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включён по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create iSCSI Igroup
  netapp.ontap.na_ontap_igroup:
    state: present
    name: ansibleIgroup3
    initiator_group_type: iscsi
    os_type: linux
    initiator_names: iqn.1994-05.com.redhat:scspa0395855001.rtp.openenglab.netapp.com,abc.com:redhat.com
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create iSCSI Igroup - ONTAP 9.9
  netapp.ontap.na_ontap_igroup:
    state: present
    name: ansibleIgroup3
    initiator_group_type: iscsi
    os_type: linux
    initiator_objects:
      - name: iqn.1994-05.com.redhat:scspa0395855001.rtp.openenglab.netapp.com
        comment: for test only
      - name: abc.com:redhat.com
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create FC Igroup
  netapp.ontap.na_ontap_igroup:
    state: present
    name: ansibleIgroup4
    initiator_group_type: fcp
    os_type: linux
    initiator_names: 20:00:00:50:56:9f:19:82
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Rename Igroup
  netapp.ontap.na_ontap_igroup:
    state: present
    from_name: ansibleIgroup3
    name: testexamplenewname
    initiator_group_type: iscsi
    os_type: linux
    initiator_names: iqn.1994-05.com.redhat:scspa0395855001.rtp.openenglab.netapp.com
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify Igroup Initiators (replaces exisiting initiator_names)
  netapp.ontap.na_ontap_igroup:
    state: present
    name: ansibleIgroup3
    initiator_group_type: iscsi
    os_type: linux
    initiator: iqn.1994-05.com.redhat:scspa0395855001.rtp.openenglab.netapp.com
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete Igroup
  netapp.ontap.na_ontap_igroup:
    state: absent
    name: ansibleIgroup3
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

Команда NetApp Ansible (@carchi8py)

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

© 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/netapp/ontap/na_ontap_igroup_module.html