netapp.ontap.na_ontap_cluster модуль – 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.

Новая функция в netapp.ontap 2.6.0

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

Обзор

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

Требования

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

Ansible 2.9 или более поздняя версия — рекомендуется 2.12 или более поздняя.
Python3 — рекомендуется 3.9 или более поздняя версия.
При использовании ZAPI, netapp-lib 2018.11.13 или более поздняя версия (установите с помощью «pip install netapp-lib»), strongly рекомендуется 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.
certificate словарь добавлен в netapp.ontap 22.9.0	Сертификат, используемый кластером и интерфейсами управления узлами для запросов TLS-соединения. Поддерживается только с REST и требует ONTAP 9.10 или более поздней версии.
uuid строка	UUID сертификата.
cluster_contact строка добавлен в netapp.ontap 19.11.0	Контакт кластера, актуален только при выполнении действия изменения.
cluster_ip_address строка	Внутрикластерный IP-адрес узла, который необходимо добавить или удалить.
cluster_location строка добавлен в netapp.ontap 19.11.0	Расположение кластера, актуально только при выполнении действия изменения.
cluster_name строка	Имя кластера для управления.
feature_flags словарь добавлен в netapp.ontap 20.5.0	Включить или отключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.
force булево добавлен в netapp.ontap 21.13.0	принудительно удалить узел, который выведен из строя и не может быть запущен, чтобы удалить его общие ресурсы. Варианты: `false` ← (по умолчанию) `true`
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 клиента.
node_name строка добавлен в netapp.ontap 20.9.0	Имя узла, который нужно добавить или удалить из кластера. Обратите внимание, что при добавлении узла ‘-’ преобразуются в ‘_’ бэкендом ONTAP. При создании кластера `node_name` игнорируется. При добавлении узла с использованием `cluster_ip_address`, `node_name` является необязательным. При использовании для удаления узла `cluster_ip_address` и `node_name` взаимоисключающие.
ontapi целое число	Используемая версия API ONTAP
password псевдонимы: pass строка	Пароль для указанного пользователя.
single_node_cluster булево добавлен в netapp.ontap 19.11.0	Является ли кластер кластером с одним узлом. Игнорируется для версий 9.3 и более ранних. Если присутствует, наблюдалось удаление интерфейсов «Кластер», независимо от значения с ZAPI. Варианты: `false` `true`
state строка	Указывает, должен ли указанный кластер существовать (удаление кластера не поддерживается). Указывает, должен ли узел, идентифицированный по его cluster_ip_address, входить в кластер или нет. Варианты: `"present"` ← (по умолчанию) `"absent"`

time_out integer added in netapp.ontap 21.1.0	время ожидания создания кластера в секундах. Выход с ошибкой, если задача не выполняется в определенное время. Если 0, запрос асинхронный. По умолчанию установлено 3 минуты. По умолчанию: `180`
timezone dictionary added in 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_rest string	Использовать REST или ZAPI. always – всегда использовать REST API, если модуль его поддерживает. Выводится предупреждение, если модуль не поддерживает REST. Выводится ошибка, если параметр модуля не поддерживается в REST. never – всегда использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI. auto – попытаться использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. В противном случае использовать ZAPI. По умолчанию: `"auto"`
username aliases: user string	Это может быть учётная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации базовая аутентификация с использованием имени пользователя и пароля, аутентификация с помощью сертификата 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 }}"

Авторы

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