Spec-Zone.ru › Ansible

dellemc.powerflex.replication_consistency_group модуль — Управление группами согласованности репликации на Dell PowerFlex

Примечание

Этот модуль является частью коллекции dellemc.powerflex (версия 2.5.0).

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

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

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

Новое в dellemc.powerflex 1.5.0

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

Обзор

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

Требования

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

  • Система хранения Dell PowerFlex версии 3.6 или более поздней.
  • PyPowerFlex 1.12.0.

Параметры

Параметр

Комментарии

activity_mode

string

Режим активности RCG.

Этот параметр поддерживается для версии 3.6 и выше.

Варианты:

  • "Active"
  • "Inactive"

create_snapshot

boolean

Создавать ли снимок группы согласованности репликации.

Варианты:

  • false
  • true

force

boolean

Принудительно переключить RCG.

Варианты:

  • false
  • true

freeze

boolean

Заморозить или разморозить RCG.

Этот параметр устарел. Используйте rcg_state вместо него.

Варианты:

  • false
  • true

hostname

aliases: gateway_host

string / required

IP-адрес или FQDN узла PowerFlex.

is_consistent

boolean

Согласованность RCG.

Варианты:

  • false
  • true

new_rcg_name

string

Имя RCG, на которое нужно переименовать.

password

string / required

Пароль узла PowerFlex.

pause

boolean

Приостановить или возобновить RCG.

Этот параметр устарел. Используйте rcg_state вместо него.

Варианты:

  • false
  • true

pause_mode

string

Режим приостановки.

Обязателен, если pause установлен как true.

Варианты:

  • "StopDataTransfer"
  • "OnlyTrackChanges"

port

integer

Номер порта, через который происходит связь с узлом PowerFlex.

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

protection_domain_id

string

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

Взаимоисключающий с protection_domain_name.

protection_domain_name

string

Имя домена защиты.

Взаимоисключающий с protection_domain_id.

rcg_id

string

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

Взаимоисключающий с rcg_name.

rcg_name

string

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

Уникально в пределах массива PowerFlex.

Взаимоисключающий с rcg_id.

rcg_state

string

Укажите действие для RCG.

Переключить RCG.

Обратить RCG.

Восстановить RCG.

Переключиться на RCG.

Приостановить или возобновить RCG.

Заморозить или разморозить RCG.

Синхронизировать RCG.

Варианты:

  • "failover"
  • "reverse"
  • "restore"
  • "switchover"
  • "sync"
  • "pause"
  • "resume"
  • "freeze"
  • "unfreeze"

remote_peer

dictionary

Удаленная система-участник.

hostname

aliases: gateway_host

string / required

IP-адрес или FQDN удаленного шлюза-участника.

password

string / required

Пароль удаленного шлюза-участника.

port

integer

Номер порта, через который происходит связь с удаленным шлюзом-участником.

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

protection_domain_id

string

Идентификатор удалённой области защиты.

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

protection_domain_name

string

Имя удалённой области защиты.

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

timeout

integer

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

Указывается в секундах.

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

username

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

Имя пользователя хоста удалённого узла шлюза.

validate_certs

алиасы: verifycert

boolean

Булево значение для указания проверки сертификата SSL.

true - Указывает, что сертификат SSL должен быть проверен.

false - Указывает, что сертификат SSL не должен быть проверен.

Варианты:

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

rpo

integer

Желаемое значение RPO в секундах.

state

string

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

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

target_volume_access_mode

string

Режим доступа к целевому объёму.

Варианты:

  • "ReadOnly"
  • "NoAccess"

timeout

integer

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

Указывается в секундах.

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

username

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

Имя пользователя хоста PowerFlex.

validate_certs

алиасы: verifycert

boolean

Булево значение для указания проверки сертификата SSL.

true - Указывает, что сертификат SSL должен быть проверен.

false - Указывает, что сертификат SSL не должен быть проверен.

Варианты:

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

Примечания

Примечание

  • Поддерживается check_mode.
  • Идемпотентность не поддерживается для операции создания моментальной копии.
  • Возможна задержка в отражении конечного состояния RCG после нескольких операций обновления RCG.
  • В версиях 3.6 и выше группа согласованности репликации вернётся в согласованное состояние при изменении на несогласованное, если произойдет барьер согласованности. Таким образом, идемпотентность при установке в несогласованное состояние вернёт true для изменения.
  • Модули, присутствующие в коллекции под названием «dellemc.powerflex», разработаны для поддержки платформы хранения Dell PowerFlex.

Примеры

- name: Get RCG details
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "{{rcg_name}}"

- name: Create a snapshot of the RCG
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_id: "{{rcg_id}}"
    create_snapshot: true
    state: "present"

