Spec-Zone.ru › Ansible

netapp.ontap.na_ontap_svm модуль – NetApp ONTAP SVM

Примечание

Этот модуль является частью коллекции netapp.ontap (версия 22.12.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля требуются дополнительные условия, см. Требования для получения подробностей.

Для использования в playbook укажите: netapp.ontap.na_ontap_svm.

Новое в netapp.ontap 2.6.0

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры

Обзор

  • Создание, изменение или удаление SVM на NetApp ONTAP

Требования

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

  • Ansible 2.9 или более поздняя версия - рекомендуется версия 2.12 или более поздняя.
  • Python3 - рекомендуется версия 3.9 или более поздняя.
  • При использовании ZAPI, netapp-lib 2018.11.13 или более поздняя версия (устанавливается с помощью «pip install netapp-lib»), сильно рекомендуется netapp-lib 2020.3.12, так как она обеспечивает лучшую обработку ошибок при подключении.
  • физическая или виртуальная кластеризованная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и более поздние версии, поддержка REST требует ONTAP 9.6 или более поздней версии

Параметры

Параметр

Комментарии

admin_state

строка

добавлено в netapp.ontap 21.15.0

при создании SVM, она будет в активном состоянии, если не указано иное.

Это игнорируется в ZAPI.

Варианты:

  • "running"
  • "stopped"

aggr_list

список / элементы=строка

Список агрегатов, назначенных для операций с томом.

Эти агрегаты могут быть объединёнными для использования с другими серверами V.

При указании в рамках vserver-create это поле представляет собой список агрегатов, назначенных серверу V для операций с томом.

При вызове vserver-get-iter это вернёт список серверов V, которые имеют любой из агрегатов, указанных в списке aggr.

allowed_protocols

список / элементы=строка

Разрешённые протоколы.

Это поле представляет список протоколов, разрешённых на сервере V.

При изменении это поле должно содержать существующий список вместе с новым списком протоколов, чтобы добавить его, чтобы предотвратить нарушения данных.

Возможные значения

nfs Протокол NFS,

cifs Протокол CIFS,

fcp Протокол FCP,

iscsi Протокол iSCSI,

ndmp Протокол NDMP,

http Протокол HTTP - только ZAPI,

nvme Протокол NVMe

cert_filepath

строка

добавлено в netapp.ontap 20.6.0

путь к файлу сертификата клиента SSL (.pem).

не поддерживается с python 2.6.

comment

строка

добавлено в netapp.ontap 2.8.0

При указании в рамках vserver-create это поле представляет комментарий, связанный с сервером V.

При вызове vserver-get-iter это вернёт список соответствующих серверов V.

feature_flags

словарь

добавлено в netapp.ontap 20.5.0

Включить или выключить новую функцию.

Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.

force_ontap_version

строка

добавлено в netapp.ontap 21.23.0

Переопределить версию кластера ONTAP при использовании REST.

Поведение не определено, если версия не соответствует целевому кластеру.

Это предоставлено как обходное решение, когда версия кластера не может быть прочитана из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues.

Это должно быть в формате 9.10 или 9.10.1, причём каждый элемент - целое число.

Когда use_rest установлено в auto, это может принудительно переключиться на ZAPI на основе версии и возможностей платформы.

Игнорируется с ZAPI.

from_name

строка

добавлено в netapp.ontap 2.7.0

Имя SVM, которое нужно переименовать

hostname

строка / обязательно

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

целое число

Переопределить порт по умолчанию (80 или 443) с этим портом

https

булево

Включить и выключить https.

Игнорируется при использовании REST, так как поддерживается только https.

Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL.

Варианты:

  • false ← (по умолчанию)
  • true

ignore_rest_unsupported_options

булево

добавлено в netapp.ontap 21.10.0

Если истинно, игнорировать root_volume, root_volume_aggregate, root_volume_security_style параметры, если целевой объект поддерживает REST.

Игнорируется, когда use_rest установлено в never.

Варианты:

  • false ← (по умолчанию)
  • true

ipspace

строка

добавлено в netapp.ontap 2.7.0

Имя пространства IP

Не может быть изменено после создания.

key_filepath

строка

добавлено в netapp.ontap 20.6.0

путь к файлу закрытого ключа клиента SSL.

language

строка

добавлено в netapp.ontap 2.7.0

Язык, используемый для SVM

По умолчанию C.UTF-8

Возможные значения Язык

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

utf8mb4

Большинство значений принимают суффикс .utf_8, например fr.utf_8

max_volumes

строка

добавлено в netapp.ontap 21.12.0

Максимальное количество томов, которые могут быть созданы на сервере V.

Ожидается целое число или unlimited.

name

aliases: vserver

строка / обязательно

Имя SVM для управления.

vserver — удобный псевдоним при использовании module_defaults.

ontapi

целое число

Версия ontap api для использования

password

aliases: pass

строка

Пароль для указанного пользователя.

root_volume

строка

Корневой том SVM.

Не может быть изменён после создания.

root_volume_aggregate

строка

Агрегат, на котором будет создан корневой том.

Не может быть изменён после создания.

root_volume_security_style

строка

Стиль безопасности корневого тома.

При указании в рамках vserver-create, это поле представляет стиль безопасности корневого тома Vserver.

При указании в рамках вызова vserver-get-iter, это вернёт список соответствующих Vservers.

Стиль безопасности «unified», применяемый только к Infinite Volumes, не может быть применён к корневому тому Vserver.

Не может быть изменён после создания.

Варианты:

  • "unix"
  • "ntfs"
  • "mixed"
  • "unified"

services

словарь

добавлен в netapp.ontap 21.10.0

Включенные протоколы, доступны только с REST.

Сервис будет запущен при необходимости. Может потребоваться действительная лицензия.

enabled не поддерживается для CIFS, для его включения используйте na_ontap_cifs_server.

Если сервис отсутствует, он остаётся без изменений.

cifs

словарь

Сервис протокола CIFS

allowed

булево

Если true, администратор SVM может управлять службой CIFS. Если false, только администратор кластера может управлять службой.

Варианты:

  • false
  • true

fcp

словарь

Сервис протокола FCP

allowed

булево

Если true, администратор SVM может управлять службой FCP. Если false, только администратор кластера может управлять службой.

Варианты:

  • false
  • true

enabled

булево

Если разрешено, установка в true включает службу FCP.

Варианты:

  • false
  • true

iscsi

словарь

Сервис протокола iSCSI

allowed

булево

Если true, администратор SVM может управлять службой iSCSI. Если false, только администратор кластера может управлять службой.

Варианты:

  • false
  • true

enabled

булево

Если разрешено, установка в true включает службу iSCSI.

Варианты:

  • false
  • true

ndmp

словарь

добавлен в netapp.ontap 21.24.0

Сервис протокола Network Data Management Protocol

allowed

булево

Если установлено в true, администратор SVM может управлять службой NDMP

Если false, только администратор кластера может управлять службой.

Требуется ONTAP 9.10.1 или более поздняя версия.

Варианты:

  • false
  • true

nfs

словарь

Сервис протокола NFS

allowed

булево

Если true, администратор SVM может управлять службой NFS. Если false, только администратор кластера может управлять службой.

Варианты:

  • false
  • true

enabled

булево

Если разрешено, установка в true включает службу NFS.

Варианты:

  • false
  • true

nvme

dictionary

Сервис протокола nvme

allowed

boolean

Если значение true, администратор SVM может управлять службой NVMe. Если false, только администратор кластера может управлять службой.

Варианты:

  • false
  • true

enabled

boolean

Если значение allowed равно true, то служба NVMe включена.

Варианты:

  • false
  • true

snapshot_policy

string

добавлено в netapp.ontap 2.7.0

Настройка политики снимков по умолчанию для всех томов Vserver. Эта политика будет назначена всем томам, созданным в этом Vserver, если запрос на создание тома явно не предоставляет политику снимков или том не изменён позже с определённой политикой снимков. Политика снимков на уровне тома всегда переопределяет политику снимков на уровне Vserver.

state

string

Указывает, должен ли существовать указанный SVM.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

subtype

string

добавлено в netapp.ontap 2.7.0

Тип подтипа для создаваемого vserver.

Не может быть изменён после создания.

Варианты:

  • "default"
  • "dp_destination"
  • "sync_source"
  • "sync_destination"

use_rest

string

Использовать REST или ZAPI.

always – всегда будет использовать REST API, если модуль его поддерживает. Выдаётся предупреждение, если модуль не поддерживает REST. Выдаётся ошибка, если опция модуля не поддерживается REST.

never – всегда будет использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если опция REST не поддерживается ZAPI.

auto – попытается использовать REST API, если модуль его поддерживает, и опции модуля поддерживаются. В противном случае вернётся к ZAPI.

По умолчанию: "auto"

username

aliases: user

string

Это может быть учётная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или на уровне SVM.

Для получения дополнительной информации, пожалуйста, обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

Поддерживаются два метода аутентификации

  1. аутентификация по протоколу basic, используя имя пользователя и пароль,
  2. аутентификация по SSL-сертификату, используя файл ssl-клиентского сертификата и, необязательно, файл закрытого ключа.

Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам.

validate_certs

boolean

Если значение no, сертификаты SSL не будут проверены.

Это значение следует устанавливать только в False на сайтах с собственной подписью сертификатов.

Варианты:

  • false
  • true ← (по умолчанию)

web

dictionary

Настройка безопасности веб-служб.

Требуется ONTAP 9.8 или новее для имени сертификата.

Требуется ONTAP 9.10.1 или новее для других опций.

certificate

string

Имя сертификата, используемого интерфейсами управления кластером и узлом для запросов TLS-соединений.

Сертификат должен быть типа «сервер».

client_enabled

boolean

Включена ли аутентификация клиента.

Варианты:

  • false
  • true

ocsp_enabled

boolean

Включена ли проверка протокола состояния сертификата онлайн.

Варианты:

  • false
  • true

Примечания

Примечание

  • Модули с префиксом na_ontap разработаны для поддержки платформы хранения ONTAP.
  • https включен по умолчанию и рекомендуется. Чтобы включить http в кластере, необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create SVM
  netapp.ontap.na_ontap_svm:
    state: present
    name: ansibleVServer
    root_volume: vol1
    root_volume_aggregate: aggr1
    root_volume_security_style: mixed
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create SVM
  netapp.ontap.na_ontap_svm:
    state: present
    services:
      cifs:
        allowed: true
      fcp:
        allowed: true
      nfs:
        allowed: true
        enabled: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: false

- name: Stop SVM REST
  netapp.ontap.na_ontap_svm:
    state: present
    name: ansibleVServer
    admin_state: stopped
    use_rest: always
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

  • Команда NetApp Ansible (@carchi8py)

Ссылки на сборку

  • Система отслеживания ошибок
  • Главная страница
  • Репозиторий (источники)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/ontap/na_ontap_svm_module.html

Spec-Zone.ru

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