Модуль netapp.ontap.na_ontap_lun – Управление LUN в 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_lun.

Добавлена в netapp.ontap 2.6.0

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

Описание

Создание, удаление и изменение размера LUN в NetApp ONTAP.

Требования

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

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

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
cert_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
comment строка добавлен в netapp.ontap 21.2.0	Необязательный описательный комментарий для LUN.
feature_flags словарь добавлен в netapp.ontap 20.5.0	Включить или отключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.
flexvol_name строка	Имя FlexVol, на котором должен существовать LUN. Требуется, если san_application_template отсутствует. Не разрешается, если san_application_template присутствует.
force_ontap_version строка добавлен в netapp.ontap 21.23.0	Переопределить версию кластера ONTAP при использовании REST. Поведение не определено, если версия не соответствует целевому кластеру. Это предоставляется как обходной путь, когда версия кластера не может быть прочитана из-за проблем с правами. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Это должно быть в формате 9.10 или 9.10.1, где каждый элемент — целое число. Когда `use_rest` установлено в авто, это может принудительно переключить использование ZAPI в зависимости от версии и возможностей платформы. Игнорируется с ZAPI.
force_remove логическое	Если «true», переопределить проверки, которые предотвращают уничтожение LUN, если он активен и смонтирован. Если «false», уничтожение активного и смонтированного LUN завершится неудачей. Варианты: `false` ← (по умолчанию) `true`
force_remove_fenced логическое	Если «true», переопределить проверки, которые предотвращают уничтожение LUN, пока он заблокирован. Если «false», попытка уничтожения заблокированного LUN завершится неудачей. По умолчанию, если не указано, значение «false». Этот параметр доступен в Data ONTAP 8.2 и более поздних версиях. Варианты: `false` `true`
force_resize логическое	Принудительное уменьшение размера. Это необходимо для уменьшения размера LUN, чтобы избежать случайного уменьшения размера LUN. Варианты: `false` `true`
from_name строка добавлен в netapp.ontap 20.12.0	Имя LUN, которое должно быть переименовано.
hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить стандартный порт (80 или 443) на этот порт
https логическое	Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу SSL-ключа клиента.
name строка / обязательно	Имя LUN для управления. Или имя группы LUN (имя тома) при использовании san_application_template.
ontapi целое число	Используемая версия API ontap
os_type псевдонимы: ostype строка	Тип операционной системы для LUN.
password псевдонимы: pass строка	Пароль для указанного пользователя.
qos_adaptive_policy_group строка добавлен в netapp.ontap 21.2.0	Группа адаптивной политики QoS, которая должна быть задана для LUN. Определяет измеримые целевые уровни обслуживания (SLO) и соглашения об уровне обслуживания (SLA), которые корректируются на основе выделенного или использованного пространства LUN. Требуется ONTAP 9.4 или более поздняя версия. При использовании REST qos_policy_group и qos_adaptive_policy_group обрабатываются как политика QoS.
qos_policy_group строка добавлен в netapp.ontap 20.12.0	Группа политики QoS, которая должна быть задана для LUN. При использовании REST qos_policy_group и qos_adaptive_policy_group обрабатываются как политика QoS.

