Spec-Zone.ru › Ansible 2.8

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
boolean
добавлено в 2.8
    Варианты:
  • нет
  • да
Это расширенный параметр, значение по умолчанию - True.
Если false, предотвращает обновление времени доступа к inode при чтении файла.
Это значение полезно для объёмов с очень высоким трафиком чтения, так как предотвращает конфликт записи в файл inode объёма с чтением из других файлов.
Этот параметр следует использовать с осторожностью.
То есть, используйте этот параметр, если заранее известно, что корректное время доступа к inode для файлов на этом объёме не потребуется.
auto_provision_as
-
добавлено в 2.8
    Варианты:
  • flexgroup
Автоматически создавать объём FlexGroup.
efficiency_policy
-
добавлено в 2.7
Позволяет установить политику эффективности хранения при создании объёма.
encrypt
boolean
добавлено в 2.7
    Варианты:
  • нет ←
  • да
Включить шифрование объёма.
from_name
-
добавлено в 2.7
Имя существующего объёма, который будет переименован в name.
hostname
string / обязательно
Имя хоста или IP-адрес экземпляра ONTAP.
http_port
integer
Переопределить порт по умолчанию (80 или 443) на этот порт
https
boolean
    Варианты:
  • нет ←
  • да
Включить/выключить https
is_infinite
boolean
    Варианты:
  • нет
  • да
Установить True, если объём - Бесконечный объём. Удаление бесконечного объёма асинхронно.
is_online
boolean
    Варианты:
  • нет
  • да ←
Указанный объём онлайн или нет.
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
- / обязательно
Имя объёма для управления.
ontapi
integer
Версия API ontap для использования
password
string / обязательно
Пароль для указанного пользователя.

псевдонимы: pass
percent_snapshot_space
-
Процент пространства, резервируемого для снимков копий объёма.
policy
-
Имя политики экспорта.
size
-
Размер объёма в (size_unit). Требуется, когда state=present.
size_unit
-
    Варианты:
  • байты
  • б
  • кб
  • мб
  • гб ←
  • тб
  • пб
  • эб
  • зб
  • йб
Единица измерения, используемая для интерпретации параметра size.
snapdir_access
boolean
добавлено в 2.8
    Варианты:
  • нет
  • да
Это расширенный параметр, значение по умолчанию - False.
Включает видимую директорию '.snapshot', которая обычно присутствует в точках монтирования системы.
Это значение также включает доступ ко всем другим директориям '.snapshot' в объёме.
snapshot_policy
-
добавлено в 2.8
Имя политики снимков.
Имя политики по умолчанию - 'default'.
space_guarantee
-
    Варианты:
  • none
  • file
  • volume
Стиль гарантии места для объёма.
state
-
    Варианты:
  • present ←
  • absent
Должен ли указанный объём существовать или нет.
time_out
-
добавлено в 2.8
По умолчанию:
180
Время ожидания создания, изменения или удаления flexGroup в секундах.
Возвращает ошибку, если задача не завершена в определённое время.
Если 0, запрос асинхронный.
По умолчанию 3 минуты.
type
-
Тип объёма: чтение-запись (RW) или защита данных (DP).
unix_permissions
-
добавлено в 2.8
Биты разрешений Unix в восьмеричном или символьном формате.
Например, 0 эквивалентно ------------, 777 эквивалентно ---rwxrwxrwx, оба формата принимаются.
Допустимое восьмеричное значение от 0 до 777 включительно.
username
string / обязательно
Это может быть учётная запись на уровне кластера или SVM, в зависимости от того, нужен ли API на уровне кластера или SVM. Для получения дополнительной информации см. документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

псевдонимы: user
validate_certs
boolean
    Выбираемые значения:
  • no
  • да ←
Если установлено значение no, сертификаты SSL не будут проверяться.
Это значение следует устанавливать только для False сайтов, используемых на собственных сайтах, которые используют самоподписанные сертификаты.
volume_security_style
-
    Выбираемые значения:
  • смешанный ←
  • ntfs
  • unified
  • unix
Стиль безопасности, связанный с этим томом.
vserver
- / обязательно
Имя vserver для использования.
wait_for_completion
boolean
добавлен в 2.8
    Выбираемые значения:
  • нет ←
  • да
Установите этот параметр в 'true' для синхронного выполнения во время создания (дождитесь, пока состояние тома не станет онлайн)
Установите этот параметр в '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
    policy: default
    percent_snapshot_space: 60
    vserver: ansibleVServer
    wait_for_completion: True
    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

Статус

  • Не гарантируется обратная совместимость данного модуля. [превью]
  • Этот модуль поддерживается партнером 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.8/modules/na_ontap_volume_module.html

Spec-Zone.ru

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