Модуль community.general.open_iscsi – Управление целями iSCSI с помощью Open-iSCSI

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.

Для использования в playbook, укажите: community.general.open_iscsi.

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

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

Обнаружение целей на заданном портале, (от)ключение целей, пометка целей для ручного или автоматического запуска, возврат узлов устройств подключенных целей.

Требования

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

Библиотека и инструменты open_iscsi (iscsiadm)

Параметры

Параметр	Комментарии
auto_node_startup псевдонимы: automatic boolean	Должен ли узел цели автоматически подключаться при запуске. Варианты: `false` `true`
auto_portal_startup boolean добавлено в community.general 3.2.0	Должен ли портал узла цели автоматически подключаться при запуске. Варианты: `false` `true`
discover boolean	Должен ли список узлов цели на портале быть (пере)обнаружен и добавлен в постоянную базу данных iSCSI. Учтите, что обнаружение `iscsiadm` сбрасывает конфигурацию, например, `node.startup` на ручной режим, поэтому в сочетании с `auto_node_startup=true` всегда будет возвращать измененное состояние. Варианты: `false` ← (по умолчанию) `true`
login псевдонимы: state boolean	Должен ли узел цели быть подключен. Когда `target` пропущен, будет выполнено подключение ко всем доступным. Варианты: `false` `true`
node_auth string	Значение для `node.session.auth.authmethod`. Значение по умолчанию: `"CHAP"`
node_pass string	Значение для `node.session.auth.password`.
node_pass_in string добавлено в community.general 3.8.0	Значение для `node.session.auth.password_in`.
node_user string	Значение для `node.session.auth.username`.
node_user_in string добавлено в community.general 3.8.0	Значение для `node.session.auth.username_in`.
port string	Порт, на котором прослушивает процесс целевого объекта iSCSI. Значение по умолчанию: `"3260"`
portal псевдонимы: ip string	Доменное имя или IP-адрес целевого объекта iSCSI.
rescan boolean добавлено в community.general 4.1.0	Повторное сканирование установленного сеанса для обнаружения новых целей. Когда `target` пропущен, будет выполнено повторное сканирование всех сеансов. Варианты: `false` ← (по умолчанию) `true`
show_nodes boolean	Должен ли список узлов в постоянной базе данных iSCSI возвращаться модулем. Варианты: `false` ← (по умолчанию) `true`
target псевдонимы: name, targetname string	Имя целевого объекта iSCSI.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в `check_mode` и возвращать прогноз состояния изменения без модификации целевого объекта.
diff_mode	Поддержка: нет	Возвращает подробности о том, что изменилось (или, возможно, нуждается в изменении в `check_mode`), когда используется режим сравнения.

Примеры

- name: Perform a discovery on sun.com and show available target nodes
  community.general.open_iscsi:
    show_nodes: true
    discover: true
    portal: sun.com

- name: Perform a discovery on 10.1.2.3 and show available target nodes
  community.general.open_iscsi:
    show_nodes: true
    discover: true
    ip: 10.1.2.3

- name: Discover targets on portal and login to the ones available
  community.general.open_iscsi:
    portal: '{{ iscsi_target }}'
    login: true
    discover: true

- name: Connect to the named target, after updating the local persistent database (cache)
  community.general.open_iscsi:
    login: true
    target: iqn.1986-03.com.sun:02:f8c1f9e0-c3ec-ec84-c9c9-8bfb0cd5de3d

- name: Disconnect from the cached named target
  community.general.open_iscsi:
    login: false
    target: iqn.1986-03.com.sun:02:f8c1f9e0-c3ec-ec84-c9c9-8bfb0cd5de3d

- name: Override and disable automatic portal login on specific portal
  community.general.open_iscsi:
    login: false
    portal: 10.1.1.250
    auto_portal_startup: false
    target: iqn.1986-03.com.sun:02:f8c1f9e0-c3ec-ec84-c9c9-8bfb0cd5de3d

- name: Rescan one or all established sessions to discover new targets (omit target for all sessions)
  community.general.open_iscsi:
    rescan: true
    target: iqn.1986-03.com.sun:02:f8c1f9e0-c3ec-ec84-c9c9-8bfb0cd5de3d

Авторы

Serge van Ginderachter (@srvg)

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

© 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/community/general/open_iscsi_module.html