qtree_name строка добавлено в netapp.ontap 22.8.0	Указывает имя Qtree, содержащее новый LUN. Не разрешено, если присутствует san_application_template. Поддерживается только с REST.
san_application_template словарь добавлено в netapp.ontap 20.12.0	Дополнительные параметры при использовании REST API приложения/приложений для создания LUN. Модуль по умолчанию использует ZAPI и переключается на REST, если присутствует san_application_template. Создает один или несколько LUN (и соответствующий том по мере необходимости). Операции на уровне LUN поддерживаются; для них требуется знать короткое имя LUN. Требуется ONTAP 9.8 или выше. Модуль частично поддерживает ONTAP 9.7 для операций создания и удаления, но не для модификации (ограничения API).
exclude_aggregates список / элементы=строка добавлено в netapp.ontap 21.7.0	Список имен агрегатов, которые нужно исключить при создании тома. Требуется ONTAP 9.9.1 GA или выше.
igroup_name строка	Имя группы инициаторов, через которое будет осуществляться доступ к содержимому данного приложения.
lun_count целое число	Количество LUN в компоненте приложения (от 1 до 32).
name строка / обязательно	Имя SAN-приложения.
protection_type словарь	Политика создания моментальных снимков для тома, поддерживающего LUN.
local_policy строка	Политика копирования моментальных снимков для тома.
scope строка добавлено в netapp.ontap 21.2.0	Указывает, идентифицирует ли имя верхнего уровня один LUN или группу LUN (приложение). По умолчанию модуль пытается сделать правильный выбор, но может сообщать дополнительные предупреждения. Для преобразования существующего тома в смарт-контейнер необходимо задать scope в «application». Модуль сообщает об ошибке, когда используется «lun» или «application», и желаемое действие не может быть выполнено. Модуль выдает предупреждения, когда используется значение по умолчанию «auto», и существует неоднозначность относительно желаемых действий. Варианты: `"application"` `"auto"` ← (по умолчанию) `"lun"`
storage_service строка	Уровень обслуживания производительности (PSL) для этого тома Варианты: `"value"` `"performance"` `"extreme"`
tiering словарь	Политика тиеринга в облаке.
control строка	Правила размещения тиеринга хранения для контейнера. Варианты: `"required"` `"best_effort"` `"disallowed"`
object_stores список / элементы=строка	Список имен хранилищ объектов для тиеринга.
policy строка	Политика тиеринга в облаке. Варианты: `"all"` `"auto"` `"none"` `"snapshot-only"`
total_size целое число добавлено в netapp.ontap 21.1.0	Общий размер компонента приложения, распределенный между LUN-членами в `total_size_unit`. Рекомендуется, когда `lun_count` присутствует. Требуется, когда `lun_count` присутствует и больше 1. Примечание: если lun_count равен 1, а total_size отсутствует, используется размер для обеспечения обратной совместимости.
total_size_unit строка добавлено в netapp.ontap 21.1.0	Единица измерения, используемая для интерпретации параметра total_size. По умолчанию используется size_unit, если не указано иначе. Варианты: `"bytes"` `"b"` `"kb"` `"mb"` `"gb"` `"tb"` `"pb"` `"eb"` `"zb"` `"yb"`
use_san_application булево	Использовать ли REST/API приложения/приложений для создания LUN? По умолчанию значение true, если присутствует любой другой параметр. Варианты: `false` `true` ← (по умолчанию)
size целое число	Размер LUN в `size_unit`. Обязательно при создании одного LUN, если шаблон приложения не используется.

size_unit string	Единица измерения параметра размера. Варианты: `"bytes"` `"b"` `"kb"` `"mb"` `"gb"` ← (по умолчанию) `"tb"` `"pb"` `"eb"` `"zb"` `"yb"`
space_allocation boolean добавлен в netapp.ontap 2.7.0	Включает поддержку функций тонкого резервирования SCSI. Если хост и файловая система не поддерживают эту функцию, не включайте её. Варианты: `false` `true`
space_reserve boolean	Это можно установить в «false», что создаст LUN без резервирования места. Варианты: `false` `true` ← (по умолчанию)
state string	Определяет, должен ли указанный LUN существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_exact_size boolean добавлен в netapp.ontap 20.11.0	Это можно установить в «false», что округлить LUN >= 450гб. Варианты: `false` `true` ← (по умолчанию)
use_rest string	Использовать REST или ZAPI. always – всегда использовать REST API, если модуль поддерживает REST. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если параметр модуля не поддерживается в REST. never – всегда использовать ZAPI, если модуль поддерживает ZAPI. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI. auto – попытаться использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. Возвращается к ZAPI в противном случае. По умолчанию: `"auto"`
username псевдонимы: user string	Может быть учётной записью уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации базовая аутентификация с использованием имени пользователя и пароля, аутентификация с помощью сертификата SSL с использованием файла сертификата клиента ssl и, необязательно, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а также должна быть включена аутентификация по сертификатам.
validate_certs boolean	Если установлено `no`, сертификаты SSL не будут проверены. Это должно быть установлено в `False` только на сайтах под собственным управлением, использующих самозаверенные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vserver string / обязательный	Имя vserver для использования.

Примечания

Примечание

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

Примеры

- name: Create LUN
  netapp.ontap.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
  netapp.ontap.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
  netapp.ontap.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
      exclude_aggregates: aggr0
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Convert existing volume to SAN application
  tags: create
  netapp.ontap.na_ontap_lun:
    state: present
    name: someVolume
    size: 22
    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
      scope: application
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

Команда NetApp Ansible (@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_lun_module.html