管理 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 页面查看和管理裸机服务器。
要管理服务器,请完成以下步骤。
- 在 IBM Cloud 仪表盘,转到 导航菜单 图标
> 基础设施
> 计算 > 裸机服务器。
- 在“裸机服务器”页面上,单击要管理的服务器的“操作”图标
。 您可以执行以下操作:
使用 UI 查看裸机服务器
您可以在裸机服务器页面上查看所有裸机服务器的摘要,也可以单击单个服务器名称以查看详细信息并进行更改。 在详细信息页面中,您还可以查看关联的网络接口,访问其子网,更改 Sapphire Rapids 服务器上的网络带宽,以及保留或删除浮动 IP 地址。
Sapphire Rapids 裸机服务器的可调网络带宽仅在美国南部 (达拉斯) 可用。
- 在 IBM Cloud 控制台,转到 导航菜单 图标
> 基础架构
> 计算 > 裸机服务器
- 单击要查看的裸机服务器名称。
使用 UI 更新裸机服务器的固件
仅当服务器已停止并且固件更新可用时,才会显示此操作。 建议在更新固件前备份服务器。
-
在 IBM Cloud 控制台,转到 导航菜单 图标
> 基础架构
> 计算 > 裸机服务器
-
单击要重启的裸机服务器名称。
-
单击 操作 ...,然后单击 更新固件。
选择更新固件时,您将收到以下消息。
此选项可更新服务器上的 BIOS 和 BMC 固件。 请先备份服务器,然后继续。 在此过程中,服务器将停止运行,无法使用。
默认选择更新完成后启动服务器。 如果您不希望服务器重新启动,请除去该检查。
-
单击 继续 以启动固件更新。 单击“**取消 **”取消更新。
使用 UI 重新引导裸机服务器
重新引导操作将立即关闭并打开裸机服务器的电源。
- 在 IBM Cloud 仪表盘
、转到 导航菜单 图标
基础设施
计算 > 裸机服务器
- 单击要重启的裸机服务器名称。
- 单击 操作 ...,然后单击 重新引导。
使用 UI 停止和启动裸机服务器
- 在 IBM Cloud 控制台,转到 导航菜单 图标
> 基础架构
> 计算 > 裸机服务器
- 单击要启动或停止的裸机服务器的名称。
- 单击 操作 ...,然后单击 停止 或 启动。 选择 Stop 时,请选择硬停止或软停止。 默认情况下,实例会软启动。
在裸机服务器停止后继续计费。
使用用户界面重新初始化裸机服务器
只有当服务器已停止并已配置本地存储时,才能重新初始化服务器。 或者,如果服务器状态为 failed
,且生命周期状态的状态原因为 cannot_reinitialize
,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。
-
在 IBM Cloud 控制台,转到 导航菜单 图标
> 基础架构
> 计算 > 裸机服务器
-
单击要重新初始化的裸机服务器名称。
-
单击 操作...,然后单击 重新初始化。
使用 UI 删除裸机服务器
- 在 IBM Cloud 控制台,转到 导航菜单 图标
> 基础架构
> 计算 > 裸机服务器
- 单击要删除的裸机服务器名称。
- 单击 操作 ...,然后单击 删除。
删除操作可从账户中永久删除服务器及其连接的 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-stop
或 ibmcloud is bare-metal-server-start
命令。 使用 SERVER
变量指定裸机服务器的标识或名称。
必须为数据有效内容中的停止操作指定 type
。soft
指示正在运行的操作系统停止并完全关闭。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 重启裸机服务器,请使用 重启裸机服务器。
指定一个 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 server 和 Start a bare metal server。
使用以下 API 请求来停止或启动裸机服务器。
使用 API 停止裸机服务器
指定一个 POST /bare_metal_servers/{id}/stop
请求来停止特定的裸机服务器,其中 id
是您要停止的裸机服务器的标识符。
必须为数据有效内容中的停止操作指定 type
。soft
指示正在运行的操作系统停止并完全关闭。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
指定裸机服务器的名称stop
或start
指定服务器的操作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。