Spec-Zone.ru › Ansible 2.10

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

Spec-Zone.ru

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