Bare Metal Servers for VPC の管理

ベアメタルサーバーの起動、停止、ファームウェアの更新、再起動、再初期化、削除などのタスクを実行することで、 IBM Cloud® Bare Metal Servers for VPC を管理することができます。

UI、CLI、APIを使用して、以下のアクションを実行できます。

ベアメタルサーバーで利用可能なアクション
アクション	説明
停止	ソフト停止またはハード停止を使用してサーバーを停止します。ソフト停止は、オペレーティングシステムの状態にもよりますが、サーバーをシャットダウンするのに数秒から数分かかります。オペレーティングシステムが応答せず、ソフト停止が完了できない場合は、ハード停止が必要です。ハード停止は、ベアメタルサーバーを直ちにシャットダウンします。この方法は、オペレーティング・システムが優雅にシャットダウンするのを妨げる。
開始	停止したサーバーを開始します。ステータスが「Running（実行中）」の場合、このアクションは利用できない。
ファームウェアの更新	サーバーが停止していて、ファームウェア更新が使用可能な場合、このオプションは表示されます。ファームウェアのアップデートを選択すると、プロンプトが表示され、ファームウェアのアップデートに関する詳細が表示されます。アップデートが完了したら、サーバーを起動できます。このオプションは、デフォルトで選択されています。ファームウェア更新を続行するか、キャンセルするかを選択できます。重要ファームウェア更新の前にサーバーをバックアップすることをお勧めします。
リブート	稼働中のサーバーの電源を即座に切り、再び電源を入れる。
再初期化	サーバーが停止している場合にのみ、サーバーを再初期化できます。または、サーバーの状態が `failed` ライフサイクル状態のステータス理由は `cannot_reinitialize`。ベアメタルサーバーが再初期化されると、ブートディスクの内容が消去され、指定されたオペレーティングシステムがインストールされます。サーバーは同じ物理ノード、インターフェース、IP アドレス、およびリソース ID を保持します。セカンダリドライブ上のデータは保存されます。
の削除	サーバーを削除するには、サーバーをパワーオフにする必要があります。サーバーに浮動 IP アドレスがある場合は、サーバーを削除する前に、浮動 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 コンソールのベアメタルサーバーページから表示および管理できます。

サーバーを管理するには、以下のステップを実行します。

IBM Cloud ダッシュボードで、ナビゲーションメニュー アイコン インフラストラクチャー コンピュート > ベアメタルサーバーに進みます。
**「ベアメタル・サーバー」**ページで、管理するサーバーの「アクション」アイコンをクリックします。以下の操作を行うことができます。

UIを使用してベアメタルサーバーを表示する

「ベアメタル・サーバー」ページですべてのベアメタル・サーバーのサマリーを表示したり、個別のサーバー名をクリックして詳細を表示し、それに変更を加えたりすることができます。詳細ページからは、関連付けられているネットワークインターフェイスを表示したり、そのサブネットにアクセスしたり、Sapphire Rapids サーバーのネットワーク帯域幅を変更したり、フローティング IP アドレスを予約または削除したりすることもできます。

Sapphire Rapids ベアメタルサーバーの調整可能なネットワーク帯域幅は、米国南部 (ダラス) でのみ利用可能です。

IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > ベアメタルサーバ に進みます
表示するベアメタル・サーバーの名前をクリックします。

UI を使用したベア・メタル・サーバーのファームウェアの更新

このアクションは、サーバーが停止しており、ファームウェア更新が使用可能な場合にのみ表示されます。ファームウェアをアップデートする前に、サーバーをバックアップすることをお勧めします。

IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > ベアメタルサーバ に進みます
リブートするベアメタル・サーバーの名前をクリックします。
「アクション ...」 をクリックしてから、 「ファームウェアの更新」 をクリックします。

ファームウェアの更新を選択すると、以下のメッセージが表示されます。

このオプションは、サーバーのBIOSとBMCファームウェアを更新します。続行する前に、サーバーをバックアップしてください。処理中はサーバーが停止し、利用できなくなる。

更新完了後にサーバーを起動はデフォルトで選択されています。サーバーを再始動しない場合は、チェック・マークを外します。
「続行」 をクリックしてファームウェア更新を開始します。 キャンセルをクリックすると、更新がキャンセルされます。

UIを使用したベアメタルサーバーの再起動

リブート・アクションを実行すると、ベアメタル・サーバーが即時にパワーオフされ、パワーオンされます。

IBM Cloud ダッシュボードの、ナビゲーションメニューアイコン インフラストラクチャー コンピュート > ベアメタルサーバー に移動します
リブートするベアメタル・サーバーの名前をクリックします。
**「アクション...」をクリックし、「リブート」**をクリックします。

UI を使用したベア・メタル・サーバーの停止と開始

IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > ベアメタルサーバ に進みます
開始または停止するベアメタル・サーバーの名前をクリックします。
**「アクション...」をクリックし、「停止」または「開始」**をクリックします。 Stop を選択したら、ハードストップかソフトストップを選択します。インスタンスはデフォルトでソフト停止する。

