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

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.idrac_os_deployment.

Добавлено в dellemc.openmanage 2.1.0

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

Описание

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

Требования

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

python >= 3.9.6

Параметры

Параметр	Описание
ca_path путь добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат 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` ← (по умолчанию)
x_auth_token строка добавлено в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная среды `IDRAC_X_AUTH_TOKEN`. Пример: export IDRAC_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Запускайте этот модуль в системе, имеющей прямой доступ к 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)
Abhishek Sinha (@ABHISHEK-SINHA10)
Bhavneet Sharma (@Bhavneet-Sharma)

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

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