Модуль purestorage.flasharray.purefa_pg — управление группами защиты на массивах Pure Storage FlashArray

Примечание

Этот модуль входит в коллекцию purestorage.flasharray (версия 1.42.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install purestorage.flasharray. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: purestorage.flasharray.purefa_pg.

Добавлено в purestorage.flasharray 1.0.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Создание, удаление и изменение групп защиты на массивах Pure Storage FlashArray.
Если группа защиты существует и вы пытаетесь добавить недопустимые типы объектов, например узел в группу защиты томов, модуль проигнорирует эти типы.
Поддерживаются группы защиты на целевых устройствах выгрузки.

Требования

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

python >= 3.3
purestorage >= 1.19
py-pure-client >= 1.26.0
netaddr
requests
pycountry
urllib3

Параметры

Параметр	Комментарии
api_token string	Токен API FlashArray для пользователя с правами администратора.
context string добавлено в purestorage.flasharray 1.33.0	Имя участника флота, на котором нужно выполнить операцию. Массив, получающий запрос, должен быть участником флота, а участник с указанным именем контекста должен входить в тот же флот. По умолчанию: `""`
disable_warnings boolean добавлено в purestorage.flasharray 1.29.0	Отключить предупреждения о небезопасных сертификатах в журналах отладки Варианты: `false` ← (по умолчанию) `true`
enabled boolean	Указывает, следует ли включить снимки для группы защиты. Варианты: `false` `true` ← (по умолчанию)
eradicate boolean	Указывает, следует ли окончательно удалить группу защиты при удалении или оставить её в корзине. Варианты: `false` ← (по умолчанию) `true`
fa_url string	IPv4-адрес или имя узла для управления FlashArray.
host list / elements=string	Список существующих узлов для добавления в группу защиты. Обратите внимание: имена узлов чувствительны к регистру, однако имена узлов FlashArray уникальны без учёта регистра — нельзя создать hosta и hostA
hostgroup list / elements=string	Список существующих групп узлов для добавления в группу защиты. Обратите внимание: имена групп узлов чувствительны к регистру, однако имена групп узлов FlashArray уникальны без учёта регистра — нельзя создать groupa и groupA
name псевдонимы: pgroup string / обязательный	Имя группы защиты.
rename string	Переименовать группу защиты Если исходная группа защиты находится в «контейнере» Pod или группы томов, достаточно указать новое имя группы защиты в том же «контейнере»
safe_mode boolean добавлено в purestorage.flasharray 1.13.0	Включает ограничения SafeMode для группы защиты После включения отключить эту функцию может только служба технической поддержки Pure Варианты: `false` ← (по умолчанию) `true`
state string	Указывает, должна ли группа защиты существовать. Если параметр указан вместе с volume, host или hostgroup, действие будет применено только к этим объектам в группе защиты. Варианты: `"absent"` `"present"` ← (по умолчанию)
target list / elements=string	Список удалённых массивов или целевых устройств выгрузки, к которым должна подключаться группа защиты для репликации. Обратите внимание: все реплицируемые группы защиты работают в асинхронном режиме. Целевые массивы или устройства выгрузки уже должны быть подключены к исходному массиву. Максимальное количество целевых объектов на группу защиты — 4, если ваша конфигурация это поддерживает.
volume list / elements=string	Список существующих томов для добавления в группу защиты. Обратите внимание: имена томов чувствительны к регистру, однако имена томов FlashArray уникальны без учёта регистра — нельзя создать volumea и volumeA

Примечания

Примечание

Для этого модуля требуются библиотеки Python purestorage и py-pure-client.
Для отдельных модулей могут потребоваться дополнительные библиотеки Python.
Если аргументы fa_url и api_token не передаются непосредственно модулю, необходимо задать переменные окружения PUREFA_URL и PUREFA_API.

Примеры

- name: Create new local protection group
  purestorage.flasharray.purefa_pg:
    name: foo
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create new protection group called bar in pod called foo
  purestorage.flasharray.purefa_pg:
    name: "foo::bar"
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create new replicated protection group
  purestorage.flasharray.purefa_pg:
    name: foo
    target:
      - arrayb
      - arrayc
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create new replicated protection group to offload target and remote array
  purestorage.flasharray.purefa_pg:
    name: foo
    target:
      - offload
      - arrayc
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create new protection group with snapshots disabled
  purestorage.flasharray.purefa_pg:
    name: foo
    enabled: false
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete protection group
  purestorage.flasharray.purefa_pg:
    name: foo
    eradicate: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Eradicate protection group foo on offload target where source array is arrayA
  purestorage.flasharray.purefa_pg:
    name: "arrayA:foo"
    target: offload
    eradicate: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Rename protection group foo in pod arrayA to bar
  purestorage.flasharray.purefa_pg:
    name: "arrayA::foo"
    rename: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create protection group for hostgroups
  purestorage.flasharray.purefa_pg:
    name: bar
    hostgroup:
      - hg1
      - hg2
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create protection group for hosts
  purestorage.flasharray.purefa_pg:
    name: bar
    host:
      - host1
      - host2
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create replicated protection group for volumes
  purestorage.flasharray.purefa_pg:
    name: bar
    volume:
      - vol1
      - vol2
    target: arrayb
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Remove a volume from protection group
  purestorage.flasharray.purefa_pg:
    name: bar
    volume:
      - vol1
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Авторы

Команда Ansible Pure Storage (@sdodsley)

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

© 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/purestorage/flasharray/purefa_pg_module.html