Модуль netapp.ontap.na_ontap_nvme_subsystem – Управление подсистемой NVMe в NetApp ONTAP

Примечание

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

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

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

Для использования в playbook укажите: netapp.ontap.na_ontap_nvme_subsystem.

Новое в netapp.ontap 2.8.0

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

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

Создание/удаление подсистемы NVMe
Связывание (изменение) хоста/отображения с подсистемой NVMe
Сервис NVMe должен существовать в vserver данных с протоколом NVMe как предварительное условие

Требования

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

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 или выше

Параметры

Параметр	Комментарии
cert_filepath string added in netapp.ontap 20.6.0	путь к файлу сертификата клиента SSL (.pem). не поддерживается с python 2.6.
feature_flags dictionary added in netapp.ontap 20.5.0	Включить или отключить новую функцию. Это может быть использовано для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без уведомления. Неизвестные ключи игнорируются.
force_ontap_version string added in 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.
hostname string / required	Имя хоста или IP-адрес экземпляра ONTAP.
hosts list / elements=string	Список имен хостов NQN (NVMe Qualification Name), связанных с контроллером.
http_port integer	Переопределить порт по умолчанию (80 или 443) этим портом
https boolean	Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании проверки подлинности сертификата SSL, так как она требует SSL. Варианты: `false` ← (default) `true`
key_filepath string added in netapp.ontap 20.6.0	путь к файлу ключа клиента SSL.
ontapi integer	Версия API ontap для использования
ostype string	Указывает ostype для инициаторов Варианты: `"windows"` `"linux"` `"vmware"` `"xen"` `"hyper_v"`
password aliases: pass string	Пароль для указанного пользователя.
paths list / elements=string	Список путей пространств имен, которые должны быть связаны с подсистемой.
skip_host_check boolean	Пропустить проверку хоста Требуется для удаления подсистемы NVMe с присоединенными пространствами имен NVMe Варианты: `false` ← (default) `true`
skip_mapped_check boolean	Пропустить проверку сопоставленного пространства имен Требуется для удаления подсистемы NVMe с присоединенными пространствами имен NVMe Варианты: `false` ← (default) `true`
state string	Должна ли существовать указанная подсистема или нет. Варианты: `"present"` ← (default) `"absent"`
subsystem string / required	Указывает подсистему
use_rest string	Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль поддерживает REST. Предупреждение выдается, если модуль не поддерживает REST. Ошибка выдается, если параметр модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Ошибка может быть выдана, если параметр REST не поддерживается в ZAPI. auto – будет пытаться использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. Возвращается к ZAPI в противном случае. По умолчанию: `"auto"`

username aliases: user string	Это может быть учётная запись в масштабе кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации базовая аутентификация, с использованием имени пользователя и пароля, аутентификация с помощью SSL-сертификата, с использованием файла клиентского SSL-сертификата и, при необходимости, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация с помощью сертификата.
validate_certs boolean	Если установлено в `no`, SSL-сертификаты проверяться не будут. Это должно быть установлено только в `False` на лично контролируемых сайтах, использующих самозаверяющие сертификаты. Choices: `false` `true` ← (default)
vserver string / required	Имя используемого vserver.

Примечания

Примечание

Модули с префиксом na_ontap созданы для поддержки платформы хранения ONTAP.
https включен по умолчанию и рекомендуется. Чтобы включить http в кластере, необходимо выполнить следующие команды «set -privilege advanced;»; «system services web modify -http-enabled true;»

Примеры

- name: Create NVME Subsystem
  netapp.ontap.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
  netapp.ontap.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
  netapp.ontap.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
  netapp.ontap.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 }}"

Авторы

NetApp Ansible Team (@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_nvme_subsystem_module.html