Spec-Zone.ru › Ansible

netapp.ontap.na_ontap_cluster_peer модуль — Управление связями кластеров NetApp ONTAP

Примечание

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

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

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

Для использования в книге задач укажите: netapp.ontap.na_ontap_cluster_peer.

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

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

Описание

  • Создание/удаление связей кластеров ONTAP
  • Изменение удаленных межкластерных адресов в связи кластеров 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 или более поздних версий

Параметры

Параметр

Комментарии

cert_filepath

строка

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

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

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

dest_cluster_name

строка

Имя целевого кластера в отношении взаимодействия, которое необходимо изменить или удалить.

Требуется для удаления отношений взаимодействия и для изменения dest_intercluster_lifs.

dest_hostname

строка

УСТАРЕЛО - используйте, пожалуйста, peer_options.

IP-адрес или имя хоста целевого кластера, который необходимо подключить.

Требуется для завершения процесса взаимодействия с целевым кластером.

dest_intercluster_lifs

псевдонимы: dest_intercluster_lif

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

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

Список адресов межкластерного соединения целевого кластера.

Используется как адреса взаимодействия в исходном кластере.

Все эти межкластерные LIF должны принадлежать целевому кластеру.

dest_password

строка

УСТАРЕЛО - используйте, пожалуйста, peer_options.

Пароль целевого кластера.

Необязательно, если он совпадает с паролем исходного кластера или если используется сертификат.

dest_username

строка

УСТАРЕЛО - используйте, пожалуйста, peer_options.

Имя пользователя целевого кластера.

Необязательно, если он совпадает с именем пользователя исходного кластера или если используется сертификат.

encryption_protocol_proposed

строка

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

Протокол шифрования, который используется для межкластерного взаимодействия.

Доступен только в ONTAP 9.5 и более поздних версиях.

Выбоpы:

  • "tls_psk"
  • "none"

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.

Выбоpы:

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

ipspace

строка

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

IP-пространство локальных межкластерных LIF.

Предполагается использование пространства IP по умолчанию, если не указано иное.

key_filepath

строка

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

путь к файлу ключа SSL клиента.

ontapi

целое число

Используемая версия API ontap.

passphrase

строка

Произвольная фраза, соответствующая фразе, заданной для целевого кластера.

password

псевдонимы: pass

строка

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

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

source_cluster_name

строка

Имя источника кластера в отношении узла, которое необходимо изменить или удалить.

Обязательно для удаления отношения узла и для изменения source_intercluster_lifs.

source_intercluster_lifs

псевдонимы: source_intercluster_lif

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

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

Список межкластерных адресов источника кластера.

Используются в качестве адресов узлов в целевом кластере.

Все эти межкластерные LIF должны принадлежать источнику кластера.

state

строка

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

Варианты:

  • "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/.

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

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

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

validate_certs

логическое значение

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

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

Варианты:

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

Примечания

Примечание

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

Примеры

- name: Create cluster peer
  netapp.ontap.na_ontap_cluster_peer:
    state: present
    source_intercluster_lifs: 1.2.3.4,1.2.3.5
    dest_intercluster_lifs: 1.2.3.6,1.2.3.7
    passphrase: XXXX
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    peer_options:
      hostname: "{{ dest_netapp_hostname }}"
    encryption_protocol_proposed: tls_psk

- name: Delete cluster peer
  netapp.ontap.na_ontap_cluster_peer:
    state: absent
    source_cluster_name: test-source-cluster
    dest_cluster_name: test-dest-cluster
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    peer_options:
      hostname: "{{ dest_netapp_hostname }}"

- name: Create cluster peer - different credentials
  netapp.ontap.na_ontap_cluster_peer:
    state: present
    source_intercluster_lifs: 1.2.3.4,1.2.3.5
    dest_intercluster_lifs: 1.2.3.6,1.2.3.7
    passphrase: XXXX
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    peer_options:
      hostname: "{{ dest_netapp_hostname }}"
      cert_filepath: "{{ cert_filepath }}"
      key_filepath: "{{ key_filepath }}"
    encryption_protocol_proposed: tls_psk

- name: Modify cluster peer - destination intercluster addresses
  netapp.ontap.na_ontap_cluster_peer:
    state: present
    source_intercluster_lifs: 1.2.3.4,1.2.3.5
    dest_intercluster_lifs: 1.2.3.8
    dest_cluster_name: test-dest-cluster
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    peer_options:
      hostname: "{{ dest_netapp_hostname }}"

Авторы

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

Spec-Zone.ru

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