Модуль netapp.ontap.na_ontap_vserver_peer – Взаимодействие NetApp ONTAP Vserver

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: netapp.ontap.na_ontap_vserver_peer.

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

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

Описание

Создание/удаление peer vserver

Требования

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

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 или более поздних версий.

Параметры

Параметр	Комментарии
applications список / элементы=строка	Список приложений, которые могут использовать взаимосвязь. Поддержка FlexCache с ONTAP 9.5 и выше.
cert_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
dest_hostname строка	УСТЕРЕЖЕН — используйте, пожалуйста, `peer_options`. Имя хоста или IP-адрес назначения. Необходим для создания взаимосвязи vserver peer с удаленным кластером.
dest_password строка	УСТЕРЕЖЕН — используйте, пожалуйста, `peer_options`. Пароль назначения. Необязательно, если он совпадает с паролем источника.
dest_username строка	УСТЕРЕЖЕН — используйте, пожалуйста, `peer_options`. Имя пользователя назначения. Необязательно, если он совпадает с именем пользователя источника.
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.
hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить стандартный порт (80 или 443) на указанный порт.
https логическое	Включить или выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации с помощью SSL-сертификата, так как она требует SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу SSL-ключа клиента.
local_name_for_peer строка	Указывает локальное имя узла peer Vserver во взаимосвязи. Используйте это, если видите ошибку «Error creating vserver peer … Vserver name conflicts with one of the following».
local_name_for_source строка	Указывает локальное имя узла источника Vserver во взаимосвязи. Используйте это, если видите ошибку «Error accepting vserver peer … System generated a name for the peer Vserver because of a naming conflict».
ontapi целое число	Используемая версия ontap api.
password псевдонимы: pass строка	Пароль для указанного пользователя.
peer_cluster строка	Указывает имя удаленного кластера. Необходимо для создания взаимосвязи vserver peer с удаленным кластером.
peer_options словарь добавлен в netapp.ontap 21.8.0	IP-адрес и параметры подключения к удаленной системе. Если какой-либо из этих параметров не указан, используется соответствующий параметр источника.
cert_filepath строка	путь к файлу SSL-сертификата клиента (.pem).
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.

hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить порт по умолчанию (80 или 443) на этот порт.
https логический тип	Включить и выключить https. Варианты: `false` `true`
key_filepath строка	Путь к файлу ключа SSL-клиента.
ontapi целое число	Используемая версия API ontap.
password псевдонимы: pass строка	Пароль для указанного пользователя.
use_rest строка	Использование REST API, если целевая система его поддерживает, для всех ресурсов и атрибутов, необходимых модулю. В противном случае используется ZAPI. always – всегда использовать REST API. never – всегда использовать ZAPI. auto – попробовать использовать REST API.
username псевдонимы: user строка	Имя пользователя при использовании аутентификации по паролю.
validate_certs логический тип	Если установлено в значение `no`, сертификаты SSL не будут проверяться. Это следует устанавливать только в значение `False` при использовании на сайтах с собственным подписанием сертификатов. Варианты: `false` `true`
peer_vserver строка / обязательно	Указывает имя узла Vserver в отношении.
state строка	Указывает, должен ли указанный узел vserver существовать или нет. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_rest строка	Использовать REST или ZAPI. always – всегда использовать REST API, если модуль поддерживает REST. Выводится предупреждение, если модуль не поддерживает REST. Выводится ошибка, если параметр модуля не поддерживается в REST. never – всегда использовать ZAPI, если модуль поддерживает ZAPI. Возможна ошибка, если параметр REST не поддерживается в ZAPI. auto – попробовать использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае перейти к ZAPI. По умолчанию: `"auto"`
username псевдонимы: user строка	Может быть учетной записью на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Дополнительную информацию можно найти в документации по адресу https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации: аутентификация по паролю, используя имя пользователя и пароль; аутентификация по SSL-сертификату, используя файл SSL-клиентского сертификата и, необязательно, файл закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификатам должна быть включена.
validate_certs логический тип	Если установлено в значение `no`, сертификаты SSL не будут проверяться. Это следует устанавливать только в значение `False` при использовании на сайтах с собственным подписанием сертификатов. Варианты: `false` `true` ← (по умолчанию)
vserver строка / обязательно	Указывает имя исходного Vserver в отношении.

Примечания

Примечание

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

Примеры

- name: Source vserver peer create
  netapp.ontap.na_ontap_vserver_peer:
    state: present
    peer_vserver: ansible2
    peer_cluster: ansibleCluster
    local_name_for_peer: peername
    local_name_for_source: sourcename
    vserver: ansible
    applications: ['snapmirror']
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    peer_options:
      hostname: "{{ netapp_dest_hostname }}"

- name: vserver peer delete
  netapp.ontap.na_ontap_vserver_peer:
    state: absent
    peer_vserver: ansible2
    vserver: ansible
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Source vserver peer create - different credentials
  netapp.ontap.na_ontap_vserver_peer:
    state: present
    peer_vserver: ansible2
    peer_cluster: ansibleCluster
    local_name_for_peer: peername
    local_name_for_source: sourcename
    vserver: ansible
    applications: ['snapmirror']
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    peer_options:
      hostname: "{{ netapp_dest_hostname }}"
      cert_filepath: "{{ cert_filepath }}"
      key_filepath: "{{ key_filepath }}"

Авторы

Команда 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_vserver_peer_module.html