Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

3.2. 关于 BareMetalHost 资源

裸机3 引入了 BareMetalHost 资源的概念，它定义了物理主机及其属性。BareMetalHost 资源包含两个部分：

  1. BareMetalHost 规格
  2. BareMetalHost 状态

3.2.1. BareMetalHost 规格
复制链接

BareMetalHost 资源的 spec 部分定义了主机所需状态。

Expand
表 3.1. BareMetalHost spec
参数描述

automatedCleaningMode

在置备和取消置备过程中启用或禁用自动清理的接口。当设置为 disabled 时，它将跳过自动清理。当设置为 metadata 时，会自动清理会被启用。默认设置为 metadata。 

bmc:
  address:
  credentialsName:
  disableCertificateVerification:
Copy to Clipboard Toggle word wrap

bmc 配置设置包含主机上基板管理控制器(BMC)的连接信息。这些字段包括：

  • address ：与主机的 BMC 控制器通信的 URL。
  • credentialsName ：引用包含 BMC 的用户名和密码的 secret。
  • disableCertificateVerification ：当设置为 true 时跳过证书验证的布尔值。

bootMACAddress

用于置备主机的 NIC 的 MAC 地址。

bootMode

主机的引导模式。它默认为 UEFI，但也可以设置为 legacy 用于 BIOS 引导，或 UEFISecureBoot。

consumerRef

对使用主机的另一个资源的引用。如果另一个资源目前没有使用主机，则它可能为空。例如，当 machine-api 使用主机时，Machine 资源可能会使用主机。

description

提供的字符串，用于帮助识别主机。

externallyProvisioned

指明主机置备和取消置备是在外部管理的布尔值。当设置时：

  • 仍可使用在线字段管理电源状态。
  • 将监控硬件清单，但不会在主机上执行置备或取消置备操作。

firmware

包含有关裸机主机的 BIOS 配置的信息。目前，只有 iRMC、S iDRAC、i iLO4 和 iLO5 BMC 支持 firmware。子字段有：

  • simultaneousMultithreadingEnabled：允许单个物理处理器内核显示为多个逻辑处理器。有效设置为 true 或 false。
  • sriovEnabled: SR-IOV 支持可让虚拟机监控程序创建 PCI-express 设备的虚拟实例，这可能会提高性能。有效设置为 true 或 false。
  • virtualizationEnabled：支持平台硬件的虚拟化。有效设置为 true 或 false。 
image:
  url:
  checksum:
  checksumType:
  format:
Copy to Clipboard Toggle word wrap

image 配置设置包含要部署到主机上的镜像的详细信息。Ironic 需要镜像字段。但是，当 externallyProvisioned 配置设置被设置为 true，且外部管理不需要电源控制时，字段可以为空。这些字段包括：

  • url：部署到主机的镜像的 URL。
  • checksum ：位于 image.url 的镜像的实际校验和值，或包括镜像的校验和的文件 URL。
  • checksumType ：指定 checksum 算法。目前，Image.checksumType 只支持 md5、sha256 和 sha512。默认 checksum 类型为 md5。
  • format ：镜像的磁盘格式。它可以是 raw, qcow2, vdi, vmdk, live-iso 或不设置。把它设置为 raw 可为该镜像在 Ironic 代理中进行原始镜像流处理。将它设置为 live-iso 会启用 iso 镜像在没有部署到磁盘的情况下进行实时引导，它会忽略 checksum 字段。

networkData

对包含网络配置数据及其命名空间的 secret 的引用，以便在主机引导以设置网络前将其附加到主机。

online

指示主机是否应开启的布尔值，true 代表开启，false 代表关闭。更改此值将触发对物理主机的电源状态变化。 

raid:
  hardwareRAIDVolumes:
  softwareRAIDVolumes:
Copy to Clipboard Toggle word wrap

（可选）包含有关裸机主机的 RAID 配置的信息。如果没有指定，它会保留当前的配置。

注意

OpenShift Container Platform 4.10 仅支持使用 iRMC 协议进行 BMC 的硬件 RAID。OpenShift Container Platform 4.10 不支持软件 RAID。

