netapp.ontap.na_ontap_aggregate – NetApp ONTAP управлять агрегатами.
Примечание
Этот плагин является частью коллекции netapp.ontap (версия 21.1.1).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Чтобы использовать его в книге задач, укажите: netapp.ontap.na_ontap_aggregate.
В версии 2.6.0: of netapp.ontap
Обзор
- Создание, удаление или управление агрегатами в ONTAP.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- 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. | |
| disk_count целое число | Количество дисков для размещения в агрегате, включая диски четности. Диски в этом вновь созданном агрегате берутся из резервного пула дисков. Самые маленькие диски в этом пуле присоединяются к агрегату первыми, если не указан аргумент disk-size. Должен быть указан либо disk-count, либо disks. Диапазон [0..2^31-1].Требуется при state=present.Изменяемый только если указанное disk_count больше текущего disk_count. Невозможно создать raidgroup с 1 диском при использовании типа RAID raid4. Если disk_count % raid_size == 1, будет добавлен только disk_count/raid_size * raid_size. Если disk_count = 6, raid_type = raid4, raid_size = 4, будут добавлены все 6 дисков. Если disk_count = 5, raid_type = raid4, raid_size = 4, будет добавлено 5/4 * 4 = 4. 1 не будет добавлен. | |
| disk_size целое число добавлено в 2.7.0 netapp.ontap | Размер диска в блоках по 4К. Будут использованы диски, размер которых отличается не более чем на 10% от указанного. | |
| disk_size_with_unit строка | Размер диска в указанных единицах. Это положительное целое число, за которым следует единица измерения T/G/M/K. Например, 72G, 1T и 32M. Этот параметр игнорируется, если через параметр "disks" указан конкретный список дисков. Вы должны использовать только один из параметров "disk-size" или "disk-size-with-unit". | |
| disk_type строка добавлено в 2.7.0 netapp.ontap |
| Тип диска для создания агрегата. |
| disks список / элементы=строка добавлено в 2.8.0 netapp.ontap | Конкретный список дисков для использования в новом агрегате. Для создания «зеркального» агрегата с конкретным списком дисков необходимо указать параметры «disks» и «mirror_disks». Кроме того, в обоих списках должно быть одинаковое количество дисков. | |
| feature_flags словарь добавлено в 20.5.0 netapp.ontap | Включение или выключение новой функции. Это может быть использовано для включения экспериментальной функции или выключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| from_name строка добавлено в 2.7.0 netapp.ontap | Имя агрегата, который будет переименован. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределение стандартного порта (80 или 443) на указанный порт. | |
| https булево |
| Включение и отключение https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL. |
| ignore_pool_checks булево добавлено в 20.8.0 netapp.ontap |
| действителен только при использовании параметра disks. Диски в плексе должны принадлежать одному и тому же резервному пулу, а зеркальные диски - другому резервному пулу. При установке в значение true эти проверки игнорируются. |
| is_mirrored булево добавлено в 2.8.0 netapp.ontap |
| Указывает, что новый агрегат должен быть зеркальным (иметь два плекса). Если установлено в значение true, указанные диски будут распределены по двум плексам. По умолчанию новый агрегат не будет зеркальным. Этот параметр не может быть использован при указании конкретного списка дисков с помощью параметров «disks» или «mirror_disks». |
| key_filepath строка добавлено в 20.6.0 netapp.ontap | путь к файлу ключа SSL клиента. | |
| mirror_disks список / элементы=строка добавлено в 2.8.0 netapp.ontap | Список зеркальных дисков для использования. Он должен содержать такое же количество дисков, что и в параметре «disks». | |
| name строка / обязательно | Имя агрегата для управления. | |
| nodes список / элементы=строка | Узел(ы) для создания агрегата. Если узел не указан, будет использован домашний lif. Если указано несколько узлов, будет создана полоса агрегата. | |
| object_store_name строка добавлено в 2.9.0 netapp.ontap | Имя конфигурации хранилища объектов, подключенного к агрегату. | |
| ontapi целое число | Версия ontap api, которую нужно использовать. | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| raid_size целое число добавлено в 2.7.0 netapp.ontap | Устанавливает максимальное количество дисков на группу RAID. | |
| raid_type строка добавлено в 2.7.0 netapp.ontap |
| Определяет тип групп RAID для использования в новом агрегате. raid_0 доступен только на ONTAP Select. |
| service_state строка |
| Включен или отключен указанный агрегат. Создает агрегат, если он не существует. |
| snaplock_type строка добавлено в 20.1.0 netapp.ontap |
| Тип snaplock для создаваемого агрегата. |
| spare_pool строка добавлено в 2.8.0 netapp.ontap |
| Указывает резервный пул, из которого выбираются резервные диски для создания нового агрегата. |
| state строка |
| Существует ли указанный агрегат или нет. |
| time_out целое число добавлено в 2.8.0 netapp.ontap | По умолчанию: 100 | Время ожидания создания агрегата в секундах. Значение по умолчанию - 100 секунд. |
| unmount_volumes булево |
| Если установлено в "ИСТИНА", этот параметр указывает, что все тома, размещенные в данном агрегате, должны быть отмонтированы перед выполнением операции отключения. По умолчанию система отклонит любую попытку отключить агрегат, содержащий один или несколько активных томов. |
| use_rest строка | По умолчанию: "auto" | API REST, если он поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае возвращается к ZAPI. всегда -- всегда будет использовать API REST никогда -- всегда будет использовать ZAPI авто -- попытается использовать API REST |
| username строка | Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или уровня SVM. Для получения дополнительной информации ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. аутентификация по протоколу Basic, с использованием имени пользователя и пароля, 2. аутентификация по SSL-сертификату, с использованием файла SSL-сертификата клиента и, необязательно, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам. псевдонимы: user | |
| validate_certs булево |
| Если установлено в no, SSL-сертификаты не будут проверены.Это следует устанавливать только в False при использовании на сайтах с собственными сертификатами. |
| wait_for_online булево добавлено в 2.8.0 netapp.ontap |
| Установите этот параметр в 'true' для синхронного выполнения при создании (подождите, пока состояние агрегата не станет online). Установите этот параметр в 'false' для асинхронного выполнения. При асинхронном выполнении выполнение завершается сразу после отправки запроса, не проверяя состояние агрегата. |
Примечания
Примечание
- Модули, начинающиеся с na\_ontap, разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create Aggregates and wait 5 minutes until aggregate is online
na_ontap_aggregate:
state: present
service_state: online
name: ansibleAggr
disk_count: 1
wait_for_online: True
time_out: 300
snaplock_type: non_snaplock
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Manage Aggregates
na_ontap_aggregate:
state: present
service_state: offline
unmount_volumes: true
name: ansibleAggr
disk_count: 1
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Attach object store
na_ontap_aggregate:
state: present
name: aggr4
object_store_name: sgws_305
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Rename Aggregates
na_ontap_aggregate:
state: present
service_state: online
from_name: ansibleAggr
name: ansibleAggr2
disk_count: 1
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Delete Aggregates
na_ontap_aggregate:
state: absent
service_state: offline
unmount_volumes: true
name: ansibleAggr
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Авторы
- Команда NetApp Ansible (@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_aggregate_module.html