netapp.ontap.na_ontap_cluster – NetApp ONTAP кластер - создание кластера и добавление/удаление узлов.
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в плейбуке укажите: netapp.ontap.na_ontap_cluster.
Новое в версии 2.6.0: of netapp.ontap
Обзор
- Создание ONTAP кластера.
- Добавление или удаление узлов кластера с помощью cluster_ip_address.
- Для добавления узла требуется ONTAP 9.3 или более поздняя версия.
- Для удаления узла требуется ONTAP 9.4 или более поздняя версия.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
- Для поддержки REST требуется ONTAP 9.6 или более поздняя версия.
- Ansible 2.6
- Сильно рекомендуется Ansible 2.9 или более поздняя версия, так как она позволяет использовать новую систему доставки коллекций.
- Python2 netapp-lib (2017.10.30) или более поздняя версия. Установите с помощью «pip install netapp-lib»
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью «pip install netapp-lib»
- Сильно рекомендуется netapp-lib 2020.3.12, так как он обеспечивает лучшую отчетность об ошибках при проблемах с подключением.
- Для включения http в кластере необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cert_filepath строка добавлено в 20.6.0 of netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. | |
| cluster_contact строка добавлено в 19.11.0 of netapp.ontap | Контакт кластера, актуально только при выполнении действия modify. | |
| cluster_ip_address строка | внутрикластерный IP-адрес узла для добавления или удаления. | |
| cluster_location строка добавлено в 19.11.0 of netapp.ontap | Расположение кластера, актуально только при выполнении действия modify. | |
| cluster_name строка | Имя кластера для управления. | |
| feature_flags словарь добавлено в 20.5.0 of netapp.ontap | Включить или выключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / требуется | Имя хоста или IP-адрес ONTAP экземпляра. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) этим портом | |
| https булево |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации SSL-сертификатом, так как требует SSL. |
| key_filepath строка добавлено в 20.6.0 of netapp.ontap | путь к файлу SSL-ключа клиента. | |
| node_name строка добавлено в 20.9.0 of netapp.ontap | Имя узла, который нужно добавить или удалить из кластера. Обратите внимание, что при добавлении узла '-' преобразуются в '_' серверной частью ONTAP. При создании кластера node_name игнорируется.При добавлении узла с помощью cluster_ip_address, node_name необязательно.При использовании для удаления узла cluster_ip_address и node_name взаимно исключают друг друга. | |
| ontapi целое число | версия ontap api для использования | |
| password строка | Пароль для указанного пользователя. алиасы: pass | |
| single_node_cluster булево добавлено в 19.11.0 of netapp.ontap |
| Является ли кластер кластером из одного узла. Игнорируется для версий 9.3 или более ранних. Если присутствует, было замечено, что интерфейсы 'Кластер' удаляются, независимо от значения. |
| state строка |
| Указывает, должен ли указанный кластер существовать (удаление кластера не поддерживается). Указывает, должен ли узел, идентифицированный по cluster_ip_address, находиться в кластере или нет. |
| use_rest строка | Значение по умолчанию: "auto" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае будет возвращено к ZAPI. всегда -- всегда будет использовать REST API никогда -- всегда будет использовать ZAPI авто -- попытается использовать REST API |
| username строка | Это может быть учетная запись уровня кластера или уровня SVM, в зависимости от того, требуется ли API уровня кластера или уровня SVM. Для получения дополнительной информации, пожалуйста, обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. аутентификация по имени пользователя и паролю, 2. аутентификация с помощью SSL-сертификата, используя файл ssl-сертификата клиента и, необязательно, файл закрытого ключа. Для использования сертификата, сертификат должен быть установлен в ONTAP кластере, и аутентификация по сертификату должна быть включена. алиасы: user | |
| validate_certs булево |
| Если установлено в no, SSL-сертификаты не будут проверены.Это следует устанавливать только в False на лично контролируемых сайтах, использующих самозаверяющие сертификаты. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create cluster
na_ontap_cluster:
state: present
cluster_name: new_cluster
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Add node to cluster (Join cluster)
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)
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
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
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
na_ontap_cluster:
state: absent
node_name: node002
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: modify cluster
na_ontap_cluster:
state: present
cluster_contact: testing
cluster_location: testing
cluster_name: "{{ netapp_cluster}}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Авторы
- Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/netapp/ontap/na_ontap_cluster_module.html