IBM Cloud Docs
管理 Bare Metal Servers for VPC

管理 Bare Metal Servers for VPC

您可以通过执行启动、停止、更新固件、重启、重新初始化和删除裸机服务器等任务来管理 IBM Cloud® Bare Metal Servers for VPC。

您可以使用 UI,CLI 和 API 执行以下操作。

裸机服务器可采取的行动
操作 描述
停止
  • 软停止关闭服务器可能需要几秒到几分钟的时间,具体取决于操作系统的状态。
  • 硬停止会立即关闭裸机服务器。 这种方法会阻止操作系统优雅地关闭。
Start 启动已停止的服务器。 如果状态为“正在运行”,那么此操作不可用。
更新固件 如果服务器已停止并且固件更新可用,那么此选项可视。

如果选择更新固件,系统将显示提示,提供有关固件更新的更多详细信息。 更新完成后即可启动服务器。 缺省情况下,已选中该选项。

您可以选择继续固件更新或取消固件更新。
重要信息 建议在任何固件更新之前备份服务器。

重新引导 立即关闭正在运行的服务器的电源,然后将其重新打开。
重新初始化 只有当服务器停止时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。
删除(T) 要删除服务器,必须关闭服务器电源。 如果服务器具有浮动 IP 地址,那么必须先取消关联或释放浮动 IP 地址,然后才能删除服务器。 删除操作可从账户中永久删除服务器及其连接的 vNIC, 启动卷和数据。

要管理裸机服务器,需要一个包含以下操作的 IAM 角色。 有关更多信息,请参阅 管理 VPC 基础架构服务的 IAM 访问权

  • is.bare-metal-server.bare-metal-server.list
  • is.bare-metal-server.bare-metal-server.read
  • is.bare-metal-server.bare-metal-server.delete
  • is.bare-metal-server.bare-metal-server.update
  • is.bare-metal-server.bare-metal-server.operate
  • is.key.key.operate
  • is.image.image.operate
  • is.bare-metal-server.bare-metal-server-firmware.update(更新固件时需要)
  • is.bare-metal-server.initialization.update(需要重新初始化服务器)

使用 UI 管理裸机服务器

您可以通过 IBM Cloud 控制台中的 Bare metal servers 页面查看和管理裸机服务器。

要管理服务器,请完成以下步骤。

  1. IBM Cloud 仪表盘,转到 导航菜单 图标菜单图标 > 基础设施 VPC 图标 > 计算 > 裸机服务器
  2. 在“裸机服务器”页面上,单击要管理的服务器的“操作”图标 "更多操作" 图标。 您可以执行以下操作:

使用 UI 查看裸机服务器

您可以在裸机服务器页面上查看所有裸机服务器的摘要,也可以单击单个服务器名称以查看详细信息并进行更改。 在详细信息页面中,您还可以查看关联的网络接口,访问其子网,更改 Sapphire Rapids 服务器上的网络带宽,以及保留或删除浮动 IP 地址。

Sapphire Rapids 裸机服务器的可调网络带宽仅在美国南部 (达拉斯) 可用。

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器
  2. 单击要查看的裸机服务器名称。

使用 UI 更新裸机服务器的固件

仅当服务器已停止并且固件更新可用时,才会显示此操作。 建议在更新固件前备份服务器。

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器

  2. 单击要重启的裸机服务器名称。

  3. 单击 操作 ...,然后单击 更新固件

    选择更新固件时,您将收到以下消息。

    此选项可更新服务器上的 BIOS 和 BMC 固件。 请先备份服务器,然后继续。 在此过程中,服务器将停止运行,无法使用。

    默认选择更新完成后启动服务器。 如果您不希望服务器重新启动,请除去该检查。

  4. 单击 继续 以启动固件更新。 单击“**取消 **”取消更新。

使用 UI 重新引导裸机服务器

重新引导操作将立即关闭并打开裸机服务器的电源。

  1. IBM Cloud 仪表盘 外部链接图标、转到 导航菜单 图标 菜单图标 基础设施 VPC 图标 计算 > 裸机服务器
  2. 单击要重启的裸机服务器名称。
  3. 单击 操作 ...,然后单击 重新引导

