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

注意

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

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

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

要在 playbook 中使用它，请指定： 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，并使用 HTTP 协议挂载虚拟介质。

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

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

选项

  • "https"

  • "http"

  • "nfs"

  • "cifs"

username

字符串

用于将自定义 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 模板文件应以 `_ .j2` 的格式存在。

当 is_custom_iso 为 false 时，这是必需的。

os_version

字符串

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

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

Jinja 模板文件应以 `_ .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 共享的密码。

只有当 protocol 为 http 或 https 用于下载 ISO 文件时，password 才适用。

当 protocol 为 http、https、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"

username

字符串

HTTP、HTTPS 和 CIFS 共享的用户名。

只有当 protocol 为 http 或 https 用于下载 ISO 文件时，username 才适用。

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

当 protocol 为 local 时，将忽略 username。

username

字符串

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

validate_certs

布尔值

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

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

选项

  • false

  • true ← (默认)

wait_for_os_deployment

布尔值

等待操作系统部署完成。

选项

  • false

  • true ← (默认)