netapp_eseries.santricity.netapp_e_volume – NetApp E-Series управление хранилищами (стандартными и тонким)
Примечание
Этот плагин входит в коллекцию netapp_eseries.santricity (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install netapp_eseries.santricity
Для использования в плейбуке укажите: netapp_eseries.santricity.netapp_e_volume
Введено в версии 2.2: of netapp_eseries.santricity
Обзор
- Создание или удаление томов (стандартных и тонких) для хранилищ 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 модуля netapp_eseries.santricity |
| Указывает, следует ли использовать кэширование без резервного источника питания. Предупреждение, если cache_without_batteries==true и система хранения теряет питание, а резервного источника питания нет, данные будут потеряны! |
| data_assurance_enabled булево |
| Определяет, следует ли включить обеспечение целостности данных (DA) для тома. Доступно только при создании нового тома и на пуле хранения с дисками, поддерживающими функцию DA. |
| initialization_timeout целое число добавлено в 2.9 модуля netapp_eseries.santricity | Продолжительность в секундах, по истечении которой операция wait_for_initialization завершится.
wait_for_initialization==True для влияния на операции модуля. | |
| metadata словарь добавлено в 2.8 модуля netapp_eseries.santricity | Словарь, содержащий метаданные для использования, пользователя, местоположения и т. д. тома (словарь произвольно определяется для удобства пользователя). Если на массиве хранения существует workload_name, но метаданные отличаются, то определение рабочей нагрузки будет обновлено. (Изменения обновят все связанные тома!)
workload_name должен быть указан при определении metadata. | |
| name строка / обязательно | Имя тома для управления. | |
| owning_controller строка добавлено в 2.9 модуля netapp_eseries.santricity |
| Указывает, какой контроллер будет основным владельцем тома. Если не указывать, контроллер выберет владение. |
| read_ahead_enable булево добавлено в 2.8 модуля netapp_eseries.santricity |
| Указывает, включено ли автоматическое кэширование предварительной выборки. Этот параметр не влияет на тома с раздробленной выделенной емкостью, так как архитектура томов с раздробленной выделенной емкостью не может извлечь выгоду из кэширования предварительной выборки. |
| read_cache_enable булево добавлено в 2.8 модуля netapp_eseries.santricity |
| Указывает, следует ли включить кэширование чтения для тома. |
| segment_size_kb целое число | Значение по умолчанию: "128" | Размер сегмента тома Все значения в кибибайтах. Некоторые распространенные значения включают '8', '16', '32', '64', '128', '256' и '512', но варианты зависят от системы. Получите окончательный список из системы из netapp_eseries.santricity.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 строка / обязательно |
| Должен ли существовать указанный том |
| storage_pool_name строка | Требуется только при запросе state=='present'. Имя пула хранения, в котором должен находиться том. | |
| thin_provision булево |
| Следует ли выделять емкость тома с раздробленной выделенной емкостью. Тома с раздробленной выделенной емкостью могут создаваться только при raid_level=="raidDiskPool". В целом, использование раздробленной выделенной емкости не рекомендуется из-за влияния на производительность. |
| thin_volume_expansion_policy строка добавлено в 2.8 модуля netapp_eseries.santricity |
| Это политика расширения тома с раздробленной выделенной емкостью. Если 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 модуля netapp_eseries.santricity | Значение по умолчанию: 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_unit) | |
| 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? |
| wait_for_initialization булево добавлено в 2.8 модуля netapp_eseries.santricity |
| Принудительно заставляет модуль ждать завершения операций расширения перед продолжением. |
| workload_name строка добавлено в 2.8 модуля netapp_eseries.santricity | Метка для рабочей нагрузки, определенной в метаданных. Если указаны workload_name и metadata, то определенная рабочая нагрузка будет добавлена в массив хранения. Если на массиве хранения существует workload_name, но метаданные отличаются, то определение рабочей нагрузки будет обновлено. (Изменения обновят все связанные тома!) Существующие рабочие нагрузки можно получить с помощью netapp_eseries.santricity.netapp_e_facts. | |
| write_cache_enable булево добавлено в 2.8 модуля netapp_eseries.santricity |
| Указывает, следует ли включить кэширование записи для тома. |
Примечания
Примечание
- Модули Ansible E-Series требуют наличия экземпляра веб-сервисного прокси (WSP) для управления хранилищем или системы хранения E-Series, поддерживающей встроенный API веб-служб.
- Встроенные веб-службы доступны в настоящее время на моделях E2800, E5700, EF570 и более новых аппаратных моделях.
- netapp_eseries.santricity.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] был создан. |
Авторы
- Kevin Hulquest (@hulquest)
- 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/netapp_e_volume_module.html
