purestorage.flasharray.purefa_host – Управление хостами на массивах Pure Storage FlashArrays

Примечание

Этот плагин входит в коллекцию purestorage.flasharray (версия 1.5.1).

Для его установки используйте: ansible-galaxy collection install purestorage.flasharray.

Для использования в плейбуке укажите: purestorage.flasharray.purefa_host.

В версии 1.0.0: из purestorage.flasharray

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

Обзор

Создание, удаление или изменение хостов на массивах Pure Storage FlashArrays.

Требования

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

python >= 2.7
purestorage >= 1.19
py-pure-client >= 1.6.0
netaddr
requests

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_token строка		Токен API FlashArray для пользователя с привилегиями администратора.
count целое число		Количество хостов, которые должны быть созданы при массовом создании. Поддерживается только с Purity//FA v6.0.0 и выше
digits целое число	Значение по умолчанию: 1	Количество цифр, используемых для индексации при массовом создании хостов. Это добавляет нули в индексы при необходимости. Поддерживается только с Purity//FA v6.0.0 и выше Диапазон значений от 1 до 10
fa_url строка		IP-адрес или имя хоста управления FlashArray (IPv4).
host_password строка		Устанавливает пароль хоста для аутентификации CHAP. Длина пароля должна быть от 12 до 255 символов. Для удаления пары имя пользователя/пароль используйте clear в качестве пароля. УСТАНОВЛЕНИЕ ПАРОЛЯ НЕ ЯВЛЯЕТСЯ ИДЕМПОТЕНТНЫМ
host_user строка		Устанавливает имя пользователя хоста для аутентификации CHAP. Требуется вместе с host_password Для удаления пары имя пользователя/пароль используйте clear в качестве пароля.
iqn список / элементы=строка		Список IQN хоста, если протокол iscsi или mixed.
lun целое число		Идентификатор LUN для назначения тома хосту. Должен быть уникальным. Если не указан, ID будет назначен автоматически. Диапазон значений ID LUN от 1 до 4095.
name строка / обязательно		Имя хоста. Обратите внимание, что имена хостов чувствительны к регистру, однако имена хостов FlashArray уникальны и нечувствительны к регистру - вы не можете иметь hosta и hostA Поддержка множественных хостов доступна с Purity//FA 6.0.0 *ПРИМЕЧАНИЕ* Ручное удаление отдельных хостов, созданных с помощью массового создания, приведет к ошибке идемпотентности Поддержка множественных хостов существует только для создания хостов псевдонимы: host
nqn список / элементы=строка		Список NQN хоста, если протокол nvme или mixed.
personality строка	Варианты: hpux vms aix esxi solaris hitachi-vsp oracle-vm-server delete ←	Определяет операционную систему хоста. Рекомендуется для интеграции ActiveCluster.
preferred_array список / элементы=строка		Список предпочтительных массивов в среде ActiveCluster. Для удаления существующих предпочтительных массивов с хоста укажите delete.
protocol строка	Варианты: fc iscsi ← nvme mixed	Определяет протокол подключения хоста для томов.
rename строка		Новое имя для переименования. Обратите внимание, что имена хостов чувствительны к регистру, однако имена хостов FlashArray уникальны и нечувствительны к регистру - вы не можете иметь hosta и hostA
start целое число	Значение по умолчанию: 0	Номер, с которого начинается индекс массового создания хостов. Поддерживается только с Purity//FA v6.0.0 и выше
state строка	Варианты: absent present ←	Определяет, должен ли существовать хост. При удалении хоста все подключенные тома будут отключены.
suffix строка		Строка суффикса, если требуется, для создания нескольких хостов. Имена хостов будут сформированы как <name>#I<suffix>, где # - placeholder для индекса хоста. См. соответствующие описания. Поддерживается только с Purity//FA v6.0.0 и выше
target_password строка		Устанавливает пароль целевого устройства для аутентификации CHAP. Длина пароля должна быть от 12 до 255 символов. Для удаления пары имя пользователя/пароль используйте clear в качестве пароля. УСТАНОВЛЕНИЕ ПАРОЛЯ НЕ ЯВЛЯЕТСЯ ИДЕМПОТЕНТНЫМ
target_user строка		Устанавливает имя пользователя целевого устройства для аутентификации CHAP. Требуется вместе с target_password Для удаления пары имя пользователя/пароль используйте clear в качестве пароля.
volume строка		Имя тома, который нужно сопоставить с хостом.
wwns список / элементы=строка		Список wwns хоста, если протокол fc или mixed.

Примечания

Примечание

При указании lun параметра убедитесь, что поддерживается хостом требуемое значение.
Этот модуль требует библиотеки purestorage Python.
Вы должны установить PUREFA_URL и PUREFA_API переменные среды, если аргументы fa_url и api_token не переданы в модуль напрямую.

Примеры

- name: Create new AIX host
  purefa_host:
    name: foo
    personality: aix
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create 10 hosts with index starting at 10 but padded with 3 digits
  purefa_host:
    name: foo
    personality: vms
    suffix: bar
    count: 10
    start: 10
    digits: 3
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

- name: Rename host foo to bar
  purefa_host:
    name: foo
    rename: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete host
  purefa_host:
    name: foo
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Make host bar with wwn ports
  purefa_host:
    name: bar
    protocol: fc
    wwns:
    - 00:00:00:00:00:00:00
    - 11:11:11:11:11:11:11
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Make host bar with iSCSI ports
  purefa_host:
    name: bar
    protocol: iscsi
    iqn:
    - iqn.1994-05.com.redhat:7d366003913
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Make host bar with NVMe ports
  purefa_host:
    name: bar
    protocol: nvme
    nqn:
    - nqn.2014-08.com.vendor:nvme:nvm-subsystem-sn-d78432
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Make mixed protocol host
  purefa_host:
    name: bar
    protocol: mixed
    nqn:
    - nqn.2014-08.com.vendor:nvme:nvm-subsystem-sn-d78432
    iqn:
    - iqn.1994-05.com.redhat:7d366003914
    wwns:
    - 00:00:00:00:00:00:01
    - 11:11:11:11:11:11:12
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Map host foo to volume bar as LUN ID 12
  purefa_host:
    name: foo
    volume: bar
    lun: 12
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Disconnect volume bar from host foo
  purefa_host:
    name: foo
    volume: bar
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Add preferred arrays to host foo
  purefa_host:
    name: foo
    preferred_array:
    - array1
    - array2
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete preferred arrays from host foo
  purefa_host:
    name: foo
    preferred_array: delete
    fa_url: 10.10.10.2

- name: Set CHAP target and host username/password pairs
  purefa_host:
    name: foo
    target_user: user1
    target_password: passwrodpassword
    host_user: user2
    host_password: passwrodpassword
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete CHAP target and host username/password pairs
  purefa_host:
    name: foo
    target_user: user
    target_password: clear
    host_user: user
    host_password: clear
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Авторы

Команда Pure Storage Ansible (@sdodsley) <pure-ansible-team@purestorage.com>

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/purestorage/flasharray/purefa_host_module.html