使用 UI 停止和启动裸机服务器

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器
  2. 单击要启动或停止的裸机服务器的名称。
  3. 单击 操作 ...,然后单击 停止启动。 选择 Stop 时,请选择硬停止或软停止。 默认情况下,实例会软启动。

在裸机服务器停止后继续计费。

使用用户界面重新初始化裸机服务器

只有当服务器已停止并已配置本地存储时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器

  2. 单击要重新初始化的裸机服务器名称。

  3. 单击 操作...,然后单击 重新初始化

使用 UI 删除裸机服务器

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器
  2. 单击要删除的裸机服务器名称。
  3. 单击 操作 ...,然后单击 删除

删除操作可从账户中永久删除服务器及其连接的 vNIC, 启动卷和数据。

使用 CLI 管理裸机服务器

使用 CLI 查看裸机服务器

要使用 CLI 列出所有裸机服务器,请使用 ibmcloud is bare-metal-servers 命令。 要检索特定裸机服务器,请使用 SERVER 变量指定裸机服务器的标识或名称。

ibmcloud is bare-metal-server SERVER

有关命令选项的完整列表,请参阅 ibmcloud is 裸机-server

使用 CLI 重新引导裸机服务器

要使用 CLI 重启裸机服务器,请使用 ibmcloud is bare-metal-server-restart 命令。 使用 SERVER 变量指定裸机服务器的标识或名称。

ibmcloud is bare-metal-server-restart SERVER

[-f, --force] 标志强制操作而不确认。

使用 CLI 停止和启动裸机服务器

要使用 CLI 停止和启动裸机服务器,请使用 ibmcloud is bare-metal-server-stopibmcloud is bare-metal-server-start 命令。 使用 SERVER 变量指定裸机服务器的标识或名称。

必须为数据有效内容中的停止操作指定 typesoft 指示正在运行的操作系统停止并完全关闭。hard 立即停止裸机服务器。

要停止裸机服务器,请使用以下命令。

ibmcloud is bare-metal-server-stop SERVER --type soft

要启动裸机服务器,请使用以下命令。

ibmcloud is bare-metal-server-start SERVER

裸机服务器停止运行后,计费仍将继续。

有关命令选项的完整列表,请参见 ibmcloud is bare-metal-server-restart

使用 CLI 重新初始化裸机服务器

只有当服务器已停止并已配置本地存储时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。

要使用 CLI 重新初始化裸机服务器,请使用 ibmcloud is bare-metal-server-initialization-replace 命令。

ibmcloud is bare-metal-server-initialization-replace SERVER --image IMAGE ---keys KEYS --user-data DATA

指定以下变量,以便在重新初始化裸机服务器时使用。

  • SERVER 指定裸机服务器的名称
  • IMAGE 指定操作系统映像
  • KEYS 指定 SSH 密钥
  • DATA 指定任何可选的用户数据
  • PROFILE 受信任配置文件的 ID、名称或 CRN

有关命令选项的完整列表,请参阅 ibmcloud is bare-metal-server-initialization-replace

使用 CLI 更新裸机服务器的固件

您可以使用命令行界面 (CLI) 更新裸机服务器的固件。 您只能在已停止运行且固件更新可用的裸机服务器上更新固件。 建议在更新固件前备份服务器。

要使用 CLI 更新裸机服务器的固件,请使用 ibmcloud is bare-metal-server-firmware-update 命令。 使用 SERVER 变量指定裸机服务器的 ID 或名称。

auto-start 的默认值是 true。 如果您不希望裸机服务器在更新固件后启动,那么必须将此值更改为 false

ibmcloud is bare-metal-server-firmware-update SERVER --auto-start true

发出该命令后,您将收到一条信息,以确认是否继续进行固件更新。

此选项可升级服务器上的 BIOS 和 BMC 固件。 请先备份服务器,然后再继续。 在此过程中,服务器不可用。 继续 (y/n)?

