Spec-Zone.ru › Ansible 2.11

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
    Варианты:
  • ATA
  • BSAS
  • FCAL
  • FSAS
  • LUN
  • MSATA
  • SAS
  • SSD
  • VMDISK
Тип диска для создания агрегата.
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
    Варианты:
  • raid4
  • raid_dp
  • raid_tec
  • raid_0
Определяет тип групп RAID для использования в новом агрегате.
raid_0 доступен только на ONTAP Select.
service_state
строка
    Варианты:
  • online
  • offline
Включен или отключен указанный агрегат. Создает агрегат, если он не существует.
snaplock_type
строка
добавлено в 20.1.0 netapp.ontap
    Варианты:
  • compliance
  • enterprise
  • non_snaplock
Тип snaplock для создаваемого агрегата.
spare_pool
строка
добавлено в 2.8.0 netapp.ontap
    Варианты:
  • Pool0
  • Pool1
Указывает резервный пул, из которого выбираются резервные диски для создания нового агрегата.
state
строка
    Варианты:
  • present ←
  • absent
Существует ли указанный агрегат или нет.
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API