dellemc.openmanage.idrac_os_deployment 模块 – 网络 ISO 镜像启动

注意

此模块是 dellemc.openmanage 集合 (版本 9.9.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install dellemc.openmanage。您需要其他要求才能使用此模块，请参阅 要求 了解详细信息。

要在 playbook 中使用它，请指定：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 中添加	包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。
expose_duration 整数	这是将 ISO 镜像文件作为本地 CD-ROM 设备公开到主机服务器所需的时间（以分钟为单位）。当时间到期时，ISO 镜像将自动分离。 默认值： 1080
idrac_ip 字符串 / 必需	iDRAC IP 地址。
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 的系统运行此模块。

• 此模块支持 idrac_ip 的 IPv4 和 IPv6 地址。

• 此模块不支持 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}
消息 字符串	整体设备信息状态。 返回：出错时 示例： "Failed to boot to network iso"

作者

• Felix Stephen (@felixs88)

• Jagadeesh N V (@jagadeeshnv)

资源链接

• 问题追踪
• 主页
• 代码库 (源代码)