netapp.ontap.na_ontap_cluster – NetApp ONTAP кластер - создание кластера и добавление/удаление узлов.
Примечание
Этот плагин является частью коллекции netapp.ontap (версии 21.1.1).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в плейбуке укажите: netapp.ontap.na_ontap_cluster.
Новое в версии 2.6.0: модуля netapp.ontap
Обзор
- Создание кластера ONTAP.
- Добавление или удаление узлов кластера с помощью cluster_ip_address.
- Добавление узла требует ONTAP 9.3 или более поздней версии.
- Удаление узла требует ONTAP 9.4 или более поздней версии.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Ansible 2.9
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает более подробные сообщения об ошибках при подключении.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Для включения http в кластере необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cert_filepath строка добавлен в версии 20.6.0 от netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. | |
| cluster_contact строка добавлен в версии 19.11.0 от netapp.ontap | Контакт кластера, актуален только при выполнении действия модификации. | |
| cluster_ip_address строка | Внутрикластерный IP-адрес узла, который необходимо добавить или удалить. | |
| cluster_location строка добавлен в версии 19.11.0 от netapp.ontap | Расположение кластера, актуально только при выполнении действия модификации. | |
| cluster_name строка | Имя кластера для управления. | |
| feature_flags словарь добавлен в версии 20.5.0 от netapp.ontap | Включить или отключить новую функцию. Может использоваться для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределяет порт по умолчанию (80 или 443) на указанный порт. | |
| https булево |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по сертификату SSL, так как она требует SSL. |
| key_filepath строка добавлен в версии 20.6.0 от netapp.ontap | путь к файлу закрытого ключа SSL-сертификата клиента. | |
| node_name строка добавлен в версии 20.9.0 от netapp.ontap | Имя узла, который необходимо добавить или удалить из кластера. Обратите внимание, что при добавлении узла знаки '-' конвертируются в '_' на стороне ONTAP. При создании кластера node_name игнорируется.При добавлении узла с использованием cluster_ip_address, node_name необязательно.При удалении узла, cluster_ip_address и node_name взаимоисключающие. | |
| ontapi целое число | Используемая версия API ONTAP | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| single_node_cluster булево добавлен в версии 19.11.0 от netapp.ontap |
| Является ли кластер кластером из одного узла. Игнорируется для версий 9.3 или более ранних. Если присутствует, наблюдалось удаление интерфейсов 'Кластер', независимо от значения. |
| state строка |
| Указывает, должен ли существовать указанный кластер (удаление кластера не поддерживается). Указывает, должен ли узел, идентифицированный по его cluster_ip_address, находиться в кластере или нет. |
| time_out целое число добавлен в версии 21.1.0 от netapp.ontap | По умолчанию: 180 | время ожидания создания кластера в секундах. Выход с ошибкой, если задача не выполнена в определенное время. Если 0, запрос асинхронный. Значение по умолчанию - 3 минуты. |
| use_rest строка | По умолчанию: "auto" | API REST, если он поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае используется 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
time_out: 0
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 }}"
Авторы
- Команда Ansible NetApp (@carchi8py) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/netapp/ontap/na_ontap_cluster_module.html