Модуль dellemc.openmanage.idrac_os_deployment — Загрузка с сетевого ISO-образа

Примечание

Этот модуль является частью коллекции dellemc.openmanage (версия 9.7.0).

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

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

Для использования в книге задач укажите: dellemc.openmanage.idrac_os_deployment.

Новая в dellemc.openmanage 2.1.0

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Загрузка с сетевого ISO-образа.

Требования

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

omsdk >= 1.2.488
python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path путь добавлен в dellemc.openmanage 5.0.0	Файл PEM (Privacy Enhanced Mail), содержащий сертификат CA, используемый для проверки.
expose_duration целое число	Время в минутах, в течение которого образ ISO доступен как локальное устройство CD-ROM для хост-сервера. После истечения времени образ ISO автоматически отсоединяется. По умолчанию: `1080`
idrac_ip строка / обязательно	IP-адрес iDRAC.
idrac_password псевдонимы: idrac_pwd строка / обязательно	Пароль пользователя iDRAC. Если пароль не указан, используется переменная среды `IDRAC_PASSWORD`. Пример: export IDRAC_PASSWORD=password
idrac_port целое число	Порт iDRAC. По умолчанию: `443`
idrac_user строка / обязательно	Имя пользователя iDRAC. Если имя пользователя не указано, используется переменная среды `IDRAC_USERNAME`. Пример: export IDRAC_USERNAME=username
iso_image строка / обязательно	Имя сетевого ISO-образа.
share_name строка / обязательно	Сеть CIFS или NFS.
share_password псевдонимы: share_pwd строка	Пароль пользователя сетевой папки. Этот параметр обязателен для сетевой папки CIFS.
share_user строка	Пользователь сетевой папки в формате ‘user@domain’ или ‘domain\\user’, если пользователь является частью домена, иначе ‘user’. Этот параметр обязателен для сетевой папки CIFS.
timeout целое число добавлен в dellemc.openmanage 5.0.0	Таймаут уровня сокета в секундах. По умолчанию: `30`
validate_certs логическое значение добавлен в dellemc.openmanage 5.0.0	Если `false`, сертификаты SSL не будут проверены. Настраивайте `false` только на контролируемых вами сайтах, где используются самозаверяющие сертификаты. До версии `5.0.0` коллекции параметр validate_certs был `false` по умолчанию. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Выполняйте этот модуль с системы, имеющей прямой доступ к Dell iDRAC.
Этот модуль поддерживает как IPv4, так и IPv6 адреса для idrac_ip.
Этот модуль не поддерживает check_mode.

Примеры

---
- name: Boot to Network ISO
  dellemc.openmanage.idrac_os_deployment:
      idrac_ip: "192.168.0.1"
      idrac_user: "user_name"
      idrac_password: "user_password"
      ca_path: "/path/to/ca_cert.pem"
      share_name: "192.168.0.0:/nfsfileshare"
      iso_image: "unattended_os_image.iso"
      expose_duration: 180

Значения возврата

Общие значения возврата документированы здесь, ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
boot_status словарь	Подробности операции загрузки по сети с ISO-образом. Возвращается: всегда Пример: `{"DeleteOnCompletion": "false", "InstanceID": "DCIM_OSDConcreteJob:1", "JobName": "BootToNetworkISO", "JobStatus": "Success", "Message": "The command was successful.", "MessageID": "OSD1", "Name": "BootToNetworkISO", "Status": "Success", "file": "192.168.0.0:/nfsfileshare/unattended_os_image.iso", "retval": true}`
msg строка	Общее состояние устройства. Возвращается: при ошибке Пример: `"Failed to boot to network iso"`

Ключ

Описание

boot_status

словарь

Подробности операции загрузки по сети с ISO-образом.

Возвращается: всегда

Пример: {"DeleteOnCompletion": "false", "InstanceID": "DCIM_OSDConcreteJob:1", "JobName": "BootToNetworkISO", "JobStatus": "Success", "Message": "The command was successful.", "MessageID": "OSD1", "Name": "BootToNetworkISO", "Status": "Success", "file": "192.168.0.0:/nfsfileshare/unattended_os_image.iso", "retval": true}

msg

строка

Общее состояние устройства.

Возвращается: при ошибке

Пример: "Failed to boot to network iso"

Авторы

Felix Stephen (@felixs88)
Jagadeesh N V (@jagadeeshnv)

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

© 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/dellemc/openmanage/idrac_os_deployment_module.html