Spec-Zone.ru › Ansible 2.9

na_ontap_volume – NetApp ONTAP управление томами

Новое в версии 2.6.

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Статус

Описание

  • Создание, удаление или изменение томов в NetApp ONTAP.

Требования

Ниже приведены требования к хосту, на котором будет выполняться этот модуль.

  • Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и выше
  • Ansible 2.6
  • Python2 netapp-lib (2017.10.30) или более поздняя версия. Установка с помощью ‘pip install netapp-lib’
  • Python3 netapp-lib (2018.11.13) или более поздняя версия. Установка с помощью ‘pip install netapp-lib’
  • Для включения http в кластере необходимо выполнить следующие команды ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
aggr_list
список
добавлен в 2.8
массив имён агрегатов, используемых для компонентов FlexGroup.
aggr_list_multiplier
целое число
добавлен в 2.8
Количество итераций по агрегатам, перечисленным в параметре aggr_list, при создании FlexGroup.
aggregate_name
строка
Имя агрегата, на котором должен существовать flexvol.
Требуется при state=present.
atime_update
логическое значение
добавлен в 2.8
    Варианты:
  • нет
  • да
Это параметр расширенного использования, значение по умолчанию True.
Если false, предотвращает обновление времени доступа к узлам каталога при чтении файла.
Это значение полезно для томов с очень большим объёмом чтений, так как предотвращает запись в файл узла каталога для тома, чтобы не мешать чтению из других файлов.
Это поле следует использовать с осторожностью.
То есть, используйте это поле, если заранее известно, что точное время доступа к узлам каталога не потребуется для файлов на этом томе.
auto_provision_as
строка
добавлен в 2.8
    Варианты:
  • flexgroup
Автоматически предоставляет том FlexGroup.
comment
строка
добавлен в 2.9
Устанавливает комментарий, связанный с томом.
efficiency_policy
строка
добавлен в 2.7
Позволяет задать политику эффективности хранения при создании тома.
encrypt
логическое значение
добавлен в 2.7
    Варианты:
  • нет ←
  • да
Включить или выключить шифрование тома.
from_name
строка
добавлен в 2.7
Имя существующего тома, который будет переименован в name.
hostname
строка / обязательно
Имя хоста или IP-адрес экземпляра ONTAP.
http_port
целое число
Замените порт по умолчанию (80 или 443) на этот порт
https
логическое значение
    Варианты:
  • нет ←
  • да
Включить и выключить https
is_infinite
логическое значение
    Варианты:
  • нет
  • да
Установите True, если том является бесконечным томом. Удаление бесконечного тома асинхронно.
is_online
логическое значение
    Варианты:
  • нет
  • да ←
Том онлайн или нет.
junction_path
строка
Путь соединения тома.
Для размонтирования используйте путь соединения ''.
language
строка
добавлен в 2.8
Язык для использования в томе
По умолчанию используется язык SVM
Возможные значения Язык
c POSIX
ar Арабский
cs Чешский
da Датский
de Немецкий
en Английский
en_us Английский (США)
es Испанский
fi Финский
fr Французский
he Иврит
hr Хорватский
hu Венгерский
it Итальянский
ja Японский euc-j
ja_v1 Японский euc-j
ja_jp.pck Японский PCK (sjis)
ja_jp.932 Японский cp932
ja_jp.pck_v2 Японский PCK (sjis)
ko Корейский
no Норвежский
nl Голландский
pl Польский
pt Португальский
ro Румынский
ru Русский
sk Словацкий
sl Словенский
sv Шведский
tr Турецкий
zh Упрощенный китайский
zh.gbk Упрощенный китайский (GBK)
zh_tw Традиционный китайский euc-tw
zh_tw.big5 Традиционный китайский Big 5
Для использования UTF-8 в качестве набора символов NFS добавьте '.UTF-8' к коду языка
name
строка / обязательно
Имя тома для управления.
nvfail_enabled
логическое значение
добавлен в 2.9
    Варианты:
  • нет
  • да
Если значение true, контроллер выполняет дополнительную работу при загрузке и перехвате, если обнаруживает потенциальную потерю данных в компонентах тома из-за сбоя NVRAM.
Компоненты тома будут помещены в специальное состояние 'in-nvfailed-state', в результате чего доступ к протоколу будет заблокирован.
Это приведет к завершению работы клиентских приложений и, таким образом, предотвратит доступ к устаревшим данным.
Чтобы выйти из этой ситуации, администратор должен вручную очистить 'in-nvfailed-state' в компонентах тома.
ontapi
целое число
Используемая версия API ontap
password
строка / обязательно
Пароль для указанного пользователя.

псевдонимы: pass
percent_snapshot_space
целое число
Количество места, резервируемого для снимков тома.
policy
строка
Имя политики экспорта.
qos_adaptive_policy_group
-
добавлен в 2.9
Указывает группу адаптивных политик QoS, которая должна быть установлена на томе.
qos_policy_group
-
добавлен в 2.9
Указывает группу политик QoS, которая должна быть установлена на томе.
size
целое число
Размер тома в (size_unit). Требуется при state=present.
size_unit
строка
    Варианты:
  • байты
  • б
  • кб
  • мб
  • гб ←
  • тб
  • пб
  • эб
  • зб
  • йб
Единица измерения, используемая для интерпретации параметра size.
snapdir_access
логическое значение
добавлен в 2.8
    Варианты:
  • нет
  • да
Это параметр расширенного использования, значение по умолчанию False.
Включить видимую папку '.snapshot', которая обычно присутствует в системных точках монтирования.
Это значение также включает доступ ко всем другим папкам '.snapshot' в томе.
snapshot_policy
строка
добавлен в 2.8
Имя политики снимка.
Имя политики по умолчанию 'default'.
space_guarantee
строка
    Варианты:
  • нет
  • файл
  • том
