community.general.ipmi_boot 模块 – 启动设备顺序管理

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install community.general。您需要其他要求才能使用此模块，请参阅 需求了解详情。

要在 playbook 中使用它，请指定： community.general.ipmi_boot。

概要

  • 使用此模块来管理启动设备的顺序

需求

在执行此模块的主机上需要以下需求。

  • pyghmi

参数

参数

注释

bootdev

字符串 / 必需

设置下次重启时使用的启动设备

设备选项包括：- network – 请求网络启动 - floppy – 从软盘启动 - hd – 从硬盘启动 - safe – 从硬盘启动，请求“安全模式” - optical – 从 CD/DVD/BD 驱动器启动 - setup – 启动到设置实用程序 - default – 删除任何 IPMI 指导的启动设备请求

选项

  • "network"

  • "floppy"

  • "hd"

  • "safe"

  • "optical"

  • "setup"

  • "default"

key

字符串

在 community.general 4.1.0 中添加

以十六进制格式连接到 BMC 的加密密钥。

name

字符串 / 必需

BMC 的主机名或 IP 地址。

password

字符串 / 必需

连接到 BMC 的密码。

persistent

布尔值

如果设置，则要求系统固件在下次启动后使用此设备。请注意，许多系统不遵守此设置。

选项

  • false ← (默认)

  • true

port

整数

远程 RMCP 端口。

默认值： 623

state

字符串

是否确保启动设备符合预期。

state 的选项包括：- present – 请求系统开启 - absent – 请求系统开启

选项

  • "present" ← (默认)

  • "absent"

uefiboot

布尔值

如果设置，则明确请求 UEFI 启动。严格来说，规范建议如果未设置，系统应该 BIOS 启动，并且没有“不关心”选项。实际上，此标志未设置不会阻止我在任何遇到的系统上进行 UEFI 启动。

选项

  • false ← (默认)

  • true

user

字符串 / 必需

用于连接到 BMC 的用户名。

属性

属性

支持

描述

check_mode

支持：完全支持

可以在 check_mode 中运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持：不支持

在差异模式下，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息。

示例

- name: Ensure bootdevice is HD
  community.general.ipmi_boot:
    name: test.testdomain.com
    user: admin
    password: password
    bootdev: hd

- name: Ensure bootdevice is not Network
  community.general.ipmi_boot:
    name: test.testdomain.com
    user: admin
    password: password
    key: 1234567890AABBCCDEFF000000EEEE12
    bootdev: network
    state: absent

返回值

常见返回值已在此处记录 此处，以下是此模块独有的字段

键

描述

bootdev

字符串

将在下次启动后使用的启动设备名称。

返回：成功

示例： "default"

persistent

布尔值

如果为 True，系统固件将在下次启动后使用此设备。

返回：成功

示例： false

uefimode

布尔值

如果为 True，系统固件将在下次启动后显式使用 UEFI 启动。

返回：成功

示例： false

作者

  • Bulat Gaifullin (@bgaifullin)