Модуль dellemc.unity.consistencygroup – Управление группами согласованности на системе хранения Unity

Примечание

Этот модуль входит в состав коллекции dellemc.unity (версия 2.0.0).

У вас может уже быть установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install dellemc.unity. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.

Чтобы использовать его в книге задач, укажите: dellemc.unity.consistencygroup.

Новое в dellemc.unity 1.1.0

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

Описание

Управление группами согласованности на системе хранения Unity включает создание новых групп согласованности, добавление томов в группу согласованности, удаление томов из группы согласованности, сопоставление хостов с группой согласованности, отключение сопоставления хостов с группой согласованности, переименование группы согласованности, изменение атрибутов группы согласованности, включение репликации в группе согласованности, отключение репликации в группе согласованности и удаление группы согласованности.

Требования

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

Устройство хранения Dell Unity версии 5.1 или более поздней.
Ansible-core версии 2.14 или более поздней.
Python 3.9, 3.10 или 3.11.
Storops Python SDK 1.2.11.

Параметры

Параметр	Комментарии
cg_id строка	Идентификатор группы согласованности. Может использоваться только для операций получения, изменения, добавления/удаления томов или удаления.
cg_name строка	Имя группы согласованности. Обязательно для операции создания. Укажите либо cg_name, либо cg_id (но не оба), для любой операции.
description строка	Описание группы согласованности.
hosts список / элементы=словарь	Это список хостов. Для сопоставления/отсоединения хостов для группы согласованности необходимо указать либо идентификатор хоста, либо имя. Если заданы hosts, то также необходимо указать mapping_state. Хосты не могут быть сопоставлены с группой согласованности, если у группы нет томов. При сопоставлении группы согласованности с хостом пользователи не должны использовать модуль томов для сопоставления томов в группе согласованности с хостами.
host_id строка	Идентификатор хоста.
host_name строка	Имя хоста.
mapping_state строка	Строковая переменная, описывающая состояние хостов внутри группы согласованности. Если заданы hosts, то также необходимо указать mapping_state. Варианты: `"mapped"` `"unmapped"`
new_cg_name строка	Новое имя группы согласованности, используемое в операции переименования.
password строка / обязательно	Пароль сервера управления Unity.
port целое число	Номер порта, через который происходит общение с сервером управления Unity. По умолчанию: `443`
replication_params словарь	Настройки, необходимые для включения репликации.
destination_cg_name строка	Имя целевой группы согласованности. Значение по умолчанию — имя исходной группы согласованности, префикс «DR_».
destination_pool_id строка	Идентификатор пула для выделения целевых LUN. Взаимоисключающее с destination_pool_name.
destination_pool_name строка	Имя пула для выделения целевых LUN. Взаимоисключающее с destination_pool_id.
remote_system словарь	Детали удаленной системы, для которой настраивается репликация. Параметр remote_system должен быть указан, если replication_type равен `remote`.
remote_system_host строка / обязательно	IP-адрес или FQDN для удаленного хоста Unisphere Unity.
remote_system_password строка / обязательно	Пароль удаленного хоста Unisphere Unity.
remote_system_port целое число	Порт, на котором размещен удаленный хост Unisphere Unity. По умолчанию: `443`
remote_system_username строка / обязательно	Имя пользователя удаленного хоста Unisphere Unity.
remote_system_verifycert булево	Булевая переменная, указывающая, нужно ли проверять сертификат SSL удаленного хоста Unisphere Unity. `true` - Указывает, что сертификат SSL должен быть проверен. `false` - Указывает, что сертификат SSL не должен быть проверен. Варианты: `false` `true` ← (по умолчанию)
replication_mode строка / обязательно	Режим репликации. Варианты: `"asynchronous"` `"manual"`

