Spec-Zone.ru › Ansible 2.9

netapp_e_volume – Управление томами NetApp E-серии (стандартными и тоннами)

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Обзор

  • Создание или удаление томов (стандартных и тонких) для хранилищ NetApp E/EF-серии.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
api_password
строка / обязательно
Пароль для аутентификации с SANtricity Web Services Proxy или Embedded Web Services API.
api_url
строка / обязательно
URL SANtricity Web Services Proxy или Embedded Web Services API. Пример https://prod-1.wahoo.acme.com/devmgr/v2
api_username
строка / обязательно
Имя пользователя для аутентификации с SANtricity Web Services Proxy или Embedded Web Services API.
cache_without_batteries
логическое значение
добавлено в 2.9
    Варианты:
  • нет ←
  • да
Указывает, следует ли использовать кэширование без резервного питания.
Предупреждение, cache_without_batteries==true и система хранения теряет питание, и нет резервного питания, данные будут потеряны!
data_assurance_enabled
логическое значение
    Варианты:
  • нет ←
  • да
Определяет, следует ли включить гарантию данных (Data Assurance, DA) для тома.
Доступно только при создании нового тома и на хранилище с дисками, поддерживающими функцию DA.
initialization_timeout
целое число
добавлено в 2.9
Продолжительность в секундах, прежде чем операция wait_for_initialization завершится.
wait_for_initialization==True чтобы операция имела какой-либо эффект на операции модуля.
metadata
словарь
добавлено в 2.8
Словарь, содержащий метаданные для использования, пользователя, местоположения и т.д. тома (словарь произвольно определяется для того, что пользователь считает полезным).
Если workload_name существует на массиве хранения, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения обновит все связанные тома!)
workload_name должно быть указано при определении metadata.
name
- / обязательно
Имя тома для управления.
owning_controller
-
добавлено в 2.9
    Варианты:
  • A
  • B
Указывает, какой контроллер будет основным владельцем тома.
Если не указать, контроллер выберет владение.
read_ahead_enable
логическое значение
добавлено в 2.8
    Варианты:
  • нет
  • да ←
Указывает, включено ли автоматическое кэширование предварительного чтения.
Этот параметр не влияет на тонкопропорциональные тома, так как архитектура тонких томов не может извлечь выгоды из кэширования предварительного чтения.
read_cache_enable
логическое значение
добавлено в 2.8
    Варианты:
  • нет
  • да ←
Указывает, следует ли включить кэширование чтения для тома.
segment_size_kb
-
Значение по умолчанию:
"128"
Размер сегмента тома
Все значения в кибибайтах.
Некоторые распространённые значения включают '8', '16', '32', '64', '128', '256' и '512', но варианты зависят от системы.
Получите окончательный список системы из netapp_e_facts в разделе segment_sizes.
Если хранилище является raidDiskPool, размер сегмента должен быть 128 КБ.
Миграции размера сегмента в этом модуле не допускаются
size
- / обязательно
Требуется только при state=='present'.
Размер тома в size_unit.
Размер виртуального тома в случае тонкого тома в size_unit.
Максимальный размер виртуального тома тонкопропорционального тома составляет 256 ТБ; однако могут существовать другие ограничения на уровне ОС.
size_unit
-
    Варианты:
  • байты
  • байт
  • КБ
  • МБ
  • ГБ ←
  • ТБ
  • ПБ
  • ЭБ
  • ЗБ
  • ИБ
Единица измерения, используемая для интерпретации параметра размера.
ssd_cache_enabled
логическое значение
    Варианты:
  • нет ←
  • да
Включать ли существующий SSD-кеш на томе (не удаётся, если SSD-кеш не определён).
Значение по умолчанию — игнорировать существующее значение SSD-кеша.
ssid
строка
Значение по умолчанию:
1
Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива.
state
- / обязательно
    Варианты:
  • present
  • absent
Следует ли создать указанный том.
storage_pool_name
-
Требуется только при запросе state=='present'.
Имя пула хранения, в котором должен находиться том.
thin_provision
логическое значение
    Варианты:
  • нет ←
  • да
Следует ли тонкопропорционально предоставить том.
Тонкие тома могут быть созданы только при raid_level=="raidDiskPool".
Как правило, использование тонкого распределения не рекомендуется из-за влияния на производительность.
thin_volume_expansion_policy
-
добавлено в 2.8
    Варианты:
  • automatic ←
  • manual