- name: Create a replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rpo: 60
    protection_domain_name: "domain1"
    activity_mode: "active"
    remote_peer:
      hostname: "{{hostname}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      port: "{{port}}"
      protection_domain_name: "domain1"

- name: Modify replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rpo: 60
    target_volume_access_mode: "ReadOnly"
    activity_mode: "Inactive"
    is_consistent: true

- name: Rename replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    new_rcg_name: "rcg_test_rename"

- name: Pause replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "pause"
    pause_mode: "StopDataTransfer"

- name: Resume replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "resume"

- name: Freeze replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "freeze"

- name: UnFreeze replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "unfreeze"

- name: Failover replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "failover"

- name: Reverse replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "reverse"

- name: Restore replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "restore"

- name: Switchover replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "switchover"

- name: Synchronize replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    rcg_state: "sync"

- name: Delete replication consistency group
  dellemc.powerflex.replication_consistency_group:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "rcg_test"
    state: "absent"

Возвращаемые значения

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

Ключ

Описание

changed

boolean

Изменился ли ресурс.

Возвращается: всегда

Пример: false

replication_consistency_group_details

dictionary

Подробная информация о группе согласованности репликации.

Возвращается: Когда группа согласованности репликации существует

Пример: {"abstractState": "Ok", "activeLocal": true, "activeRemote": true, "currConsistMode": "Consistent", "disasterRecoveryState": "None", "error": 65, "failoverState": "None", "failoverType": "None", "freezeState": "Unfrozen", "id": "aadc17d500000000", "inactiveReason": 11, "lastSnapCreationRc": "SUCCESS", "lastSnapGroupId": "e58280b300000001", "lifetimeState": "Normal", "localActivityState": "Active", "name": "test_rcg", "pauseMode": "None", "peerMdmId": "6c3d94f600000000", "protectionDomainId": "b969400500000000", "remoteActivityState": "Active", "remoteDisasterRecoveryState": "None", "remoteId": "2130961a00000000", "remoteMdmId": "0e7a082862fedf0f", "remoteProtectionDomainId": "4eeb304600000000", "remoteProtectionDomainName": "domain1", "replicationDirection": "LocalToRemote", "rpoInSeconds": 30, "snapCreationInProgress": false, "targetVolumeAccessMode": "NoAccess", "type": "User"}

abstractState

string

Абстрактное состояние группы согласованности репликации.

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

activeLocal

boolean

Является ли локальная группа согласованности репликации активной.

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

activeRemote

boolean

Является ли удалённая группа согласованности репликации активной

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

currConsistMode

string

Текущий режим согласованности группы согласованности репликации.

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

disasterRecoveryState

string

Состояние аварийного восстановления локальной группы согласованности репликации.

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

error

integer

Код ошибки группы согласованности репликации.

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

failoverState

string

Состояние отработки отказа группы согласованности репликации.

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

failoverType

string

Тип отработки отказа группы согласованности репликации.

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

freezeState

string

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

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

id

string

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

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

inactiveReason

integer

Причина неактивности группы согласованности репликации.

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

lastSnapCreationRc

integer

Код возврата последнего снимка группы согласованности репликации.

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

lastSnapGroupId

string

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

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

lifetimeState

string

Состояние жизненного цикла группы согласованности репликации.

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

localActivityState

string

Состояние активности локальной группы согласованности репликации.

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

name

string

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

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

pauseMode

string

Состояние жизненного цикла группы согласованности репликации.

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

peerMdmId

string

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

Возвращаемое значение: успех

protectionDomainId

string

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

Возвращаемое значение: успех

remoteActivityState

string

Состояние активности удаленной группы согласованности репликации.

Возвращаемое значение: успех

remoteDisasterRecoveryState

string

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

Возвращаемое значение: успех

remoteId

string

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

Возвращаемое значение: успех

remoteMdmId

string

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

Возвращаемое значение: успех

remoteProtectionDomainId

string

Идентификатор удаленного домена защиты.

Возвращаемое значение: успех

remoteProtectionDomainName

string

Название удаленного домена защиты.

Возвращаемое значение: успех

replicationDirection

string

Направление репликации группы согласованности репликации.

Возвращаемое значение: успех

rpoInSeconds

integer

Значение RPO группы согласованности репликации в секундах.

Возвращаемое значение: успех

snapCreationInProgress

boolean

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

Возвращаемое значение: успех

targetVolumeAccessMode

string

Режим доступа к целевому томо объёма группы согласованности репликации.

Возвращаемое значение: успех

type

string

Тип группы согласованности репликации.

Возвращаемое значение: успех

Авторы

  • Trisha Datta (@Trisha-Datta)
  • Jennifer John (@Jennifer-John)

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

  • Система отслеживания задач
  • Репозиторий (источники)

© 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/powerflex/replication_consistency_group_module.html

Spec-Zone.ru

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