有关命令选项的完整列表,请参阅 ibmcloud is 裸机-server-firmware-update

使用 CLI 删除裸机服务器

要使用 CLI 删除裸机服务器,请使用 ibmcloud is bare-metal-server-delete 命令。 使用 SERVER 变量指定裸机服务器的 ID 或名称。

ibmcloud is bare-metal-server-delete SERVER

删除操作可从账户中永久删除服务器及其连接的 vNIC, 启动卷和数据。

有关命令选项的完整列表,请参阅 ibmcloud is 裸机-server-delete

使用 API 管理裸机服务器

使用 API 查看裸机服务器

要使用 API 列出所有裸机服务器,请使用 列出所有裸机服务器

指定 GET /bare_metal_servers 请求以列出所有裸机服务器。

curl -X GET "$vpc_api_endpoint/v1/bare_metal_servers?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

使用应用程序接口检索裸机服务器

要使用 API 检索裸机服务器,请使用 检索裸机服务器

指定一个 GET /bare_metal_servers/{id} 请求,检索特定的裸机服务器,其中 id 是您要检索的裸机服务器的标识符。

curl -X GET "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

有关 API 请求的更多信息,请参阅 列出所有裸机服务器检索裸机服务器

使用 API 重新引导裸机服务器

要使用 API 重启裸机服务器,请使用 重启裸机服务器

指定一个 POST /bare_metal_servers/{id}/restart 请求,以重新启动特定的裸机服务器,其中 id 是您要重新启动的裸机服务器的标识符。

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/restart?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

有关 API 请求的更多信息,请参阅 重新启动裸机服务器

使用 API 停止和启动裸机服务器

要使用 API 停止或启动裸机服务器,请使用 Stop a bare metal serverStart a bare metal server

使用以下 API 请求来停止或启动裸机服务器。

使用 API 停止裸机服务器

指定一个 POST /bare_metal_servers/{id}/stop 请求来停止特定的裸机服务器,其中 id 是您要停止的裸机服务器的标识符。

必须为数据有效内容中的停止操作指定 typesoft 指示正在运行的操作系统停止并完全关闭。hard 立即停止裸机服务器。

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/stop?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"
-d '{
        "type": "soft"
}'

在裸机服务器停止后继续计费。

有关 API 请求的更多信息,请参阅 停止裸机服务器

使用 API 启动裸机服务器

指定一个 POST /bare_metal_servers/{id}/start 请求,启动一台特定的裸机服务器,其中 id 是您要启动的裸机服务器的标识符。

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/start?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

有关 API 请求的更多信息,请参阅 启动裸机服务器

使用应用程序接口重新初始化裸机服务器

要使用 API 重新初始化裸机服务器,请使用 裸机服务器初始化

只有当服务器已停止并已配置本地存储时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。

指定 PUT /bare_metal_servers/{id}/initialization 请求以重新初始化裸机服务器。

curl -X PUT "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/initialization?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token" \
-d '{
	  "image": {
		"id": $image
	  },
	  "keys": [
		{
			"id": $key
		}
	  ],
	  }
}'

指定重新初始化裸机服务器时要使用的以下属性值。

  • name 指定裸机服务器的名称
  • image 指定操作系统映像
  • keys 指定 SSH 密钥
  • user_data 指定任何可选的用户数据

使用 API 更新裸机服务器的固件

您只能在已停止运行且固件更新可用的裸机服务器上更新固件。 建议在更新固件前备份服务器。 要使用 API 更新固件,请使用 为裸机服务器更新固件

指定一个 POST /bare_metal_servers/{id}/firmware/update 请求,以更新特定裸机服务器的固件,其中 id 是您要更新的裸机服务器的标识符。

auto_start 的默认值是 true。 如果不想在固件更新后启动裸机服务器,则必须将此值更改为 false

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/firmware/update?version=$tomorrow&generation=2&maturity=development" -H "Authorization: Bearer $iam_token" -d '{
  "auto_start": false
}'