replication_type string	Тип репликации. Варианты: `"local"` ← (по умолчанию) `"remote"`
rpo integer	Максимальное время ожидания, прежде чем система синхронизирует исходные и целевые LUN. Параметр rpo должен быть указан, если replication_mode имеет значение `asynchronous`. Значение должно быть в диапазоне от `5` до `1440`.
replication_state string	Состояние репликации. Варианты: `"enable"` `"disable"`
snap_schedule string	Расписание создания снимков, назначенное группе согласованности. Указание пустой строки “” удалит существующее расписание создания снимков из группы согласованности.
state string / обязательно	Определяет, должна ли существовать группа согласованности. Варианты: `"absent"` `"present"`
tiering_policy string	Варианты политики тиеринга для определения того, как данные хранилищных ресурсов будут распределяться между доступными уровнями в пуле. Варианты: `"AUTOTIER_HIGH"` `"AUTOTIER"` `"HIGHEST"` `"LOWEST"`
unispherehost string / обязательно	IP-адрес или FQDN сервера управления Unity.
username string / обязательно	Имя пользователя сервера управления Unity.
validate_certs алиасы: verifycert boolean	Булевое значение для указания проверки сертификата SSL. `true` - Указывает, что сертификат SSL должен быть проверен. `false` - Указывает, что сертификат SSL не должен быть проверен. Варианты: `false` `true` ← (по умолчанию)
vol_state string	Строковое значение, описывающее состояние томов внутри группы согласованности. Если указаны volumes, то также должен быть указан vol_state. Варианты: `"present-in-group"` `"absent-in-group"`
volumes list / элементы=словарь	Список томов. Для добавления/удаления существующих томов из группы согласованности необходимо указать либо идентификатор, либо имя тома. Если указаны volumes, то также должен быть указан vol_state. Тома нельзя добавлять/удалять из группы согласованности, если группа согласованности или том имеют снимки.
vol_id string	Идентификатор тома.
vol_name string	Имя тома.

Примечания

Примечание

check_mode не поддерживается.
Модули, присутствующие в этой коллекции под именем «dellemc.unity», разработаны для поддержки платформы хранилищ Dell Unity.

Примеры

- name: Create consistency group
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      validate_certs: "{{validate_certs}}"
      username: "{{username}}"
      password: "{{password}}"
      cg_name: "{{cg_name}}"
      description: "{{description}}"
      snap_schedule: "{{snap_schedule1}}"
      state: "present"

- name: Get details of consistency group using id
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_id: "{{cg_id}}"
      state: "present"

- name: Add volumes to consistency group
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_id: "{{cg_id}}"
      volumes:
          - vol_name: "Ansible_Test-3"
          - vol_id: "sv_1744"
      vol_state: "{{vol_state_present}}"
      state: "present"

- name: Rename consistency group
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_name: "{{cg_name}}"
      new_cg_name: "{{new_cg_name}}"
      state: "present"

- name: Modify consistency group details
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_name: "{{new_cg_name}}"
      snap_schedule: "{{snap_schedule2}}"
      tiering_policy: "{{tiering_policy1}}"
      state: "present"

- name: Map hosts to a consistency group
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_id: "{{cg_id}}"
      hosts:
          - host_name: "10.226.198.248"
          - host_id: "Host_511"
      mapping_state: "mapped"
      state: "present"

- name: Unmap hosts from a consistency group
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_id: "{{cg_id}}"
      hosts:
          - host_id: "Host_511"
          - host_name: "10.226.198.248"
      mapping_state: "unmapped"
      state: "present"

- name: Remove volumes from consistency group
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_name: "{{new_cg_name}}"
      volumes:
          - vol_name: "Ansible_Test-3"
          - vol_id: "sv_1744"
      vol_state: "{{vol_state_absent}}"
      state: "present"

- name: Delete consistency group
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_name: "{{new_cg_name}}"
      state: "absent"

- name: Enable replication for consistency group
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_id: "cg_id_1"
      replication_params:
          destination_cg_name: "destination_cg_1"
          replication_mode: "asynchronous"
          rpo: 60
          replication_type: "remote"
          remote_system:
              remote_system_host: '10.1.2.3'
              remote_system_verifycert: false
              remote_system_username: 'username'
              remote_system_password: 'password'
          destination_pool_name: "pool_test_1"
      replication_state: "enable"
      state: "present"

