модуль netapp.ontap.na_ontap_cluster – кластер 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.

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

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

Описание

Создание кластера ONTAP.
Добавление или удаление узлов кластера с помощью cluster_ip_address.
Для добавления узла требуется ONTAP 9.3 или более поздней версии.
Для удаления узла требуется ONTAP 9.4 или более поздней версии.

Требования

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

Ansible 2.9 или более поздней версии; рекомендуется версия 2.12 или более поздняя.
Python 3; рекомендуется версия 3.9 или более поздняя.
netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib объявлена устаревшей и больше не поддерживается. Используйте её на свой страх и риск.
Физическая или виртуальная система Data ONTAP с кластерной конфигурацией. Модули поддерживают Data ONTAP 9.1 и более поздние версии; для поддержки REST требуется ONTAP 9.6 или более поздней версии.

Параметры

Параметр	Описание
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
certificate dictionary добавлено в netapp.ontap 22.9.0	Сертификат, используемый интерфейсами управления кластером и узлами для запросов на подключение TLS. Поддерживается только с REST и требует ONTAP 9.10 или более поздней версии.
uuid string	UUID сертификата.
cluster_contact string добавлено в netapp.ontap 19.11.0	Контактное лицо кластера; применяется только при выполнении действия изменения.
cluster_ip_address string	Внутренний IP-адрес узла, который нужно добавить в кластер или удалить из него.
cluster_location string добавлено в netapp.ontap 19.11.0	Расположение кластера; применяется только при выполнении действия изменения.
cluster_name string	Имя кластера, которым нужно управлять.
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут измениться без уведомления. Неизвестные ключи игнорируются.
force boolean добавлено в netapp.ontap 21.13.0	Принудительно удалить узел, который не работает и не может быть переведён в рабочее состояние, чтобы удалить его общие ресурсы. Варианты: `false` ← (по умолчанию) `true`
force_ontap_version string добавлено в 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 string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределение порта по умолчанию (80 или 443) этим портом.
https boolean	Включение или отключение HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при использовании аутентификации с сертификатом SSL, поскольку для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
node_name string добавлено в netapp.ontap 20.9.0	Имя узла, который нужно добавить в кластер или удалить из него. Обратите внимание: при добавлении узла серверная часть ONTAP заменяет «-» на «_». При создании кластера `node_name` игнорируется. При добавлении узла с помощью `cluster_ip_address` параметр `node_name` является необязательным. При удалении узла параметры `cluster_ip_address` и `node_name` являются взаимоисключающими.
ontapi integer	Версия API ONTAP, которую следует использовать.
password псевдонимы: pass string	Пароль указанного пользователя.
single_node_cluster boolean добавлено в netapp.ontap 19.11.0	Является ли кластер одноузловым. Игнорируется в версии 9.3 и более ранних версиях. Было замечено, что при наличии этого параметра интерфейсы «Cluster» удалялись независимо от его значения при использовании ZAPI. Варианты: `false` `true`
state string	Должен ли указанный кластер существовать (удаление кластера не поддерживается). Должен ли узел, определяемый параметром cluster_ip_address, входить в кластер. Варианты: `"present"` ← (по умолчанию) `"absent"`
time_out integer добавлено в netapp.ontap 21.1.0	Время ожидания создания кластера в секундах. Возвращается ошибка, если задача не завершена за указанное время. Если значение равно 0, запрос выполняется асинхронно. По умолчанию задано значение 3 минуты. По умолчанию: `180`
timezone dictionary добавлено в netapp.ontap 21.24.0	Часовой пояс кластера. Поддерживается только REST.
name string	Название часового пояса должно быть одним из следующих: Географический регион, обычно записываемый в формате «область/местоположение». Среднее время по Гринвичу (GMT) или разница во времени с GMT в часах. Допустимый псевдоним, то есть термин, определённый стандартом для обозначения географического региона или GMT. Системное или иное обозначение, не связанное с географическим регионом или GMT. Полный список поддерживаемых псевдонимов можно найти здесь: https://library.netapp.com/ecmdocs/ECMP1155590/html/GUID-D3B8A525-67A2-4BEE-99DB-EF52D6744B5F.html Поддерживается только REST.
use_lambda boolean добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать прокси-функцию AWS Lambda для подключения к системе ONTAP. Поддерживается только с REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Использовать REST или ZAPI. always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выводится предупреждение. Если параметр модуля не поддерживается в REST, выводится ошибка. never — всегда использовать ZAPI, если модуль её поддерживает. Если параметр REST не поддерживается в ZAPI, может быть выведена ошибка. auto — использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае использовать ZAPI. По умолчанию: `"always"`
username псевдонимы: user string	Это может быть учётная запись на уровне кластера или SVM — в зависимости от того, какой API требуется: на уровне кластера или SVM. Дополнительную информацию см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Обычная аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью сертификата SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Для использования сертификата его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs boolean	Если задано значение `no`, сертификаты SSL не проверяются. Устанавливайте значение `False` только для контролируемых вами сайтов, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Поддерживаются REST и ZAPI.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включён по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»

Примеры

- name: Create cluster
  netapp.ontap.na_ontap_cluster:
    state: present
    cluster_name: new_cluster
    time_out: 0
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Add node to cluster (Join cluster)
  netapp.ontap.na_ontap_cluster:
    state: present
    cluster_ip_address: 10.10.10.10
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Add node to cluster (Join cluster)
  netapp.ontap.na_ontap_cluster:
    state: present
    cluster_ip_address: 10.10.10.10
    node_name: my_preferred_node_name
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create a 2 node cluster in one call
  netapp.ontap.na_ontap_cluster:
    state: present
    cluster_name: new_cluster
    cluster_ip_address: 10.10.10.10
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Remove node from cluster
  netapp.ontap.na_ontap_cluster:
    state: absent
    cluster_ip_address: 10.10.10.10
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Remove node from cluster
  netapp.ontap.na_ontap_cluster:
    state: absent
    node_name: node002
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify cluster
  netapp.ontap.na_ontap_cluster:
    state: present
    cluster_contact: testing
    cluster_location: testing
    cluster_name: "{{ netapp_cluster}}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Updating the cluster-wide web services configuration
  netapp.ontap.na_ontap_cluster:
    state: present
    cluster_contact: testing
    cluster_location: testing
    certificate:
      uuid: 7f2f332c-933e-11ee-ab1c-005056b397ff
    cluster_name: "{{ netapp_cluster}}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

Команда Ansible NetApp (@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_module.html