netapp.ontap.na_ontap_lun – NetApp ONTAP управлять LUN
Примечание
Этот плагин является частью коллекции netapp.ontap (версия 21.1.1).
Для его установки используйте: ansible-galaxy collection install netapp.ontap
Для использования в playbook, укажите: netapp.ontap.na_ontap_lun
В версии 2.6.0: из netapp.ontap
Обзор
- Создание, уничтожение, изменение размера LUN на NetApp ONTAP.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Ansible 2.9
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью «pip install netapp-lib»
- netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает лучшую отчетность об ошибках при подключении.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и новее.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Чтобы включить 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 целое число | Используемая версия API ontap | |||
| os_type строка | Тип ОС для LUN. псевдонимы: ostype | |||
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |||
| qos_policy_group строка добавлен в 20.12.0 от netapp.ontap | Группа политики QoS, которая должна быть установлена для LUN. | |||
| san_application_template словарь добавлен в 20.12.0 от netapp.ontap | Дополнительные параметры при использовании REST API приложения/приложений для создания 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 словарь | Политика тиеринга облака. | |||
| control строка |
| Правила размещения тиеринга хранилища для контейнера. | ||
| object_stores список / элементы=строка | Список имен хранилищ объектов для тиеринга. | |||
| policy строка |
| Политика тиеринга облака. | ||
| total_size целое число добавлен в 21.1.0 от netapp.ontap | Общий размер компонента приложения, распределенный по LUN-членам в total_size_unit.Рекомендуется, когда lun_count присутствует.Требуется, когда lun_count присутствует и больше 1.Примечание - если lun_count равен 1, а total_size отсутствует, размер используется для обеспечения обратной совместимости. | |||
| total_size_unit строка добавлен в 21.1.0 от netapp.ontap |
| Единица измерения, используемая для интерпретации параметра total_size. По умолчанию совпадает с size_unit, если не указано. | ||
| use_san_application булево |
| Использовать ли REST API приложения/приложений для создания LUN. По умолчанию будет true, если присутствует любой другой подпараметр. | ||
| size целое число | Размер LUN в size_unit.Необходимо при создании одного LUN, если шаблон приложения не используется. | |||
| size_unit строка |
| Единица измерения, используемая для интерпретации параметра size. | ||
| space_allocation булево добавлен в 2.7.0 от netapp.ontap |
| Это включает поддержку функций тонкого выделения пространства SCSI. Если хост и файловая система не поддерживают это, не включайте его. | ||
| space_reserve булево |
| Это можно установить в «false», что создаст LUN без резервирования какого-либо места. | ||
| state строка |
| Существует ли указанный LUN или нет. | ||
| use_exact_size булево добавлен в 20.11.0 от netapp.ontap |
| Это можно установить в "False", что округляет LUN >= 450гб. | ||
| use_rest строка | Значение по умолчанию: "авто" | REST API, если это поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае вернется к ZAPI. всегда -- всегда будет использовать REST API никогда -- всегда будет использовать ZAPI авто -- попытается использовать REST API | ||
| username строка | Это может быть учетная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Для получения дополнительной информации, пожалуйста, обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. Базовая аутентификация, используя имя пользователя и пароль, 2. Аутентификация по SSL-сертификату, используя файл ssl-сертификата клиента и, необязательно, файл приватного ключа. Для использования сертификата сертификат должен быть установлен в кластере ONTAP, и аутентификация по сертификату должна быть включена. псевдонимы: user | |||
| validate_certs boolean |
| Если установлено в 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/netapp/ontap/na_ontap_lun_module.html