请参见以下配置设置：

  • hardwareRAIDVolumes ：包含硬件 RAID 的逻辑驱动器列表，并在硬件 RAID 中定义所需的卷配置。如果您没有指定 rootDeviceHints，则第一个卷是 root 卷。子字段是：

    • level ：逻辑驱动器的 RAID 级别。支持以下级别：0,1,2,5,6,1+0,5+0,6+0.
    • name ：卷名称（字符串）。它在服务器中应该是唯一的。如果未指定，则自动生成卷名称。
    • numberOfPhysicalDisks ：物理驱动器的数量，作为用于逻辑 drove 的整数。默认为特定 RAID 级别所需的最小磁盘驱动器数。
    • physicalDisks ：物理磁盘驱动器的名称列表作为字符串。这是可选字段。如果指定，还必须指定 controller 字段。
    • controller ：（可选）RAID 控制器的名称作为要在硬件 RAID 卷中使用的字符串。
    • rotational ：如果设为 true，则它只会选择轮转磁盘驱动器。如果设置为 false，它将只选择固态和 NVMe 驱动器。如果没有设置，则会选择任何驱动器类型，这是默认行为。
    • sizeGibibytes ：逻辑驱动器的大小作为在 GiB 中创建的整数。如果未指定或设置为 0，它将为逻辑驱动器使用物理驱动器的最大容量。

  • softwareRAIDVolumes: OpenShift Container Platform 4.10 不支持软件 RAID。以下信息仅供参考。这个配置包含软件 RAID 的逻辑磁盘列表。如果您没有指定 rootDeviceHints，则第一个卷是 root 卷。如果您设置了 HardwareRAIDVolumes，则此项将无效。软件 RAID 总是被删除。创建的软件 RAID 设备的数量必须是 1 或 2。如果只有一个软件 RAID 设备，它必须是 RAID-1。如果有两个 RAID 设备，则第一个设备必须是 RAID-1，而第二个设备的 RAID 级别可以为 0, 1, 或 1+0。第一个 RAID 设备将是部署设备。因此，当设备出现故障时，强制 RAID-1 降低了非引导节点的风险。softwareRAIDVolume 字段定义软件 RAID 中卷所需的配置。子字段是：

    • level ：逻辑驱动器的 RAID 级别。支持以下级别：0,1,1+0。
    • physicalDisks ：设备提示列表.项目数量应大于或等于 2。
    • sizeGibibytes ：逻辑磁盘驱动器的大小作为整数，以 GiB 为单位创建。如果未指定或设置为 0，它将为逻辑驱动器使用物理驱动器的最大容量。

您可以将 hardwareRAIDVolume 设置为空片段，以清除硬件 RAID 配置。例如： 

spec:
   raid:
     hardwareRAIDVolume: []
Copy to Clipboard Toggle word wrap

如果您收到出错信息表示驱动程序不支持 RAID，则将 raid, hardwareRAIDVolumes 或 softwareRAIDVolumes 设置为 nil。您可能需要确保主机具有 RAID 控制器。 

rootDeviceHints:
  deviceName:
  hctl:
  model:
  vendor:
  serialNumber:
  minSizeGigabytes:
  wwn:
  wwnWithExtension:
  wwnVendorExtension:
  rotational:
Copy to Clipboard Toggle word wrap

rootDeviceHints 参数启用将 RHCOS 镜像置备到特定设备。它会按照发现设备的顺序检查设备，并将发现的值与 hint 值进行比较。它使用第一个与 hint 值匹配的发现设备。该配置可组合多个 hints，但设备必须与所有提示都匹配才能被选择。这些字段包括：

  • deviceName：包含类似 /dev/vda 的 Linux 设备名称的字符串。hint 必须与实际值完全匹配。
  • hctl ：包含类似 0:0:0:0 的 SCSI 总线地址的字符串。hint 必须与实际值完全匹配。
  • model ：包含特定厂商的设备标识符的字符串。hint 可以是实际值的子字符串。
  • vendor ：包含该设备厂商或制造商名称的字符串。hint 可以是实际值的子字符串。
  • serialNumber ：包含设备序列号的字符串。hint 必须与实际值完全匹配。
  • minSizeGigabytes ：一个整数，代表设备的最小大小（以 GB 为单位）。
  • wwn ：包含唯一存储标识符的字符串。hint 必须与实际值完全匹配。
  • wwnWithExtension ：包含附加厂商扩展的唯一存储标识符的字符串。hint 必须与实际值完全匹配。
  • wwnVendorExtension ：包含唯一厂商存储标识符的字符串。hint 必须与实际值完全匹配。
  • rotational ：指示该设备应该是旋转磁盘(true)还是非旋转磁盘(false)的布尔值。

3.2.2. BareMetalHost 状态
复制链接

BareMetalHost 状态代表主机的当前状态，包括经过测试的凭证、当前的硬件详情和其他信息。

Expand
表 3.2. BareMetalHost 状态
参数描述

goodCredentials

对 secret 及其命名空间的引用，其中包含最近一组基板管理控制器(BMC)凭证，以便系统能够验证。

errorMessage

置备后端的最后一个错误的详情（若有）。

errorType

