netapp.ontap.na_ontap_lun – NetApp ONTAP управлять LUN
Примечание
Этот плагин является частью коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в playbook, укажите: netapp.ontap.na_ontap_lun.
Новое в версии 2.6.0: of netapp.ontap
Описание
- Создание, удаление, изменение размера LUN в NetApp ONTAP.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Физическая или виртуальная кластерная система 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 | Включение или выключение новой функции. Это может использоваться для включения экспериментальной функции или выключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |||
| flexvol_name строка | Имя FlexVol, на котором должен существовать LUN. Требуется, если san_application_template отсутствует. Не разрешено, если san_application_template присутствует. | |||
| force_remove логическое значение |
| Если "true", переопределяются проверки, предотвращающие уничтожение LUN, если оно подключено и отображено. Если "false", уничтожение подключенного и отображенного LUN завершится ошибкой. | ||
| force_remove_fenced логическое значение |
| Если "true", переопределяются проверки, предотвращающие уничтожение LUN, пока оно заблокировано. Если "false", попытка уничтожения заблокированного LUN завершится ошибкой. Значение по умолчанию, если не указано, - "false". Этот параметр доступен в Data ONTAP 8.2 и более поздних версиях. | ||
| force_resize логическое значение |
| Принудительное уменьшение размера. Требуется для уменьшения размера LUN, чтобы избежать случайного уменьшения размера LUN. | ||
| from_name строка добавлен в 20.12.0 версии netapp.ontap | Имя LUN, которое нужно переименовать. | |||
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |||
| http_port целое число | Переопределяет порт по умолчанию (80 или 443) на указанный порт | |||
| https логическое значение |
| Включение и выключение https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по сертификату SSL, так как она требует SSL. | ||
| key_filepath строка добавлен в 20.6.0 версии netapp.ontap | путь к файлу ключа SSL клиента. | |||
| name строка / обязательно | Имя LUN для управления. | |||
| ontapi целое число | Версия ontap api для использования | |||
| os_type строка | Тип операционной системы для LUN. псевдонимы: ostype | |||
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |||
| qos_policy_group строка добавлен в 20.12.0 версии netapp.ontap | Группа политик QoS для установки на LUN. | |||
| san_application_template словарь добавлен в 20.12.0 версии netapp.ontap | дополнительные параметры при использовании API REST приложения/приложений для создания LUN. модуль по умолчанию использует ZAPI и переключается на REST, если присутствует какой-либо подпараметр. поддерживается только создание или удаление SAN-приложения. Изменения игнорируются. операции на уровне LUN поддерживаются, они требуют знания короткого имени LUN. требуется ONTAP 9.6 или более поздняя версия. | |||
| igroup_name строка | имя группы инициаторов, через которую будет осуществляться доступ к содержимому данного приложения. | |||
| lun_count целое число | количество LUN в компоненте приложения (от 1 до 32). | |||
| name строка / обязательно | имя SAN-приложения. | |||
| protection_type словарь | Политика снимков для тома, поддерживающего LUN. | |||
| local_policy строка | Политика копирования снимков для тома. | |||
| storage_service строка |
| Уровень обслуживания производительности (PSL) для этого тома | ||
| tiering словарь | Политика тиеринга облачных данных (см. tiering_policy, для более полного описания). | |||
| control строка |
| Правила размещения тиеринга хранилища для контейнера. | ||
| object_stores список / элементы=строка | список имен хранилищ объектов для тиеринга. | |||
| policy строка |
| Политика тиеринга облачных данных (см. tiering_policy).Должно совпадать с tiering_policy, если оба присутствуют. | ||
| use_san_application логическое значение |
| Использовать ли API REST приложения/приложений для создания LUN. По умолчанию будет равно true, если присутствует любой другой подпараметр. | ||
| size целое число | Размер LUN в size_unit. Требуется, когда state=present. | |||
| size_unit строка |
| Единица измерения, используемая для интерпретации параметра размера. | ||
| space_allocation логическое значение добавлен в 2.7.0 версии netapp.ontap |
| Это включает поддержку функций SCSI Thin Provisioning. Если хост и файловая система не поддерживают это, не включайте. | ||
| space_reserve логическое значение |
| Может быть установлено в "false", что создаст LUN без резервирования места. | ||
| state строка |
| Указывает, должен ли указанный LUN существовать или нет. | ||
| use_exact_size логическое значение добавлен в 20.11.0 версии netapp.ontap |
| Может быть установлено в "False", что округливает LUN >= 450 гб. | ||
| 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 LUN
na_ontap_lun:
state: present
name: ansibleLUN
flexvol_name: ansibleVolume
vserver: ansibleVServer
size: 5
size_unit: mb
os_type: linux
space_reserve: True
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Resize LUN
na_ontap_lun:
state: present
name: ansibleLUN
force_resize: True
flexvol_name: ansibleVolume
vserver: ansibleVServer
size: 5
size_unit: gb
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Create LUNs using SAN application
tags: create
na_ontap_lun:
state: present
name: ansibleLUN
size: 15
size_unit: mb
os_type: linux
space_reserve: false
san_application_template:
name: san-ansibleLUN
igroup_name: testme_igroup
lun_count: 3
protection_type:
local_policy: default
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_lun_module.html