- name: Disable replication for consistency group
  dellemc.unity.consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_name: "dis_repl_ans_source"
      replication_state: "disable"
      state: "present"

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для этого модуля:

Ключ	Описание
changed boolean	Изменилось ли ресурс. Возвращается: всегда Пример: `true`
consistency_group_details dictionary	Подробности группы согласованности. Возвращается: когда группа согласованности существует Пример: {"advanced_dedup_status": "DedupStatusEnum.DISABLED", "block_host_access": null, "cg_replication_enabled": false, "data_reduction_percent": 0, "data_reduction_ratio": 1.0, "data_reduction_size_saved": 0, "data_reduction_status": "DataReductionStatusEnum.DISABLED", "datastores": null, "dedup_status": null, "description": "Ansible testing", "esx_filesystem_block_size": null, "esx_filesystem_major_version": null, "existed": true, "filesystem": null, "hash": 8776023812033, "health": {"UnityHealth": {"hash": 8776023811889}}, "host_v_vol_datastore": null, "id": "res_7477", "is_replication_destination": false, "is_snap_schedule_paused": null, "luns": null, "metadata_size": 0, "metadata_size_allocated": 0, "name": "Ansible_CG_Testing", "per_tier_size_used": null, "pools": null, "relocation_policy": "TieringPolicyEnum.MIXED", "replication_type": "ReplicationTypeEnum.NONE", "size_allocated": 0, "size_total": 0, "size_used": null, "snap_count": 0, "snap_schedule": null, "snaps_size_allocated": 0, "snaps_size_total": 0, "snapshots": [], "thin_status": "ThinStatusEnum.FALSE", "type": "StorageResourceTypeEnum.CONSISTENCY_GROUP", "virtual_volumes": null, "vmware_uuid": null}
block_host_access dictionary	Подробности хостов, сопоставленных с группой согласованности. Возвращается: успешно
UnityBlockHostAccessList list / элементы=строка	Список хостов, сопоставленных с группой согласованности. Возвращается: успешно
UnityBlockHostAccess dictionary	Подробности хоста. Возвращается: успешно
id string	Идентификатор хоста. Возвращается: успешно
name string	Имя хоста. Возвращается: успешно
cg_replication_enabled boolean	Включена ли репликация. Возвращается: успешно
id string	Идентификатор системы, присвоенный группе согласованности. Возвращается: успешно
luns dictionary	Подробности томов, входящих в группу согласованности. Возвращается: успешно
UnityLunList list / элементы=строка	Список томов, входящих в группу согласованности. Возвращается: успешно
UnityLun dictionary	Подробности тома. Возвращается: успешно
id string	Идентификатор системы, присвоенный тому. Возвращается: успешно
name string	Имя тома. Возвращается: успешно
relocation_policy string	Политика перемещения FAST VP для группы согласованности. Возвращается: успешно
snap_schedule dictionary	График создания снимков, примененный к группе согласованности. Возвращается: успешно
UnitySnapSchedule dictionary	График создания снимков, примененный к группе согласованности. Возвращается: успешно
id string	Идентификатор системы, присвоенный графику создания снимков. Возвращается: успешно
name string	Имя графика создания снимков. Возвращается: успешно
snapshots list / элементы=строка	Список снимков группы согласованности. Возвращается: успешно

END_OF_DOCUMENT_MARKER

creation_time string	Дата и время создания моментальной копии. Возвращается при: успехе
expirationTime string	Дата и время, после которого моментальная копия истечёт. Возвращается при: успехе
name string	Имя моментальной копии. Возвращается при: успехе
storageResource dictionary	Ресурс хранения, для которого была создана моментальная копия. Возвращается при: успехе
UnityStorageResource dictionary	Детали ресурса хранения. Возвращается при: успехе
id string	Идентификатор ресурса хранения. Возвращается при: успехе

Авторы

Akash Shendge (@shenda1)

Ссылки на коллекции

© 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/dellemc/unity/consistencygroup_module.html