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

支持：不支持

在 diff 模式下，将返回有关已更改内容（或可能需要在 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)