netapp.ontap.na_ontap_nvme_subsystem – NetApp ONTAP Управление подсистемой NVMe
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в книге задач укажите: netapp.ontap.na_ontap_nvme_subsystem.
Новое в версии 2.8.0: of netapp.ontap
Обзор
- Создание/удаление подсистемы NVMe
- Связывание (модификация) хоста/карты с подсистемой NVMe
- Необходимое условие — наличие службы NVMe в виртуальном сервере данных с протоколом NVMe
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- Физическая или виртуальная кластеризованная система 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;»
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cert_filepath строка добавлен в 20.6.0 netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с Python 2.6. | |
| feature_flags словарь добавлен в 20.5.0 netapp.ontap | Включение или отключение новой функции. Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| hosts список / элементы=строка | Список NQN хостов (имя квалификации NVMe), связанных с контроллером. | |
| http_port целое число | Переопределяет порт по умолчанию (80 или 443) на указанный порт | |
| https логическое значение |
| Включение и отключение https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL. |
| key_filepath строка добавлен в 20.6.0 netapp.ontap | путь к файлу закрытого ключа SSL-клиента. | |
| ontapi целое число | Используемая версия API ontap. | |
| ostype строка |
| Указывает тип ostype для инициаторов. |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| paths список / элементы=строка | Список путей пространства имен, которые нужно связать с подсистемой. | |
| skip_host_check логическое значение |
| Пропустить проверку хоста Требуется для удаления подсистемы NVMe с подключенными пространствами имен NVMe |
| skip_mapped_check логическое значение |
| Пропустить проверку сопоставления пространства имен Требуется для удаления подсистемы NVMe с подключенными пространствами имен NVMe |
| state строка |
| Определяет, должно ли существовать указанное подсистема. |
| subsystem строка / обязательно | Указывает подсистему | |
| use_rest строка | Значение по умолчанию: "auto" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае используется ZAPI. always — всегда использовать REST API never — всегда использовать ZAPI auto — попытаться использовать REST API |
| username строка | Это может быть учетная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или на уровне SVM. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. Аутентификация по принципу «пользователь-пароль», используя имя пользователя и пароль. 2. Аутентификация по SSL-сертификату, используя файл SSL-сертификата клиента и, необязательно, файл закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификату. псевдонимы: user | |
| validate_certs логическое значение |
| Если значение равно no, SSL-сертификаты не будут проверены.Это значение следует установить только на сайтах с собственным управлением, использующих самозаверяемые сертификаты. |
| vserver строка / обязательно | Имя виртуального сервера для использования. |
Примечания
Примечание
- Модули с префиксом na_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create NVME Subsystem
na_ontap_nvme_subsystem:
state: present
subsystem: test_sub
vserver: test_dest
ostype: linux
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Delete NVME Subsystem
na_ontap_nvme_subsystem:
state: absent
subsystem: test_sub
vserver: test_dest
skip_host_check: True
skip_mapped_check: True
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Associate NVME Subsystem host/map
na_ontap_nvme_subsystem:
state: present
subsystem: "{{ subsystem }}"
ostype: linux
hosts: nqn.1992-08.com.netapp:sn.3017cfc1e2ba11e89c55005056b36338:subsystem.ansible
paths: /vol/ansible/test,/vol/ansible/test1
vserver: "{{ vserver }}"
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
- name: Modify NVME subsystem map
na_ontap_nvme_subsystem:
state: present
subsystem: test_sub
vserver: test_dest
skip_host_check: True
skip_mapped_check: True
paths: /vol/ansible/test
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Авторы
- Команда Ansible NetApp (@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_nvme_subsystem_module.html