dellemc.openmanage.idrac_os_deployment 角色 – 用于在 iDRAC 服务器上部署操作系统的角色

注意

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

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

要安装它，请使用： ansible-galaxy collection install dellemc.openmanage。

要在剧本中使用它，请指定： dellemc.openmanage.idrac_os_deployment。

入口点 main – 用于在 iDRAC 服务器上部署操作系统的角色

dellemc.openmanage 7.5.0 中的新增功能

概要

  • 此角色使用 kickstart 配置文件生成自定义 ISO，并在 iDRAC 服务器上部署操作系统。

参数

参数

注释

ca_path

路径

包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。

delete_custom_iso

布尔值

操作系统部署完成后删除自定义 ISO。

如果 delete_custom_iso 为 true 且 wait_for_os_deployment 为 true，则将删除 ISO。

选项

  • false

  • true ← (默认)

destination

字典

将 ISO 挂载到 iDRAC 的共享路径。

共享需要写入权限才能复制生成的 ISO。

支持 CIFS、NFS、HTTP 和 HTTPS 共享。

当 is_custom_iso 为 true 时，忽略 destination。

当协议为 http、https 时，自定义 ISO 将复制到提供 Web 服务器内容的目标位置/文件夹中。

当协议为 cifs、nfs 时，自定义 ISO 将复制到本地挂载的 NFS 或 CIFS 位置。

hostname

字符串 / 必需

将复制自定义 ISO 的目标机器地址/主机名。

用作将 ISO 挂载为虚拟介质的地址/主机名。

当 protocol 为 http 或 https 时，使用 hostname 通过 SSH 复制 ISO。

当 protocol 为 nfs、cifs 时，hostname 将默认为 localhost 以复制 ISO。

当 protocol 为 http、https、nfs 或 cifs 时，hostname 将用于在 iDRAC 中挂载虚拟介质。

iso_name

字符串

自定义 ISO 文件名。如果未指定，则默认为 hostname-source.iso_name。

iso_path

路径 / 必需

用作在 iDRAC 中挂载为虚拟介质的自定义 ISO 的绝对路径。

mountpoint

路径 / 必需

复制自定义 ISO 的目标机器绝对路径。

当 protocol 为 http、https 时，mountpoint 将是提供 http/https 服务的路径。

当 protocol 为 nfs cifs 时，mountpoint 将是使用 nfs/cifs 共享挂载的本地文件夹。

os_type

字符串

基于 Linux/Windows 的 HTTP/HTTPS 共享。

选项

  • "linux" ← (默认)

  • "windows"

password

字符串

用于将自定义 ISO 挂载为虚拟介质的 http/https/cifs 共享的密码。

protocol

字符串 / 必需

用于将虚拟介质挂载到 iDRAC 的传输协议类型。

https 使用 SSH 协议将自定义 ISO 复制到 mountpoint，并使用 HTTPS 协议挂载虚拟介质。

http 使用 SSH 协议将自定义 ISO 复制到 mountpoint，并使用 HTTPS 协议挂载虚拟介质。

nfs 将自定义 ISO 复制到本地挂载的 *挂载点*，并使用 NFS 协议挂载虚拟介质。

cifs 将自定义 ISO 复制到本地挂载的 *挂载点*，并使用 CIFS 协议挂载虚拟介质。

选项

  • "https"

  • "http"

  • "nfs"

  • "cifs"

用户名

字符串

用于将自定义 ISO 挂载为虚拟介质的 http/https/cifs 共享的用户名。

eject_iso

布尔值

操作系统部署跟踪完成后弹出虚拟介质 (ISO)。

如果 *eject_iso* 为 true 且 *wait_for_os_deployment* 为 true，则将弹出 ISO。

选项

  • false

  • true ← (默认)

hostname

字符串 / 必需

iDRAC IP 地址或主机名。

https_port

整数

iDRAC 端口。

默认值： 443

https_timeout

整数

套接字级别超时（秒）。

默认值： 30

os_deployment_timeout

整数

