Spec-Zone.ru › Ansible

Модуль purestorage.flasharray.purefa_host — управление хостами в Pure Storage FlashArrays

Примечание

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

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

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

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

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

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

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

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

Требования

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

  • 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

Имя участника флота, на котором нужно выполнить операцию.

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

По умолчанию: ""

count

integer

Количество хостов, создаваемых при массовом создании.

Поддерживается только в Purity//FA версии 6.0.0 и выше.

digits

integer

Количество цифр для счётчика массового создания хостов. При необходимости индекс дополняется нулями.

Поддерживается только в Purity//FA версии 6.0.0 и выше.

Допустимый диапазон: от 1 до 10.

По умолчанию: 1

disable_warnings

boolean

добавлено в purestorage.flasharray 1.29.0

Отключить предупреждения о небезопасных сертификатах в журналах отладки.

Варианты:

  • false ← (по умолчанию)
  • true

fa_url

string

IPv4-адрес или имя узла для управления FlashArray.

host_password

string

Задаёт пароль хоста для аутентификации CHAP.

Длина пароля должна составлять от 12 до 255 символов.

Чтобы очистить пару «имя пользователя/пароль», укажите в качестве пароля clear.

УСТАНОВКА ПАРОЛЯ НЕ ЯВЛЯЕТСЯ ИДЕМПОТЕНТНОЙ ОПЕРАЦИЕЙ.

host_user

string

Задаёт имя пользователя хоста для аутентификации CHAP.

Требуется вместе с host_password.

Чтобы очистить пару «имя пользователя/пароль», укажите в качестве пароля clear.

iqn

list / элементы=string

Список IQN хоста.

lun

integer

Идентификатор LUN, назначаемый тому для хоста. Должен быть уникальным.

Если значение не указано, идентификатор будет назначен автоматически.

Допустимый диапазон идентификаторов LUN: от 1 до 4095.

modify_resource_access

string

добавлено в purestorage.flasharray 1.35.0

Определяет, как изменять доступ к ресурсу при его перемещении.

Значение none указывает, что доступ к ресурсу изменять не нужно.

Значение create используется, когда ресурс перемещается из области в массив и для него необходимо создать доступ из области, из которой он перемещается.

Значение delete используется, когда ресурс перемещается из массива в область, к которой для этого ресурса уже предоставлен доступ.

Варианты:

  • "none" ← (по умолчанию)
  • "create"
  • "delete"

move

list / элементы=string

добавлено в purestorage.flasharray 1.35.0

Перемещение хоста в локальные области участника или из них либо в локальный массив или из него.

Укажите имена областей, в которые нужно переместить хост.

Чтобы переместить хост в локальный массив, укажите local.

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

name

псевдонимы: host

string / обязательный

Имя хоста.

Обратите внимание: имена хостов чувствительны к регистру, однако имена хостов FlashArray уникальны без учёта регистра — нельзя создать хосты hosta и hostA.

Массовое создание хостов поддерживается начиная с Purity//FA 6.0.0. ***ПРИМЕЧАНИЕ*** Удаление отдельных хостов, созданных при массовом создании, вручную приведёт к нарушению идемпотентности.

Массовое создание поддерживается только при создании хостов.

nqn

list / элементы=string

Список NQN хоста. Обратите внимание: хосты NVMe могут иметь только NQN. Для этих хостов не допускается использование нескольких протоколов.

personality

string

Определяет операционную систему хоста. Рекомендуется для интеграции с ActiveCluster.

Варианты:

  • "hpux"
  • "vms"
  • "aix"
  • "esxi"
  • "solaris"
  • "hitachi-vsp"
  • "oracle-vm-server"
  • "delete"
  • "" ← (по умолчанию)

preferred_array

list / элементы=string

Список предпочтительных массивов в среде ActiveCluster.

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

protocol

string

Определяет протокол подключения хоста для томов.

УСТАРЕЛО. Этот параметр больше не требуется.

Варианты:

  • "fc"
  • "iscsi"
  • "nvme"
  • "mixed"

rename

string

Имя, которое нужно присвоить хосту.

Обратите внимание: имена хостов чувствительны к регистру, однако имена хостов FlashArray уникальны без учёта регистра — нельзя создать хосты hosta и hostA.

start

integer

Начальное значение индекса для массового создания хостов.

Поддерживается только в Purity//FA версии 6.0.0 и выше.

По умолчанию: 0

state

string

Определяет, должен ли хост существовать.

При удалении хоста все подключённые тома будут отключены.

Варианты:

  • "absent"
  • "present" ← (по умолчанию)

suffix

string

Строка суффикса для массового создания хостов (если требуется).

Имена хостов формируются по шаблону <name>#<suffix>, где # — обозначение индекса хоста. См. соответствующие описания.

Строка суффикса необязательна.

Поддерживается только в Purity//FA версии 6.0.0 и выше.

target_password

string

Задаёт пароль целевого устройства для аутентификации CHAP.

Длина пароля должна составлять от 12 до 255 символов.

Чтобы очистить пару «имя пользователя/пароль», укажите в качестве пароля clear.

УСТАНОВКА ПАРОЛЯ НЕ ЯВЛЯЕТСЯ ИДЕМПОТЕНТНОЙ ОПЕРАЦИЕЙ.

target_user

string

Задаёт имя пользователя целевого устройства для аутентификации CHAP.

Требуется вместе с target_password.

Чтобы очистить пару «имя пользователя/пароль», укажите в качестве пароля clear.

vlan

string

добавлено в purestorage.flasharray 1.16.0

Идентификатор VLAN, с которым связан хост.

Если значение не задано или равно any, хост может обращаться к любой VLAN.

Если задано значение untagged, хост может обращаться только к VLAN без тегов.

Если задано число от 1 до 4094, хост может обращаться только к VLAN с указанным номером.

volume

string

Имя тома, который нужно сопоставить с хостом.

wwns

list / элементы=string

Список WWN хоста.

Примечания

Примечание

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

Примеры

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

- name: Create host bar in existing realm foo
  purestorage.flasharray.purefa_host:
    name: foo::bar
    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
  purestorage.flasharray.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
  purestorage.flasharray.purefa_host:
    name: foo
    rename: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete host
  purestorage.flasharray.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
  purestorage.flasharray.purefa_host:
    name: bar
    wwns:
    - 00:00:00:00:00:00:00:00
    - 11: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
  purestorage.flasharray.purefa_host:
    name: bar
    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
  purestorage.flasharray.purefa_host:
    name: bar
    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
  purestorage.flasharray.purefa_host:
    name: bar
    iqn:
    - iqn.1994-05.com.redhat:7d366003914
    wwns:
    - 00:00:00:00:00:00:00:01
    - 11: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
  purestorage.flasharray.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
  purestorage.flasharray.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
  purestorage.flasharray.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
  purestorage.flasharray.purefa_host:
    name: foo
    preferred_array: delete
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete existing WWNs from host foo (does not delete host object)
  purestorage.flasharray.purefa_host:
    name: foo
    wwns: ""
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Set CHAP target and host username/password pairs
  purestorage.flasharray.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
  purestorage.flasharray.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

- name: Move host foo from the array to realm bar
  purestorage.flasharray.purefa_host:
    name: foo
    move: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Move host foo from realm bar back to array
  purestorage.flasharray.purefa_host:
    name: bar::foo
    move: local
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Rename host foo in realm test to bar
  purestorage.flasharray.purefa_host:
    name: test::foo
    rename: test::bar
    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_host_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API