Модуль infinidat.infinibox.infini_map — создание и удаление сопоставления тома с хостом или кластером в Infinibox

Примечание

Этот модуль входит в коллекцию infinidat.infinibox (версия 1.6.3).

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

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

Чтобы использовать модуль в плейбуке, укажите: infinidat.infinibox.infini_map.

Добавлено в infinidat.infinibox 2.9.0

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

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

Этот модуль создает или удаляет сопоставления томов с хостами или кластерами в Infinibox.
Для хостов Linux после вызова этого модуля при создании сопоставлений плейбук должен выполнить на хосте команду “rescan-scsi-bus.sh”.
При удалении сопоставлений следует вызвать команду “rescan-scsi-bus.sh --remove”.
Для хостов Windows можно использовать “‘rescan’ | diskpart” или “Update-HostStorageCache”.

Требования

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

python2 >= 2.7 или python3 >= 3.6
infinisdk (https://infinisdk.readthedocs.io/en/latest/)

Параметры

Параметр	Комментарии
cluster string	Имя кластера
host string	Имя хоста
lun integer	LUN тома.
password string / обязательный	Пароль пользователя Infinibox.
state string	Создает сопоставление, если оно присутствует, или удаляет его, если оно отсутствует; при значении stat возвращает сведения о сопоставлении. Варианты: `"stat"` `"present"` ← (по умолчанию) `"absent"`
stay_logged_in boolean	Если значение равно True, сохраняет сеанс API на диске. Загружает сохраненный сеанс при последующих вызовах модуля. Сохраненные сеансы можно использовать только в течение времени, заданного параметром stay_logged_in_minutes. Варианты: `false` ← (по умолчанию) `true`
stay_logged_in_minutes integer	Количество минут, в течение которых можно повторно использовать сохраненный сеанс. По истечении этого времени данные сеанса будут удалены. Это значение должно быть меньше времени ожидания сеанса IBOX. По умолчанию: `5`
system string / обязательный	Имя хоста Infinibox или адрес IPv4.
user string / обязательный	Имя пользователя Infinibox с достаточными привилегиями (см. примечания).
volume string / обязательный	Имя тома, сопоставляемого с хостом.

Примечания

Примечание

Для этого модуля требуется библиотека Python infinisdk.
Если аргументы user и password не переданы непосредственно модулю, необходимо задать переменные окружения INFINIBOX_USER и INFINIBOX_PASSWORD.
Если учетные данные не указаны, Ansible использует файл конфигурации infinisdk ~/.infinidat/infinisdk.ini. См. http://infinisdk.readthedocs.io/en/latest/getting_started.html
Все модули Infinidat поддерживают режим проверки (--check). Однако пробный запуск, создающий ресурсы, может завершиться с ошибкой, если зависимости ресурсов для задачи не выполнены. Например, рассмотрим задачу создания тома в пуле. Если пул не существует, задача создания тома завершится с ошибкой. Это произойдет даже в том случае, если в плейбуке есть предыдущая задача создания пула, которая не выполнилась, поскольку создание пула также было частью пробного запуска.

Примеры

- name: Map a volume to an existing host
  infini_map:
    host: foo.example.com
    volume: bar
    state: present  # Default
    user: admin
    password: secret
    system: ibox001

- name: Map a volume to an existing cluster
  infini_map:
    cluster: test-cluster
    volume: bar
    state: present  # Default
    user: admin
    password: secret
    system: ibox001

- name: Unmap volume bar from host foo.example.com
  infini_map:
    host: foo.example.com
    volume: bar
    state: absent
    system: ibox01
    user: admin
    password: secret

- name: Stat mapping of volume bar to host foo.example.com
  infini_map:
    host: foo.example.com
    volume: bar
    state: stat
    system: ibox01
    user: admin
    password: secret

Авторы

David Ohlemacher (@ohlemacher)

Ссылки на коллекцию

© 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/infinidat/infinibox/infini_map_module.html