ベアメタル・サーバーが停止しても、請求処理は続行されます。

UIを使用したベアメタルサーバーの再初期化

サーバーが停止され、ローカルストレージがプロビジョニングされている場合にのみ、サーバーを再初期化できます。または、サーバーの状態が failed ライフサイクル状態のステータス理由は cannot_reinitialize。ベアメタルサーバーが再初期化されると、ブートディスクの内容が消去され、指定されたオペレーティングシステムがインストールされます。サーバーは同じ物理ノード、インターフェース、IP アドレス、およびリソース ID を保持します。セカンダリドライブ上のデータは保存されます。

IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > ベアメタルサーバ に進みます
再初期化するベアメタルサーバーの名前をクリックします。
Actions... をクリックし、 Reinitializeをクリックする。

UIを使用したベアメタルサーバーの削除

IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > ベアメタルサーバ に進みます
削除するベアメタル・サーバーの名前をクリックします。
**「アクション...」をクリックし、「削除」**をクリックします。

削除アクションは、サーバーとそのインスタンスに接続している vNIC、ブート・ボリューム、データをアカウントから永久に削除します。

CLI を使用したベアメタル・サーバーの管理

CLIを使用してベアメタルサーバーを表示する

CLI を使用してすべてのベアメタル・サーバーをリストするには、 ibmcloud is bare-metal-servers コマンドを使用します。特定のベア・メタル・サーバーを取得するには、 SERVER 変数でベア・メタル・サーバーの ID または名前を指定します。

ibmcloud is bare-metal-server SERVER

コマンド・オプションの完全なリストについては、 ibmcloud is bare-metal-server を参照してください。

CLIを使用したベアメタルサーバーの再起動

CLI を使用してベアメタルサーバーを再起動するには、ibmcloud is bare-metal-server-restart コマンドを使用します。 SERVER 変数を使用して、ベア・メタル・サーバーの ID または名前を指定します。

ibmcloud is bare-metal-server-restart SERVER

[-f, --force] フラグは、確認を求めずに操作を強制します。

CLI を使用したベア・メタル・サーバーの停止および始動

CLI を使用してベアメタルサーバーを停止および起動するには、ibmcloud is bare-metal-server-stop または ibmcloud is bare-metal-server-start コマンドを使用します。 SERVER 変数を使用して、ベア・メタル・サーバーの ID または名前を指定します。

データ・ペイロードで停止アクションの 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を使用したベアメタルサーバーの再初期化

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 はベアメタルサーバーの初期化の置き換えです。

CLI を使用したベア・メタル・サーバーのファームウェアの更新

ベアメタルサーバーのファームウェアのアップデートは、コマンドラインインターフェース（CLI）を使用して行うことができます。ファームウェアのアップデートは、停止していてファームウェアのアップデートが利用可能なベアメタルサーバーでのみ可能です。ファームウェアをアップデートする前に、サーバーをバックアップすることをお勧めします。

CLI を使用してベア・メタル・サーバーのファームウェアを更新するには、 ibmcloud is bare-metal-server-firmware-update コマンドを使用します。ベアメタルサーバーのIDまたは名前を SERVER 変数で指定します。

auto-start のデフォルト値は true。ファームウェアの更新後にベア・メタル・サーバーが始動しないようにするには、この値を false に変更する必要があります。

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

このコマンドを発行すると、ファームウェアのアップデートを続行するかどうかを確認するメッセージが表示されます。

このオプションは、サーバーのBIOSとBMCファームウェアをアップグレードします。続行する前にサーバーをバックアップしてください。処理中はサーバーを利用できない。続行しますか (y/n)?

コマンド・オプションの完全なリストについては、 ibmcloud is bare-metal-server-firmware-update を参照してください。

CLI を使用したベアメタル・サーバーの削除

CLI を使用してベアメタルサーバーを削除するには、ibmcloud is bare-metal-server-delete コマンドを使用します。ベアメタルサーバーのIDまたは名前を SERVER 変数で指定します。

ibmcloud is bare-metal-server-delete SERVER

削除アクションは、サーバーとそのインスタンスに接続している vNIC、ブート・ボリューム、データをアカウントから永久に削除します。

コマンド・オプションの完全なリストについては、 ibmcloud is bare-metal-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を使用してベアメタルサーバーを取得する

API を使用してベアメタルサーバーを取得するには、Retrieve a bare metal server を使用します。

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 を使用してベアメタルサーバーを再起動するには、Restart a bare metal server を使用します。

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 は、停止するベアメタルサーバーの識別子です。

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を使用してベアメタルサーバーを再初期化する

APIを使用してベアメタルサーバーを再初期化するには、ベアメタルサーバー初期化を使用します。

指定する 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 を使用してファームウェアを更新するには、Update firmware for a bare metal server を使用する。

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=beta" -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を使ったベアメタルサーバーの再初期化

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 deleteで、これはオペレーティングシステムをシャットダウンする。

コマンドオプションの完全なリストは、ibm_is_bare_metal_server を参照してください。