netapp_eseries.santricity.na_santricity_volume – NetApp E-Series управление томами хранения (стандартные и тонкие)
Примечание
Этот плагин является частью коллекции netapp_eseries.santricity (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install netapp_eseries.santricity
Чтобы использовать его в книге задач, укажите: netapp_eseries.santricity.na_santricity_volume
Описание
- Создание или удаление томов (стандартных и тонких) для хранилищ 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:8443/devmgr/v2 | |
| api_username строка / обязательно | Имя пользователя для аутентификации с SANtricity Web Services Proxy или Embedded Web Services API. | |
| cache_without_batteries логическое значение |
| Указывает, следует ли использовать кэширование без резервного копирования батарей. Предупреждение, cache_without_batteries==true и система хранения данных потеряет питание, и резервного копирования батарей нет, данные будут потеряны! |
| data_assurance_enabled логическое значение |
| Определяет, следует ли включить гарантию данных (DA) для тома. Доступно только при создании нового тома и на пуле хранения с дисками, поддерживающими функциональность DA. |
| name строка / обязательно | Имя тома для управления. | |
| owning_controller строка |
| Указывает, какой контроллер будет основным владельцем тома. Если не указано, контроллер выберет владение. |
| read_ahead_enable логическое значение |
| Указывает, включено ли автоматическое кэширование чтения вперёд. Этот параметр не влияет на тонко выделенные тома, поскольку архитектура тонких томов не может воспользоваться кэшированием чтения вперёд. |
| read_cache_enable логическое значение |
| Указывает, следует ли включить кэширование чтения для тома. |
| segment_size_kb целое число | Значение по умолчанию: 128 | Размер сегмента тома Все значения в кибибайтах. Некоторые распространённые значения: 8, 16, 32, 64, 128, 256 и 512, но варианты зависят от системы. Получите окончательный список системы из netapp_eseries.santricity.na_santricity_facts в разделе segment_sizes. Если пул хранения — raidDiskPool, размер сегмента должен быть 128 кб. Миграции размеров сегментов в этом модуле не допускаются |
| size число с плавающей точкой / обязательно | Требуется только при state=="present". Размер тома в единицах size_unit. Размер виртуального тома в случае тонкого тома в единицах size_unit. Максимальный размер виртуального тома тонко выделенного тома составляет 256 ТБ; однако могут существовать другие ограничения на уровне операционной системы. | |
| size_unit строка |
| Единицы измерения, используемые для интерпретации параметра размера. |
| ssd_cache_enabled логическое значение |
| Следует ли включить существующий кэш SSD на томе (ошибка, если кэш SSD не определён) Значение по умолчанию — игнорировать существующую настройку кэша SSD. |
| ssid строка | Значение по умолчанию: 1 | Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива. |
| state строка |
| Должен ли существовать указанный том |
| storage_pool_name строка | Требуется только при запросе state=="present". Имя пула хранения, в котором должен находиться том. | |
| thin_provision логическое значение |
| Следует ли тонко выделять том. Тонкие тома могут быть созданы только при raid_level=="raidDiskPool". В целом, использование тонкой выделки не рекомендуется из-за влияния на производительность. |
| thin_volume_expansion_policy строка |
| Это политика расширения тонкого тома. При 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 целое число | Значение по умолчанию: 95 | Это порог использования репозитория тонкого тома (в процентах). Когда процент используемого пространства максимального размера репозитория превышает это значение, будет выдано предупреждение, и будет выполнена политика thin_volume_expansion_policy. Значения должны быть от 10 до 99 включительно. |
| thin_volume_max_repo_size число с плавающей точкой | Это максимальный размер, до которого будет разрешено расширяться репозиторию тонкого тома. Значимо только при 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" увеличат максимальный размер репозитория. Значение по умолчанию будет таким же, как у size. | |
| thin_volume_repo_size целое число | Это значение (в единицах size_unit) устанавливает выделенное пространство для репозитория тонко выделенного тома. Начальное значение должно быть от 4 ГБ до 256 ГБ с шагом 4 ГБ. Во время операций расширения увеличение должно составлять от 4 ГБ до 256 ГБ с шагом 4 ГБ. Этот параметр не влияет на расширение при thin_volume_expansion_policy=="automatic". Как правило, следует всегда использовать thin_volume_expansion_policy=="automatic". | |
| validate_certs логическое значение |
| Следует ли проверять сертификаты https? |
| volume_metadata словарь | Словарь, содержащий метаданные самого тома. Ключ словаря не может быть длиннее 14 символов Значение словаря не может быть длиннее 240 символов | |
| wait_for_initialization логическое значение |
| Принудительно заставляет модуль ожидать завершения операций расширения перед продолжением. |
| workload_metadata словарь | Словарь, содержащий метаданные об использовании, пользователе, местоположении и т. д. тома (словарь произвольно определяется для того, что пользователь считает полезным) Если workload_name существует в массиве хранения, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения обновят все связанные тома!)
workload_name должен быть указан при определении metadata. Ключ словаря не может быть длиннее 16 символов Значение словаря не может быть длиннее 60 символов псевдонимы: metadata | |
| workload_name строка | Метка рабочей нагрузки, определённой метаданными. При указании workload_name и metadata, определённая рабочая нагрузка будет добавлена в массив хранения. Если workload_name существует в массиве хранения, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения обновят все связанные тома!) Существующие рабочие нагрузки можно получить с помощью netapp_eseries.santricity.na_santricity_facts. | |
| write_cache_enable логическое значение |
| Указывает, следует ли включить кэширование записи для тома. |
Примечания
Примечание
- Модули Ansible E-Series требуют либо наличие экземпляра Web Services Proxy (WSP) для управления системой хранения, либо систему хранения E-Series, поддерживающую Embedded Web Services API.
- Embedded Web Services в настоящее время доступен на моделях E2800, E5700, EF570 и более новых моделях.
- netapp_eseries.santricity.netapp_e_storage_system может использоваться для настройки систем, управляемых экземпляром WSP.
Примеры
- name: Create simple volume with workload tags (volume meta data)
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
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
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
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
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
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
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
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
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
state: absent
name: volume
Возвращаемые значения
Общие возвращаемые значения документированы здесь, ниже представлены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| msg строка | всегда | Состояние объёма Пример: Стандартный объём [workload_vol_1] был создан. |
Авторы
- Nathan Swartz (@ndswartz)
© 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_eseries/santricity/na_santricity_volume_module.html
