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

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: community.general.open_iscsi.

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

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

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

Требования

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

open_iscsi library and tools iscsiadm

Параметры

Параметр	Комментарии
auto_node_startup псевдонимы: automatic логическое значение	Следует ли автоматически подключать целевой узел при запуске. Варианты: `false` `true`
auto_portal_startup логическое значение добавлено в community.general 3.2.0	Следует ли автоматически подключать портал целевого узла при запуске. Варианты: `false` `true`
discover логическое значение	Следует ли (повторно) обнаружить список целевых узлов на портале и добавить его в постоянную базу данных iSCSI. Обратите внимание: обнаружение `iscsiadm` сбрасывает конфигурацию, например `node.startup` на ручной режим, поэтому в сочетании с `auto_node_startup=true` всегда возвращается состояние «изменено». Варианты: `false` ← (по умолчанию) `true`
login псевдонимы: state логическое значение	Следует ли подключать целевой узел. Если `target` не указано, выполняется вход на все доступные узлы. Варианты: `false` `true`
node_auth строка	Значение для `node.session.auth.authmethod`. По умолчанию: `"CHAP"`
node_pass строка	Значение для `node.session.auth.password`.
node_pass_in строка добавлено в community.general 3.8.0	Значение для `node.session.auth.password_in`.
node_user строка	Значение для `node.session.auth.username`.
node_user_in строка добавлено в community.general 3.8.0	Значение для `node.session.auth.username_in`.
port строка	Порт, на котором прослушивает процесс цели iSCSI. По умолчанию: `"3260"`
portal псевдонимы: ip строка	Доменное имя или IP-адрес цели iSCSI.
rescan логическое значение добавлено в community.general 4.1.0	Повторно просканировать установленный сеанс для обнаружения новых целей. Если `target` не указано, повторно сканируются все сеансы. Варианты: `false` ← (по умолчанию) `true`
show_nodes логическое значение	Следует ли возвращать модулем список узлов из постоянной базы данных iSCSI. Варианты: `false` ← (по умолчанию) `true`
target псевдонимы: name, targetname строка	Имя цели 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/open_iscsi_module.html