Модуль netapp.ontap.na_ontap_igroup – Настройка iSCSI или FC igroup NetApp ONTAP

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 22.12.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 или более поздняя версия рекомендуется.
При использовании ZAPI, netapp-lib 2018.11.13 или более поздняя версия (установить с помощью ‘pip install netapp-lib’), настоятельно рекомендуется использовать netapp-lib 2020.3.12, так как она обеспечивает лучшую обработку ошибок при подключении.
Физическая или виртуальная кластеризованная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и более поздние версии, поддержка REST требует ONTAP 9.6 или более поздней версии.

Параметры

Параметр	Комментарии
bind_portset строка	Имя текущего набора портов для привязки к вновь созданному igroup.
cert_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу сертификата SSL-клиента (.pem). не поддерживается с python 2.6.
feature_flags словарь добавлен в netapp.ontap 20.5.0	Включить или выключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version строка добавлен в 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 логическое значение	Принудительно удалить инициатор, даже если к этой группе инициаторов уже привязаны LUN. Этот параметр следует использовать с осторожностью. Варианты: `false` ← (по умолчанию) `true`
from_name строка добавлен в netapp.ontap 2.7.0	Имя igroup, которое нужно переименовать в name.
hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить стандартный порт (80 или 443) на указанный порт.
https логическое значение	Включить или выключить HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при использовании аутентификации с сертификатом SSL, так как она требует SSL. Варианты: `false` ← (по умолчанию) `true`
igroups список / элементы=строка добавлен в netapp.ontap 21.3.0	Список igroup, которые нужно сопоставить с igroup. При изменении этот список заменяет существующие igroup или инициаторы. Этот модуль не добавляет или удаляет конкретные igroup в рамках igroup. Взаимоисключающие с initiator_names (initiators) и initiator_objects. Требуется ONTAP 9.9 и новее.
initiator_group_type псевдонимы: protocol строка	Тип группы инициаторов. Требуется, когда `state=present`. Варианты: `"fcp"` `"iscsi"` `"mixed"`
initiator_names псевдонимы: initiator, initiators список / элементы=строка добавлен в netapp.ontap 21.4.0	Список инициаторов для сопоставления с igroup. WWPN, псевдоним WWPN или имя iSCSI инициатора для добавления или удаления. При изменении этот список заменяет существующие инициаторы или существующие igroup. Этот модуль не добавляет или удаляет конкретные инициаторы в рамках igroup. Взаимоисключающие с igroups и initiator_objects. Выполняет ту же функцию, что и initiator_objects, но без подпараметра comment.
initiator_objects список / элементы=словарь добавлен в netapp.ontap 21.4.0	Список инициаторов для сопоставления с igroup, с необязательным полем комментария. WWPN, псевдоним WWPN или имя iSCSI инициатора для добавления или удаления. При изменении этот список заменяет существующие инициаторы или существующие igroup. Этот модуль не добавляет или удаляет конкретные инициаторы в рамках igroup. Взаимоисключающие с initiator_names (initiators) и igroups. Требуется ONTAP 9.9 с поддержкой REST.
comment строка	Более описательный комментарий, так как WWPN может быть довольно непонятным.
name строка / обязательно	Имя инициатора.
key_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу ключа SSL-клиента.
name строка / обязательно	Имя igroup для управления.

ontapi integer	Версия API ontap для использования
os_type псевдонимы: ostype строка	Тип ОС инициаторов в группе.
password псевдонимы: pass строка	Пароль для указанного пользователя.
state строка	Нужно ли существование указанной группы Igroup. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_rest строка	Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль его поддерживает. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если параметр модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI. auto – попытается использовать REST API, если модуль его поддерживает и параметры модуля поддерживаются. Возвращается к ZAPI в противном случае. По умолчанию: `"auto"`
username псевдонимы: user строка	Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации аутентификация по протоколу basic, с использованием имени пользователя и пароля, аутентификация по сертификату SSL, с использованием файла клиента ssl-сертификата и, необязательно, файла закрытого ключа. Для использования сертификата сертификат должен быть установлен в кластере ONTAP, а аутентификация по сертификатам должна быть включена.
validate_certs булево	Если установлено `no`, сертификаты SSL не будут проверены. Это должно быть установлено только в `False` используется на сайтах, контролируемых лично, с использованием самоподписанных сертификатов. Варианты: `false` `true` ← (по умолчанию)
vserver строка / обязательно	Имя vserver для использования.

Примечания

Примечание

поддерживает режим проверки.
поддерживает ZAPI и REST.
Модули, начинающиеся с 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/ontap/na_ontap_igroup_module.html