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: of 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.
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 строка		Строка суффикса, если требуется, для многохостового создания. Имена хостов будут формироваться как <имя>#I<суффикс>, где # — заполнитель для индекса хоста. См. соответствующие описания. Поддерживается только начиная с Purity//FA v6.0.0 и выше
target_password строка		Устанавливает пароль целевого устройства для аутентификации CHAP. Длина пароля должна быть между 12 и 255 символами. Для сброса пары имя пользователя/пароль используйте clear в качестве пароля. УСТАНОВКА ПАРОЛЯ НЕ ЯВЛЯЕТСЯ ИДЕМПОТЕНТНОЙ
target_user строка		Устанавливает имя пользователя целевого устройства для аутентификации CHAP. Требуется вместе с target_password Для сброса пары имя пользователя/пароль используйте clear в качестве пароля.
volume строка		Имя тома, который нужно сопоставить с хостом.
wwns список / элементы=строка		Список wwns хоста, если протокол fc или mixed.

Примечания

Примечание

При указании lun параметра убедитесь, что поддерживается хост.
Этот модуль требует библиотеку Python purestorage
Вы должны установить переменные среды 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

Авторы

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

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