使用 API 删除裸机服务器

要使用 API 删除裸机服务器,请使用 Delete a bare metal server

指定一个 DELETE /bare_metal_servers/{id} 请求,删除一个特定的裸机服务器,其中 id 是您要删除的裸机服务器的标识符。

curl -X DELETE "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

删除操作可从账户中永久删除服务器及其连接的 vNIC, 启动卷和数据。

使用 Terraform 管理裸机服务器

确保设置了 Terraform for VPC

使用 Terraform 查看裸机服务器

要使用 Terraform 查看裸机服务器,请使用 ibm_is_bare_metal_server 资源。

data "ibm_is_bare_metal_server" "example" {
  identifier        = "9328-9849-9849-9849"
}

有关详细信息,请参阅 ibm_is_bare_metal_server

要查看所有裸机服务器的列表,请使用 ibm_is_bare_metal_servers 资源。

data "ibm_is_bare_metal_servers" "example" {
}

有关详细信息,请参阅 ibm_is_bare_metal_servers

使用 Terraform 重启裸机服务器

要使用 Terraform 重启裸机服务器,需要使用 ibm_is_bare_metal_server_action 资源。

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "restart"
}

指定以下变量,以便在重新初始化裸机服务器时使用。

  • SERVER 指定裸机服务器的名称
  • restart 指定服务器的操作

有关命令选项的完整列表,请参阅 ibm_is_bare_metal_server_action

使用 Terraform 停止和启动裸机服务器

要使用 Terraform 停止裸机服务器,需要使用 ibm_is_bare_metal_server_action 资源。

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "stop"
  stop_type         = "hard"
}

要使用 Terraform 启动裸机服务器,需要使用 ibm_is_bare_metal_server_action 资源。

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "stop"
  delete_type       = "hard"
}

指定以下变量,以便在重新初始化裸机服务器时使用。

  • SERVER 指定裸机服务器的名称
  • stopstart 指定服务器的操作
  • hard 专用于停止服务器,表示停止类型。 指定 hard 会立即停止服务器,而 soft 则会关闭操作系统。

有关命令选项的完整列表,请参阅 ibm_is_bare_metal_server_action

使用 Terraform 重新初始化裸机服务器

只有当服务器已停止并已配置本地存储时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。

要使用 Terraform 重新初始化裸机服务器,需要使用资源命令 ibm_is_bare_metal_server_initialization

resource "ibm_is_bare_metal_server_initialization" "reinitialize" {
  bare_metal_server = SERVER
  user_data         = DATA
  keys              = KEYS
  image             = "IMAGE"
}

指定以下变量,以便在重新初始化裸机服务器时使用。

  • SERVER 指定裸机服务器的名称
  • DATA 指定任何可选的用户数据
  • KEYS 指定 SSH 密钥
  • IMAGE 指定操作系统映像

虽然可以保留相同的物理节点、接口、IP 地址和资源 ID,但也可以选择使用 lifecycle 属性来避免这些更改。

有关命令选项的完整列表,请参阅 ibm_is_bare_metal_server_initialization

resource "ibm_is_bare_metal_server_initialization" "reinitialize" {
  bare_metal_server = SERVER
  user_data         = DATA
  keys              = KEYS
  image             = "IMAGE"
}
## to avoid changes on the ibm_is_bare_metal_server resource, use lifecycle meta argument ignore_changes
resource "ibm_is_bare_metal_server" "bms" {
  ....
  lifecycle{
    ignore_changes = [ image, keys, user_data ]
  }
}

使用 Terraform 删除裸机服务器

要使用 Terraform 删除裸机服务器资源,需要使用 ibm_is_bare_metal_server 资源。

resource "ibm_is_bare_metal" "server" {
  delete_type          = "hard"
}

指定删除裸机服务器时要使用的以下变量。

  • hard 指定 hard 删除,立即停止并删除服务器。 另一个选项是 soft 删除,它会关闭操作系统。

有关命令选项的完整列表,请参阅 ibm_is_bare_metal_server