netapp.ontap.na_ontap_igroup – Настройка группы iSCSI или FC igroup NetApp ONTAP
Примечание
Этот плагин является частью коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap
Для использования в книге задач укажите: netapp.ontap.na_ontap_igroup
Новое в версии 2.6.0: коллекции netapp.ontap
Обзор
- Создание/удаление/переименование групп Igroup и изменение инициаторов, принадлежащих группе igroup
Требования
Ниже перечислены требования к хосту, на котором будет выполняться данный модуль.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Ansible 2.6
- Ansible 2.9 или более поздние версии настоятельно рекомендуются, так как они обеспечивают новую систему доставки коллекций.
- Python2 netapp-lib (2017.10.30) или более поздняя версия. Установите с помощью «pip install netapp-lib»
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью «pip install netapp-lib»
- netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает лучшую отчетность об ошибках при подключении.
- Для включения http в кластере необходимо выполнить следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| bind_portset строка | Имя текущего набора портов для привязки к вновь созданной группе igroup. | |
| cert_filepath строка добавлено в 20.6.0 коллекции netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с Python 2.6. | |
| feature_flags словарь добавлено в 20.5.0 коллекции netapp.ontap | Включить или выключить новую функцию. Это может использоваться для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| force_remove_initiator булево |
| Принудительно удалить инициатор, даже если к этой группе инициаторов уже подключены LUN. |
| from_name строка добавлено в 2.7.0 коллекции netapp.ontap | Имя группы igroup для переименования в имя. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить стандартный порт (80 или 443) с помощью данного порта | |
| https булево |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации SSL-сертификатом, так как она требует SSL. |
| initiator_group_type строка |
| Тип группы инициаторов. Требуется при state=present. |
| initiators список / элементы=строка | Список инициаторов, которые должны быть сопоставлены с группой igroup. WWPN, псевдоним WWPN или имя iSCSI инициатора для добавления или удаления. При операции изменения этот список заменяет существующие инициаторы Этот модуль не добавляет и не удаляет конкретные инициаторы в группе igroup псевдонимы: инициатор | |
| key_filepath строка добавлено в 20.6.0 коллекции netapp.ontap | путь к файлу закрытого ключа SSL-клиента. | |
| name строка / обязательно | Имя группы igroup для управления. | |
| ontapi целое число | Версия API ontap для использования | |
| os_type строка | Тип ОС инициаторов в группе. псевдонимы: ostype | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| state строка |
| Существование указанной группы Igroup. |
| use_rest строка | По умолчанию: "авто" | API REST, если поддерживается целевой системой для всех ресурсов и атрибутов, требуемых модулем. В противном случае вернется к ZAPI. всегда -- всегда будет использоваться API REST никогда -- всегда будет использоваться ZAPI авто -- попытаться использовать API REST |
| username строка | Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или API уровня SVM. Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. Аутентификация по умолчанию, используя имя пользователя и пароль, 2. Аутентификация с помощью SSL-сертификата клиента, используя файл SSL-сертификата клиента и, необязательно, файл закрытого ключа. Для использования сертификата, сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификату. псевдонимы: user | |
| validate_certs булево |
| Если установлено в no, SSL-сертификаты не будут проверены.Это следует устанавливать только в False на контролируемых сайтах с использованием самозаверенных сертификатов. |
| vserver строка / обязательно | Имя vserver для использования. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create iSCSI Igroup
na_ontap_igroup:
state: present
name: ansibleIgroup3
initiator_group_type: iscsi
os_type: linux
initiators: 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 FC Igroup
na_ontap_igroup:
state: present
name: ansibleIgroup4
initiator_group_type: fcp
os_type: linux
initiators: 20:00:00:50:56:9f:19:82
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: rename Igroup
na_ontap_igroup:
state: present
from_name: ansibleIgroup3
name: testexamplenewname
initiator_group_type: iscsi
os_type: linux
initiators: 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 initiators)
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
na_ontap_igroup:
state: absent
name: ansibleIgroup3
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Авторы
- Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>
© 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/netapp/ontap/na_ontap_igroup_module.html