Стиль гарантии места для тома.
space_slo
string
added in 2.9
    Choices:
  • none
  • thick
  • semi-thick
Указывает тип SLO пространства для тома. Тип SLO пространства — это целевой уровень обслуживания для управления пространством для тома.
Значение space SLO используется для принудительного выполнения существующих настроек тома, чтобы обеспечить достаточное выделение пространства в агрегате для соответствия SLO пространства.
Этот параметр не поддерживается для бесконечных томов.
state
-
    Choices:
  • present ←
  • absent
Указывает, должен ли указанный том существовать или нет.
tiering_policy
string
added in 2.9
    Choices:
  • snapshot-only
  • auto
  • backup
  • none
Политика тиеринга, которая должна быть связана с томом.
Данная политика определяет, будут ли блоки тома распределены по уровню емкости.
Политика snapshot-only позволяет распределение только снимков тома, которые не связаны с активной файловой системой.
Политика auto позволяет распределение и снимков, и активных данных файловой системы пользователя на уровень емкости.
Политика backup для томов DP позволяет всем переданным блокам данных пользователя начинать с уровня емкости.
При значении none блоки тома не распределяются по уровню емкости.
Если значение не указано, том назначается по умолчанию snapshot-only.
time_out
integer
added in 2.8
Default:
180
Время ожидания создания, изменения или удаления flexGroup в секундах.
Прерывание запроса, если задача не завершена в заданное время.
При значении 0 запрос является асинхронным.
Значение по умолчанию составляет 3 минуты.
type
string
Тип тома: чтение-запись (RW) или защита данных (DP).
unix_permissions
string
added in 2.8
Биты разрешений Unix в восьмеричном или символичном формате.
Например, 0 эквивалентно ------------, 777 эквивалентно ---rwxrwxrwx, оба формата принимаются.
Допустимое восьмеричное значение находится в диапазоне от 0 до 777 включительно.
use_rest
string
    Choices:
  • Never
  • Always
  • Auto ←
Использование REST API, если оно поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае используется ZAPI.
Always — всегда использовать REST API.
Never — всегда использовать ZAPI.
Auto — попытка использования REST API.
username
string / required
Может быть учётной записью кластерного или SVM-уровня в зависимости от того, требуется ли API кластерного или SVM-уровня. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

псевдонимы: user
validate_certs
boolean
    Choices:
  • no
  • yes ←
Если установлено в no, сертификаты SSL не будут проверены.
Это должно быть установлено только в False на сайтах с собственными сертификатами.
volume_security_style
string
    Choices:
  • mixed ←
  • ntfs
  • unified
  • unix
Стиль безопасности, связанный с этим томом.
vserver
string / required
Имя vserver для использования.
vserver_dr_protection
string
added in 2.9
    Choices:
  • protected
  • unprotected
Указывает тип защиты для тома в настройке DR Vserver.
wait_for_completion
boolean
added in 2.8
    Choices:
  • no ←
  • yes
Установите этот параметр в 'true' для синхронного выполнения при создании (подождите, пока состояние тома не станет online).
Установите этот параметр в 'false' для асинхронного выполнения.
При асинхронном выполнении выполнение завершается сразу после отправки запроса, не проверяя состояние тома.

Примечания

Примечание

  • Модули с префиксом na_ontap разработаны для поддержки платформы хранилища ONTAP.

Примеры

- name: Create FlexVol
  na_ontap_volume:
    state: present
    name: ansibleVolume12
    is_infinite: False
    aggregate_name: ansible_aggr
    size: 100
    size_unit: mb
    space_guarantee: none
    tiering_policy: auto
    policy: default
    percent_snapshot_space: 60
    qos_policy_group: max_performance_gold
    vserver: ansibleVServer
    wait_for_completion: True
    space_slo: none
    nvfail_enabled: False
    comment: ansible created volume
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Volume Delete
  na_ontap_volume:
    state: absent
    name: ansibleVolume12
    aggregate_name: ansible_aggr
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Make FlexVol offline
  na_ontap_volume:
    state: present
    name: ansibleVolume
    is_infinite: False
    is_online: False
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create flexGroup volume manually
  na_ontap_volume:
    state: present
    name: ansibleVolume
    is_infinite: False
    aggr_list: "{{ aggr_list }}"
    aggr_list_multiplier: 2
    size: 200
    size_unit: mb
    space_guarantee: none
    policy: default
    vserver: "{{ vserver }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: False
    unix_permissions: 777
    snapshot_policy: default
    time_out: 0

- name: Create flexGroup volume auto provision as flex group
  na_ontap_volume:
    state: present
    name: ansibleVolume
    is_infinite: False
    auto_provision_as: flexgroup
    size: 200
    size_unit: mb
    space_guarantee: none
    policy: default
    vserver: "{{ vserver }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: False
    unix_permissions: 777
    snapshot_policy: default
    time_out: 0

- name: Create FlexVol with QoS adaptive
  na_ontap_volume:
    state: present
    name: ansibleVolume15
    is_infinite: False
    aggregate_name: ansible_aggr
    size: 100
    size_unit: gb
    space_guarantee: none
    policy: default
    percent_snapshot_space: 10
    qos_adaptive_policy_group: extreme
    vserver: ansibleVServer
    wait_for_completion: True
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify volume dr protection (vserver of the volume must be in a snapmirror relationship)
  na_ontap_volume:
    state: present
    name: ansibleVolume
    vserver_dr_protection: protected
    vserver: "{{ vserver }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: False

Статус

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

Авторы

  • Команда 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.9/modules/na_ontap_volume_module.html

Spec-Zone.ru

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