Spec-Zone.ru › Ansible 2.11

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
строка
    Варианты:
  • present ←
  • absent
Существует ли указанный 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API