表示导致主机进入错误状态的问题类别。错误类型包括：

  • provisioned registration error：当控制器无法重新注册已置备的主机时发生。
  • registration error ：当控制器无法连接到主机的基板管理控制器时，请注意。
  • inspection error ：尝试从主机获取硬件详细信息时发生错误。
  • preparation error ：在清理失败时生成。
  • provisioning error ：当控制器无法置备或取消置备主机时会发生。
  • power management error ：当控制器无法修改主机的电源状态时会发生。
  • detach error: 当控制器无法从置备程序卸载主机时会发生。 
hardware:
  cpu
    arch:
    model:
    clockMegahertz:
    flags:
    count:
Copy to Clipboard Toggle word wrap

系统中的 CPU 的 hardware.cpu 字段详情。这些字段包括：

  • arch ：CPU 的架构。
  • model: CPU 系列（字符串）
  • clockMegahertz ：CPU 的速度（MHz）。
  • flags: CPU 标记列表。例如，'mmx','sse','sse2','vmx' 等。
  • count: 系统中可用的 CPU 数量。 
hardware:
  firmware:
Copy to Clipboard Toggle word wrap

包含 BIOS 固件信息。例如，硬件供应商和版本。 

hardware:
  nics:
  - ip:
    name:
    mac:
    speedGbps:
    vlans:
    vlanId:
    pxe:
Copy to Clipboard Toggle word wrap

hardware.nics 字段包含主机的网络接口列表。这些字段包括：

  • ip：NIC 的 IP 地址，如果在发现代理运行时是否被分配。
  • name: 标识网络设备的字符串。例如，nic-1。
  • mac: NIC 的 MAC 地址。
  • speedGbps: 设备的速度（Gbps）。
  • vlans: 保存此 NIC 可用的所有 VLAN 的列表。
  • vlanId ：未标记的 VLAN ID。
  • pxe: NIC 是否能够使用 PXE 引导。 
hardware:
  ramMebibytes:
Copy to Clipboard Toggle word wrap

主机的内存量（兆字节(MiB)）。 

hardware:
  storage:
  - name:
    rotational:
    sizeBytes:
    serialNumber:
Copy to Clipboard Toggle word wrap

hardware.storage 字段包含可用于主机的存储设备列表。这些字段包括：

  • name: 标识存储设备的字符串。例如，disk 1 (boot).
  • rotational ：指示磁盘是否为轮转的，返回 true 或 false。
  • sizeBytes ：存储设备的大小。
  • serialNumber ：设备的序列号。 
hardware:
  systemVendor:
    manufacturer:
    productName:
    serialNumber:
Copy to Clipboard Toggle word wrap

包含主机的 manufacturer, productName, 和 serialNumber 的信息。

lastUpdated

主机状态最后一次更新的时间戳。

operationalStatus

服务器的状态。状态为以下之一：

  • OK ：指示主机的所有详细信息均为已知、正确配置、正常工作和可以管理。
  • discovered: 指定某些主机的详细信息无法正常工作或缺失。例如，BMC 地址已知，但登录凭证未知。
  • error: 指示系统发现某种不可恢复的错误。如需更多详细信息，请参阅 status 部分中的 errorMessage 字段。
  • delayed：指示置备延迟来限制同时置备多个主机。
  • detached: 指示主机被标记为 unmanaged。

poweredOn

指明主机是否开机的布尔值。 

provisioning:
  state:
  id:
  image:
  raid:
  firmware:
  rootDeviceHints:
Copy to Clipboard Toggle word wrap

provisioning 字段包含与主机部署镜像相关的值。子字段包括：

  • state: 任何持续置备操作的当前状态。状态包括：

    • <empty string>: 目前没有进行置备。
    • unmanaged: 没有足够的信息来注册主机。
    • registering: 用来检查主机的 BMC 详情的代理
    • match profile ：代理将主机上发现的硬件详情与已知的配置集进行比较。
    • available: 主机可用于置备。这个状态之前被称为 ready。
    • preparing ：现有配置将被删除，新的配置将在主机上设置。
    • provisioning ：置备程序正在将镜像写入主机的存储。
    • provisioned: 置备程序已将镜像写入主机的存储。
    • externally provisioned: Metal3 不管理主机上的镜像。
    • deprovisioning: 置备程序正在从主机的存储中清除镜像。
    • inspecting: 代理正在收集主机的硬件详情。
    • deleting: 代理正在从集群中删除。
  • id: 底层调配工具中服务的唯一标识符。
  • Image ：最近部署到主机的镜像。
  • raid: 最近设定的硬件或软件 RAID 卷列表。
  • firmware: 裸机服务器的 BIOS 配置。
  • rootDeviceHints ：用于最新置备操作的根设备选择说明。

triedCredentials

对 secret 及其命名空间的引用，其中包含发送到置备后端的最后一个 BMC 凭证集合。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat