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

Примечание

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

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

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

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

Примечания

Примечание

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

Примеры

- 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

Авторы

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

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

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