purefa_host – Управление хостами на Pure Storage FlashArrays
Новая версия 2.4.
Обзор
- Создание, удаление или изменение хостов на Pure Storage FlashArrays.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.7
- purestorage
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_token строка / обязательно | Токен API FlashArray для пользователя с правами администратора. | |
| fa_url строка / обязательно | IP-адрес управления FlashArray или имя хоста (IPv4). | |
| host строка / обязательно | Имя хоста. | |
| iqn список | Список IQN хоста, если протокол iSCSI или смешанный. | |
| lun целое число добавлено в 2.8 | Идентификатор LUN для назначения тома хосту. Должен быть уникальным. Если не указан, идентификатор будет назначен автоматически. Диапазон идентификаторов LUN от 1 до 4095. | |
| nqn список добавлено в 2.8 | Список NQN хоста, если протокол NVMe или смешанный. | |
| personality строка добавлено в 2.7 |
| Определяет операционную систему хоста. Рекомендуется для интеграции с ActiveCluster. |
| preferred_array список добавлено в 2.9 | Список предпочтительных массивов в среде ActiveCluster. Чтобы удалить существующие предпочтительные массивы с хоста, укажите delete. | |
| protocol строка |
| Определяет протокол подключения хоста для томов. |
| state строка |
| Определяет, должен ли существовать хост. При удалении хоста все подключенные тома будут отключены. |
| volume строка | Имя тома для сопоставления с хостом. | |
| wwns список | Список wwns хоста, если протокол FC или смешанный. |
Примечания
Примечание
- При указании
lunпараметра убедитесь, что хост поддерживает запрашиваемое значение. - Для работы этого модуля требуется библиотека Python
purestorage. - Необходимо установить переменные среды
PUREFA_URLиPUREFA_API, если параметры fa_url и api_token не передаются в модуль напрямую.
Примеры
- name: Create new AIX host
purefa_host:
host: foo
personaility: aix
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Delete host
purefa_host:
host: 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:
host: 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:
host: 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:
host: 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:
host: 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:
host: foo
volume: bar
lun: 12
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Add preferred arrays to host foo
purefa_host:
host: 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:
host: foo
preferred_array: delete
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Команда Ansible Pure Storage (@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.9/modules/purefa_host_module.html