Spec-Zone.ru › Ansible

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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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

FlashArray API токен для пользователя с правами администратора.

count

integer

Количество хостов, которые будут созданы при создании нескольких хостов

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

digits

integer

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

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

Диапазон от 1 до 10

Default: 1

disable_warnings

boolean

added in purestorage.flasharray 1.29.0

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

Choices:

  • false ← (default)
  • true

fa_url

string

FlashArray IP-адрес управления IPv4 или имя хоста.

host_password

string

Устанавливает пароль хоста для CHAP-аутентификации

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

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

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

host_user

string

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

Требуется с host_password

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

iqn

list / elements=string

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

lun

integer

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

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

Диапазон для идентификатора LUN - от 1 до 4095.

name

aliases: host

string / required

Имя хоста.

Обратите внимание, что имена хостов учитывают регистр, однако имена хостов FlashArray уникальны и игнорируют регистр - вы не можете иметь hosta и hostA

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

Поддержка множества хостов существует только для создания хостов

nqn

list / elements=string

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

personality

string

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

Choices:

  • "hpux"
  • "vms"
  • "aix"
  • "esxi"
  • "solaris"
  • "hitachi-vsp"
  • "oracle-vm-server"
  • "delete"
  • "" ← (default)

preferred_array

list / elements=string

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

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

protocol

string

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

УСТАРЕЛ. Больше не является необходимым параметром

Choices:

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

rename

string

Имя для переименования.

Обратите внимание, что имена хостов учитывают регистр, однако имена хостов FlashArray уникальны и игнорируют регистр - вы не можете иметь hosta и hostA

start

integer

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

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

Default: 0

state

string

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

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

Choices:

  • "absent"
  • "present" ← (default)

suffix

string

Суффиксная строка, если требуется, для создания нескольких хостов

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

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

Поддерживается только начиная с Purity//FA v6.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 / elements=string

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

Примечания

Примечание

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

Примеры

- 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 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
    - 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
    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
  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 exisitng 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

Авторы

  • Команда 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_host_module.html

Spec-Zone.ru

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