等待操作系统部署完成的时间（分钟）。

默认值： 30

os_name

字符串

与 kickstart 文件的 jinja 模板匹配的操作系统名称。

支持 RHEL 和 ESXI 的操作系统名称及版本。

Jinja 模板文件应以 <os_name_upper>_<os_version_major>.j2 的格式存在。

当 *is_custom_iso* 为 false 时，此项为必填。

os_version

字符串

与 kickstart 文件的 jinja 模板匹配的操作系统版本。

支持的 RHEL 版本为 9.x 和 8.x，ESXI 版本为 8.x。

Jinja 模板文件应以 <os_name_upper>_<os_version_major>.j2 的格式存在。

当 *is_custom_iso* 为 false 时，此项为必填。

password

字符串

iDRAC 用户密码。

source

字典 / 必填

ISO 的 HTTP/HTTPS 共享或本地路径。

hostname

字符串

下载 ISO 的 HTTP/HTTPS 地址。

将自定义 ISO 挂载到虚拟介质的 http/https/cifs 和 nfs 的主机名。

当 *protocol* 为 http 或 https 且 *is_custom_iso* 为 false 时，*hostname* 仅适用于下载 ISO。

当 *protocol* 为 local、nfs 或 cifs 且 *is_custom_iso* 为 false 时，忽略 *hostname* 以下载 ISO。

当 *is_custom_iso* 为 true 时，将使用 *hostname* 附加虚拟介质。

is_custom_iso

布尔值

指定源 ISO 是否为自定义 ISO。

true 使用自定义 ISO，并跳过 kickstart 文件生成和自定义 ISO 编译。

当为 true 时，忽略 *destination* 并使用 *iso_path* 在 iDRAC 上挂载虚拟介质。

false 运行 kickstart 文件生成和自定义 ISO 编译。

选项

  • false ← (默认)

  • true

iso_name

字符串 / 必需

ISO 文件名。

iso_path

路径 / 必需

ISO 的绝对本地路径或 http/https 共享路径。

当 *custom_iso* 为 true 时，*iso_path* 应为 http、https、nfs 或 cifs 路径。

ks_path

路径

kickstart 文件的绝对本地路径或 http/https 共享路径。

提供 *ks_path* 时，角色将跳过 kickstart 文件的生成，并使用输入中提供的文件。

password

字符串

http、https 和 cifs 共享的密码。

*password* 仅在 *protocol* 为 http、https 下载 ISO 文件时适用。

当 *protocol* 为 http、https、c(cifs) 且 *is_custom_iso* 为 true 时，*password* 适用于在 iDRAC 中将自定义 ISO 挂载为虚拟介质。

当 *protocol* 为 local 时，忽略 *password*。

protocol

字符串 / 必需

用于下载 ISO 的传输协议类型。

https 使用 https 协议下载 ISO。

http 使用 http 协议下载 ISO。

nfs 使用本地挂载的 nfs 文件夹路径下载 ISO。

cifs 使用本地挂载的 cifs 文件夹路径下载 ISO。

local 使用本地文件夹路径下载 ISO。

如果 *custom_iso_true* 为 true，则将使用此项将自定义 ISO 挂载到虚拟介质。

选项

  • "https"

  • "http"

  • "local"

  • "cifs"

  • "nfs"

用户名

字符串

http、https 和 cifs 共享的用户名。

*username* 仅在 *protocol* 为 http、https 下载 ISO 文件时适用。

当 *protocol* 为 http、https、c(cifs) 且 *is_custom_iso* 为 true 时，*username* 适用于在 iDRAC 中将自定义 ISO 挂载为虚拟介质。

当 *protocol* 为 local 时，忽略 *username*。

用户名

字符串

具有管理员权限的 iDRAC 用户名。

validate_certs

布尔值

如果为 False，则不会验证 SSL 证书。

仅在使用自签名证书的个人控制站点上配置 False。

选项

  • false

  • true ← (默认)

wait_for_os_deployment

布尔值

等待操作系统部署完成。

选项

  • false

  • true ← (默认)