Это политика расширения тонкого тома.
Если thin_volume_expansion_policy=="automatic" и thin_volume_growth_alert_threshold превышено, thin_volume_max_repo_size будет автоматически расширено.
Если thin_volume_expansion_policy=="manual" и thin_volume_growth_alert_threshold превышено, система хранения будет ожидать ручного вмешательства.
Политика тонкого расширения тома не может быть изменена на существующих тонких томах в этом модуле.
Как правило, следует использовать thin_volume_expansion_policy=="automatic".
thin_volume_growth_alert_threshold
-
добавлено в 2.8
Значение по умолчанию:
95
Это порог использования репозитория тонкого тома (в процентах).
Когда процент используемого пространства хранилища от максимального размера репозитория превышает это значение, будет выдан предупреждающий сигнал, и будет выполнена политика thin_volume_expansion_policy.
Значения должны быть от 10 до 99 включительно.
thin_volume_max_repo_size
-
Значение по умолчанию:
"то же, что и размер (в size_unit)"
Это максимальный объём, который будет разрешено расширить репозиторий тонкого тома.
Имеет значение только при thin_volume_expansion_policy=="automatic".
Когда процент thin_volume_repo_size от thin_volume_max_repo_size превышает thin_volume_growth_alert_threshold, будет выведено предупреждение, и массив хранения выполнит политику thin_volume_expansion_policy.
Операции расширения при thin_volume_expansion_policy=="automatic" увеличивают максимальный размер репозитория.
thin_volume_repo_size
-
Это значение (в единицах size_unit) задаёт выделенное пространство для репозитория тонкопропорционального тома.
Начальное значение должно составлять от 4 ГБ до 256 ГБ с шагом 4 ГБ.
Во время операций расширения увеличение должно составлять от 4 ГБ до 256 ГБ с шагом 4 ГБ.
Этот параметр не влияет на расширение, если thin_volume_expansion_policy=="automatic".
Как правило, следует использовать thin_volume_expansion_policy=="automatic".
validate_certs
boolean
    Choices:
  • no
  • да ←
Нужно ли проверять сертификаты https?
wait_for_initialization
boolean
добавлен в 2.8
    Choices:
  • нет ←
  • да
Принудительно заставляет модуль ждать завершения операций расширения, прежде чем продолжить.
workload_name
-
добавлен в 2.8
Метка для рабочей нагрузки, определённой метаданными.
При указании workload_name и metadata, определённая рабочая нагрузка будет добавлена в массив хранилищ.
Если workload_name существует в массиве хранилищ, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения обновит все связанные тома!)
Существующие рабочие нагрузки можно получить с помощью netapp_e_facts.
write_cache_enable
boolean
добавлен в 2.8
    Choices:
  • нет
  • да ←
Указывает, следует ли включить кэширование записи обратной записи для тома.

Примечания

Примечание

  • Модули Ansible E-Series требуют наличия экземпляра прокси-сервиса веб-служб (WSP) для управления системой хранения или системы хранения E-Series, которая поддерживает встроенный API веб-служб.
  • Встроенные веб-службы в настоящее время доступны на моделях E2800, E5700, EF570 и более новых моделях оборудования.
  • netapp_e_storage_system может использоваться для настройки систем, управляемых экземпляром WSP.

Примеры

- name: Create simple volume with workload tags (volume meta data)
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume
    storage_pool_name: storage_pool
    size: 300
    size_unit: gb
    workload_name: volume_tag
    metadata:
      key1: value1
      key2: value2
- name: Create a thin volume
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume1
    storage_pool_name: storage_pool
    size: 131072
    size_unit: gb
    thin_provision: true
    thin_volume_repo_size: 32
    thin_volume_max_repo_size: 1024
- name: Expand thin volume's virtual size
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume1
    storage_pool_name: storage_pool
    size: 262144
    size_unit: gb
    thin_provision: true
    thin_volume_repo_size: 32
    thin_volume_max_repo_size: 1024
- name: Expand thin volume's maximum repository size
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume1
    storage_pool_name: storage_pool
    size: 262144
    size_unit: gb
    thin_provision: true
    thin_volume_repo_size: 32
    thin_volume_max_repo_size: 2048
- name: Delete volume
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: absent
    name: volume

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ Возвращаемое значение Описание
msg
строка
всегда
Состояние тома

Пример:
Стандартный том [workload_vol_1] был создан.


Статус

  • Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
  • Данный модуль поддерживается сообществом Ansible. [community]

Авторы

  • Kevin Hulquest (@hulquest)
  • Nathan Swartz (@ndswartz)

Подсказка

Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/netapp_e_volume_module.html

Spec-Zone.ru

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