Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию dellemc.unity (версия 2.1.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.3 или более поздней.
  • Ansible-core версии 2.17 или более поздней.
  • Python 3.11, 3.12 или 3.13.
  • Python SDK Storops 1.2.12.

Параметры

Параметр

Описание

cg_id

string

Идентификатор группы согласованности.

Можно использовать только для операций получения сведений, изменения, добавления или удаления томов, а также удаления группы.

cg_name

string

Имя группы согласованности.

Обязателен для операции создания.

Для любой операции укажите либо cg_name, либо cg_id (но не оба параметра одновременно).

description

string

Описание группы согласованности.

hosts

list / elements=dictionary

Список хостов.

Для сопоставления хостов с группой согласованности или отмены сопоставления необходимо указать идентификатор или имя хоста.

Если указаны hosts, необходимо также указать mapping_state.

Нельзя сопоставить хосты с группой согласованности, если в ней нет томов.

При сопоставлении группы согласованности с хостом не используйте модуль томов для сопоставления томов этой группы с хостами.

host_id

string

Идентификатор хоста.

host_name

string

Имя хоста.

mapping_state

string

Строковая переменная, описывающая состояние хостов в группе согласованности.

Если указаны hosts, необходимо также указать mapping_state.

Варианты:

  • "mapped"
  • "unmapped"

new_cg_name

string

Новое имя группы согласованности, используемое при переименовании.

password

string / обязательный

Пароль сервера управления Unity.

port

integer

Номер порта для связи с сервером управления Unity.

По умолчанию: 443

replication_params

dictionary

Параметры, необходимые для включения репликации.

destination_cg_name

string

Имя целевой группы согласованности.

По умолчанию используется имя исходной группы согласованности с префиксом «DR_».

destination_pool_id

string

Идентификатор пула для размещения целевых LUN.

Взаимоисключающий параметр с destination_pool_name.

destination_pool_name

string

Имя пула для размещения целевых LUN.

Взаимоисключающий параметр с destination_pool_id.

remote_system

dictionary

Сведения об удаленной системе, для которой настраивается репликация.

Параметр remote_system необходимо указать, если значение replication_type — remote.

remote_system_host

string / обязательный

IP-адрес или FQDN хоста удаленной Unity Unisphere.

remote_system_password

string / обязательный

Пароль хоста удаленной Unity Unisphere.

remote_system_port

integer

Порт, на котором работает удаленная Unity Unisphere.

По умолчанию: 443

remote_system_username

string / обязательный

Имя пользователя хоста удаленной Unity Unisphere.

remote_system_verifycert

boolean

Логическая переменная, определяющая, следует ли проверять SSL-сертификат хоста удаленной Unity Unisphere.

true — указывает, что SSL-сертификат следует проверять.

false — указывает, что SSL-сертификат проверять не следует.

Варианты:

  • false
  • true ← (по умолчанию)

replication_mode

string / обязательный

Режим репликации.

Варианты:

  • "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 / elements=dictionary

Список томов.

Для добавления существующих томов в группу согласованности или их удаления из нее необходимо указать идентификатор или имя тома.

Если указаны volumes, необходимо также указать vol_state.

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

vol_id

string

Идентификатор тома.

vol_name

string

Имя тома.

Примечания

Примечание

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

Примеры

- name: Create consistency group
  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
  consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_id: "{{cg_id}}"
      state: "present"

- name: Add volumes to consistency group
  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
  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
  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
  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
  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
  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
  consistencygroup:
      unispherehost: "{{unispherehost}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      cg_name: "{{new_cg_name}}"
      state: "absent"

- name: Enable replication for consistency group
  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
  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 / elements=string

Список хостов, сопоставленных с группой согласованности.

Возвращается: при успехе

UnityBlockHostAccess

dictionary

Сведения о хосте.

Возвращается: при успехе

id

string

Идентификатор хоста.

Возвращается: при успехе

name

string

Имя хоста.

Возвращается: при успехе

cg_replication_enabled

boolean

Включена ли репликация.

Возвращается: при успехе

id

string

Системный идентификатор, присвоенный группе согласованности.

Возвращается: при успехе

luns

dictionary

Сведения о томах, входящих в группу согласованности.

Возвращается: при успехе

UnityLunList

list / elements=string

Список томов, входящих в группу согласованности.

Возвращается: при успехе

UnityLun

dictionary

Сведения о томе.

Возвращается: при успехе

id

string

Системный идентификатор, присвоенный тому.

Возвращается: при успехе

name

string

Имя тома.

Возвращается: при успехе

relocation_policy

string

Политика размещения по уровням FAST VP для группы согласованности.

Возвращается: при успехе

snap_schedule

dictionary

Расписание создания снимков, примененное к группе согласованности.

Возвращается: при успехе

UnitySnapSchedule

dictionary

Расписание создания снимков, примененное к группе согласованности.

Возвращается: при успехе

id

string

Системный идентификатор, присвоенный расписанию создания снимков.

Возвращается: при успехе

name

string

Имя расписания создания снимков.

Возвращается: при успехе

snapshots

list / elements=string

Список снимков группы согласованности.

Возвращается: при успехе

creation_time

string

Дата и время создания снимка.

Возвращается: при успехе

expirationTime

string

Дата и время истечения срока действия снимка.

Возвращается: при успехе

name

string

Имя снимка.

Возвращается: при успехе

storageResource

dictionary

Ресурс хранения, для которого создан снимок.

Возвращается: при успехе

UnityStorageResource

dictionary

Сведения о ресурсе хранения.

Возвращается: при успехе

id

string

Идентификатор ресурса хранения.

Возвращается: при успехе

Авторы

  • Akash Shendge (@shenda1)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/unity/consistencygroup_module.html

Spec-Zone.ru

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