Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.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 или более поздняя.
  • netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib устарел и больше не поддерживается. Используйте его на свой страх и риск.
  • Физическая или виртуальная кластерная система 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 или более поздней версии.

Варианты:

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

Варианты:

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

ipspace

строка

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

IPspace локальных межкластерных LIF.

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

key_filepath

строка

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

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

lambda_config

словарь

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

Параметры конфигурации функции прокси-сервера AWS Lambda.

Эти параметры и вложенные параметры поддерживаются только при использовании REST.

aws_profile

строка

Имя профиля AWS, используемого для аутентификации.

aws_region

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

Имя региона AWS.

function_name

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

Имя вызываемой функции AWS Lambda.

local_name_for_peer

строка

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

Задает локальное имя кластера-пира в отношении.

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

local_name_for_source

строка

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

Задает локальное имя исходного кластера в отношении.

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

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.

lambda_config

словарь

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

Параметры конфигурации функции прокси-сервера AWS Lambda.

Эти параметры и вложенные параметры поддерживаются только при использовании REST.

aws_profile

строка

Имя профиля AWS, используемого для аутентификации.

aws_region

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

Имя региона AWS.

function_name

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

Имя вызываемой функции AWS Lambda.

ontapi

целое число

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

password

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

строка

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

use_lambda

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

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

Определяет, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP.

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

Варианты:

  • false
  • true

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_lambda

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

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

Определяет, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP.

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

Варианты:

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

use_rest

строка

Определяет, использовать REST или ZAPI.

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

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

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

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

username

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

строка

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

Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

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

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

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

validate_certs

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

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

Задавайте это значение только для использования на контролируемых вами узлах с самоподписанными сертификатами: False.

Варианты:

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

Примечания

Примечание

  • Операция изменения удалённых межкластерных адресов поддерживается только через REST.
  • Параметры local_name_for_peer и local_name_for_source поддерживаются только через REST.
  • При использовании REST поддерживается функциональность прокси AWS Lambda. Пример использования см. в файле README.
  • Модули с префиксом 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
    local_name_for_peer: 'dest_local_name'
    local_name_for_source: 'sorce_local_name'
    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
    local_name_for_peer: 'dest_name'
    local_name_for_source: 'source_name'
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    peer_options:
      hostname: "{{ dest_netapp_hostname }}"

Авторы

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

Ссылки на коллекцию

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

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