Bare Metal Solution 環境のメンテナンス

Bare Metal Solution 環境が稼働したら、このガイドの情報を使用して、Bare Metal Solution サーバー、ストレージ、ネットワークのメンテナンスを行います。

SAP HANA を実行するには、SAP HANA のベアメタル マシンをご覧ください。

Bare Metal Solution API と gcloud CLI を使用するように Google Cloud プロジェクトを設定する

Bare Metal Solution API には、Bare Metal Solution 環境のモニタリングとメンテナンスに使用できる多くのツールが用意されています。通常、この手順は、Bare Metal Solution API を初めて使用する場合にのみ必要です。ただし、API が期待どおりに応答しない場合に備えて、必要に応じてこの手順を再利用してください。

  1. Bare Metal Solution 管理者または Bare Metal Solution 編集者の IAM 事前定義ロールをプリンシパルに割り当てます。IAM ロールをマッピングする方法については、IAM ロールを付与するをご覧ください。

  2. 相互接続のアタッチメントが作成されるネットワーキング プロジェクトなど、Bare Metal Solution リソースが構成されている Google Cloud プロジェクトで、Bare Metal Solution API を有効にします。

    コンソール

    1. Google Cloud コンソール ダッシュボードで [Bare Metal Solution API] に移動します。また [API とサービス] > [ライブラリ] にアクセスして、API ライブラリの Bare Metal Solution API を検索することもできます。
    2. [Bare Metal Solution API] ページで、[有効にする] をクリックします。
    3. ブラウザの [戻る] ボタンをクリックします。[API が有効です] の横に緑色のチェックマークが表示されていれば、API を使用できます。
    4. Bare Metal Solution API を有効にするには、次のいずれかを行います。
      • Google Cloud プロジェクト内の任意の Bare Metal Solution ページに移動します。
      • Google Cloud プロジェクト内で Google Cloud CLI を使用して Bare Metal Solution コマンドを実行します。

    gcloud

    1. gcloud を使用して Bare Metal Solution API を有効にするには、次のコマンドに gcloud CLI プロジェクト ID を入力します。このコマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

       gcloud services enable baremetalsolution.googleapis.com --project=PROJECT_ID

    2. Bare Metal Solution API を有効にするには、次のいずれかを行います。

      • Google Cloud プロジェクト内の任意の Bare Metal Solution ページに移動します。
      • Google Cloud プロジェクト内で Google Cloud CLI を使用して Bare Metal Solution コマンドを実行します。

  3. Google Cloud CLI が、Bare Metal Solution API が有効になっている Google Cloud プロジェクトと連携できるようにします。

    1. Cloud Shell ウィンドウで、gcloud auth login コマンドを入力します。
      gcloud auth login
    2. 表示された URL をコピーし、別のブラウザのタブまたはウィンドウに貼り付けます。
    3. Google Cloud プロジェクトに関連付けられたユーザー名を使用して、ページにログインします。
    4. [許可] をクリックして gcloud CLI を有効にします。
    5. 認証コードをコピーします。
    6. コードを Cloud Shell クライアント コマンドラインに貼り付けます。
    7. Enter キーまたは Return キーを押します。

Google Cloudで API を設定するために必要な一般的な手順の詳細については、Google Cloud APIs スタートガイドをご覧ください。

Bare Metal Solution サーバーの操作

Bare Metal Solution サーバーで次の操作を実行できます。

  • 起動 - サーバーの電源をオンにします。
  • 停止 - サーバーの電源をオフにします。

  • リセット - サーバーを再起動します。

コンソール

サーバーでこれらの操作を行う手順は次のとおりです。

  1. [Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。

  2. 起動、停止、またはリセットするサーバーで をクリックします。

  3. 手順は次のとおりです。

    • サーバーの電源をオンにするには、[起動] をクリックします。
    • サーバーの電源をオフにするには、[停止] をクリックします。
    • サーバーを再起動するには、[リセット] をクリックします。

gcloud

  1. Bare Metal Solution サーバーの電源を切って再起動するには、次の操作を行います。

    1. API の設定手順が完了していることを確認します。

      サーバーを再起動するには、Bare Metal Solution API と gcloud CLI を有効にする必要があります。また、Bare Metal Solution 管理者または Bare Metal Solution 編集者の IAM ロールをプリンシパルに付与する必要があります。

    2. Bare Metal Solution サーバーの電源を切って再起動するには、gcloud bms instances reset コマンドを実行します。

      gcloud bms instances reset SERVER_NAME --project=PROJECT_ID --region=REGION

      サーバーの再起動リクエストのステータスが出力に表示されます。

      Reset request issued for: [SERVER_NAME]
      


      Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
      コマンドを入力すると、Bare Metal Solution サーバーが再起動します。サーバーの構成によっては、再起動が完了するまでに 15～60 分ほどかかります。

      このコマンド出力からオペレーション ID を調べて、再起動のステータスを確認します。オペレーション ID を使用して再起動のステータスを確認するには、長時間実行オペレーションのステータスの表示をご覧ください。

  2. サーバーの電源をオンにするには、gcloud bms instances start コマンドを使用します。

    gcloud bms instances start SERVER_NAME --project=PROJECT_ID --region=REGION

    サーバーの再起動リクエストのステータスが出力に表示されます。

    Start request issued for: [SERVER_NAME]
    


    Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
    ほとんどの場合、サーバーの電源はオンのままです。電源をオフにする必要がある場合は、次のオプションを使用します。

    • サーバーのオペレーティング システムのシャットダウン コマンドを使用します。
    • 一部のアプリケーションでは、再イメージ後にサーバーの電源が自動的にオフになります。

  3. サーバーの電源をオフにするには、gcloud bms instances stop コマンドを使用します。

    gcloud bms instances stop --project=PROJECT_ID --region=REGION SERVER_NAME

API

  1. Bare Metal Solution サーバーの電源を切って再起動するには、次の操作を行います。

    1. API の設定手順が完了していることを確認します。

      サーバーを再起動するには、Bare Metal Solution API と gcloud CLI を有効にする必要があります。また、Bare Metal Solution 管理者または Bare Metal Solution 編集者の IAM ロールを付与する必要があります。

    2. Bare Metal Solution サーバーにログインしてサーバーの再起動を監視します。

      • Google Cloud コンソール ウィンドウを開きます。
      • [Compute Engine] > [VM インスタンス] の順に選択して、ジャンプホスト VM インスタンスに移動します。
      • [SSH] ボタンをクリックして、ジャンプホスト VM インスタンスに接続します。

      • Bare Metal Solution サーバーにログインするには、ジャンプホストのコマンドラインで SSH コマンドを入力します。

        [username@instance-jump-host ~]$ ssh customeradmin@bms-ip-address>
customeradmin@bms-ip-address's password: bms-password
Last login: Mon Mar 15 22:43:19 2022 from bms-ip-address
[customeradmin@BMS_SERVER_NAME ~]$

      • top コマンドを入力して、サーバーが稼働していることを確認します。このウィンドウで再起動の進行状況をモニタリングできます。

    3. 再起動コマンドを実行します。

      • Cloud Shell ウィンドウを開きます。

      • 次のコマンドに、 Google Cloud プロジェクト ID、リージョン、Bare Metal Solution サーバー名を追加します。

        curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/BMS_SERVER_NAME:reset"

      • コマンドをコピーして Cloud Shell ウィンドウに貼り付け、Enter キーまたは Return キーを押します。

        Bare Metal Solution サーバーが再起動します。サーバーの構成によっては、再起動が完了するまでに 15～60 分ほどかかります。

        このコマンド出力からオペレーション ID を調べて、再起動のステータスを確認します。オペレーション ID を使用してステータスを表示するには、長時間実行オペレーションのステータスの表示をご覧ください。

        {
 "name": "operations/5c0c8b3f-5edc-4117-be9f-812af9740aaf"
}

        サーバーの再起動中は、ping または SSH を使用してジャンプホスト VM インスタンスから Bare Metal Solution サーバーにアクセスすることはできません。数分後、Bare Metal Solution サーバーはオンラインに戻ります。

        サーバーがオンラインに戻ったら、ping を正常に発行できます。また、SSH を使用してジャンプホスト VM インスタンスから Bare Metal Solution サーバーにアクセスできます。

    Bare Metal Solution サーバーの再起動の詳細については、Bare Metal Solution API をご覧ください。

  2. サーバーの電源をオンにするには、プロジェクト ID、リージョン、サーバー名を入力し、次の curl コマンドを実行します。

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:start"

    ほとんどの場合、サーバーの電源はオンのままです。電源をオフにする必要がある場合は、次のオプションを使用します。

    • サーバーのオペレーティング システムのシャットダウン コマンドを使用します。
    • 一部のアプリケーションでは、再イメージ後にサーバーの電源が自動的にオフになります。

  3. サーバーの電源をオフにするには、プロジェクト ID、リージョン、サーバー名を入力し、次の curl コマンドを実行します。

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:stop"

サーバーの起動、停止、再起動が完了するまでに時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

サーバーのステータスを確認する

サーバーはライフサイクルを通じて多くの状態に遷移します。サーバーを起動すると、Bare Metal Solution はサーバーのリソースをプロビジョニングします。次に、サーバーが起動シーケンスの準備をします。サーバーが起動すると、サーバーは実行状態になります。通常のオペレーションでは、実行中のサーバーを停止して再起動できます。

サーバーは次のいずれかの状態になります。

  • PROVISIONING: サーバーにリソースが割り当てられます。サーバーはまだ実行されていません。

  • STARTING: リソースが取得されています。サーバーを起動しています。

    起動オペレーションは通常 30 分かかります。その後、サーバーの状態が RUNNING に設定されます。

  • RUNNING: デモサーバーが起動して稼働しています。

    サーバーの状態は RUNNING ですが、サーバーを使用できない場合は起動中である可能性があります。これは、サーバーの容量が大きい場合や、ストレージ ボリュームと LUN が多い場合に発生することがあります。詳しくは、サーバーの起動に時間がかかるをご覧ください。

  • STOPPING: サーバーを停止しています。

  • SHUTDOWN: サーバーが停止し、電源がオフになります。

  • DELETED: サーバーが削除されています。

コンソール

  1. [Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。

  2. [ステータス] 列で、サーバーのステータスを確認できます。

gcloud

サーバーのステータスを確認するには、gcloud bms instances describe コマンドを実行します。

gcloud bms instances describe --project=PROJECT_ID --region=REGION SERVER_NAME

サーバーのステータスは、出力の state フィールドで確認できます。次に例を示します。

state: RUNNING

API

サーバーのステータスを確認するには、次の curl コマンドにプロジェクト ID、リージョン、サーバー名を入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

サーバーのステータスは、出力の state フィールドで確認できます。次に例を示します。

"state" : "RUNNING"

Bare Metal Solution 環境のリソースを管理する

サーバー、ネットワーキング、ストレージなどの Bare Metal Solution 環境内のリソースのステータスを表示するには、Bare Metal Solution 管理 API、gcloud コマンド、 Google Cloud コンソールを使用します。

Bare Metal Solution API の設定を確認する

リソースのステータスを表示するには、Bare Metal Solution プロジェクトで Bare Metal Solution API と gcloud CLI を有効にするする必要があります。また、Bare Metal Solution 管理者や Bare Metal Solution 編集者などの Bare Metal Solution の IAM ロールをプリンシパルに付与する必要があります。

組織とフォルダ内の Bare Metal Solution リソースを一覧表示する

組織レベルまたはフォルダレベルで Bare Metal Solution リソースの確認が必要になることがあります。組織レベルまたはフォルダレベルでリソースを一覧表示するには、対応するレベルでそれらのリソースを一覧表示する IAM 権限が必要です。

ユーザーに IAM 権限を付与する方法については、IAM を使用した組織リソースのアクセス制御をご覧ください。

次に、組織またはフォルダ内のストレージ ボリュームを一覧表示する Python スクリプトのサンプルを示します。このサンプル スクリプトは、要件に合わせて変更して使用することができます。たとえば、attached=false などのフィルタを使用すると、接続されていないすべてのストレージ ボリュームを一覧表示できます。

このスクリプトを使用して組織レベルでストレージ ボリュームを一覧表示するには、組織レベルで次の IAM 権限が必要です。

  • resourcemanager.folders.get
  • resourcemanager.folders.list
  • resourcemanager.organizations.get
  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • baremetalsolution.volumes.list
  • baremetalsolution.luns.list

#!/usr/bin/env python

# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.


# This file is automatically generated. Please do not modify it directly.
# Find the relevant recipe file in the samples/recipes or samples/ingredients
# directory and apply your changes there.

from typing import Sequence
from typing import Tuple
from absl import app
from absl import flags
from google.api_core.exceptions import PermissionDenied
from google.cloud import resourcemanager_v3
from google.cloud.bare_metal_solution_v2.services.bare_metal_solution import BareMetalSolutionClient
from google.cloud.bare_metal_solution_v2.types import ListVolumesRequest


_ORGANIZATION_ID = flags.DEFINE_string(
    "organization-id",
    None,
    "Your organization id retrieved from its name:"
    " organizations/<organization-id>.",
)
_FOLDER_ID = flags.DEFINE_string(
    "folder-id",
    None,
    "Your folder id retrieved from its name: folders/<folder-id>.",
)
_FILTER = flags.DEFINE_string(
    "filter",
    "",
    "Filter for the resource list request. Syntax should be per"
    " https://google.aip.dev/160",
)


def get_projects(
    parent: str,
    folders_client: resourcemanager_v3.FoldersClient,
    projects_client: resourcemanager_v3.ProjectsClient,
) -> str:
  """Retrieves a list of all project IDs available in given organization or folder parent.

  Args:
      parent: Organization ID or Folder ID of the Cloud org or folder you want
        to recursively list project IDs from.
      folders_client: Resource manager folder API client.
      projects_client: Resource manager project API client.

  Yields:
      The list of project ids as a string.
  """
  projects_request = resourcemanager_v3.ListProjectsRequest(parent=parent)
  for project in projects_client.list_projects(request=projects_request):
    yield project.project_id

  folders_request = resourcemanager_v3.ListFoldersRequest(parent=parent)
  for folder in folders_client.list_folders(request=folders_request):
    get_projects(folder.name, folders_client, projects_client)


def get_volumes_list(parent: str, filter: str) -> Tuple[str, str]:
  """Retrieves a list of all volume names available in given project.

  Args:
      parent: Organization ID or Folder ID of the Cloud org or folder you want
        to recursively list volumes from.
      filter: Filter string for the resource list call. Syntax is per
        https://google.aip.dev/160.

  Returns:
      The list of volumes as a string and the list of PermissionDenied errors in
      individual folder or projects, if any.
  """
  folders_client = resourcemanager_v3.FoldersClient()
  projects_client = resourcemanager_v3.ProjectsClient()
  bms_client = BareMetalSolutionClient()
  output = []
  errors = []

  try:
    for project in get_projects(parent, folders_client, projects_client):
      volumes_list_request = ListVolumesRequest(
          parent="projects/" + project + "/locations/global",
          filter=filter,
      )
      try:
        for volume in bms_client.list_volumes(request=volumes_list_request):
          output.append(f" -  {volume.name}")
      # This could happen because BMS API is not enabled in a certain project.
      except PermissionDenied as e:
        errors.append(
            f"Unable to list bms resources for project {project}: {e}"
        )
  except PermissionDenied as e:
    errors.append(f"Unable to access folder or project: {e}")
  return "\n".join(output), "\n".join(errors)


def main(_: Sequence[str]):
  if _ORGANIZATION_ID.value is not None and _FOLDER_ID.value is not None:
    raise Exception("Only one of organization ID or folder ID must be provided")
  elif _ORGANIZATION_ID.value is None and _FOLDER_ID.value is None:
    raise Exception(
        "Either one of organization ID or folder ID must be provided"
    )
  elif _ORGANIZATION_ID.value is not None:
    parent = f"organizations/{_ORGANIZATION_ID.value}"
  else:
    parent = f"folders/{_FOLDER_ID.value}"
  volumes, errors = get_volumes_list(parent, filter=_FILTER.value)
  print(
      "=================== Flat list of volumes in the folder or organization"
      " ==================="
  )
  print(volumes)

  print(
      "=================== List of folders or projects with errors"
      " ==================="
  )
  print(errors)


if __name__ == "__main__":
  app.run(main)

サーバーを管理する

Bare Metal Solution 環境のサーバーは、次の方法で管理できます。

サーバーを表示する

Bare Metal Solution サーバーの詳細を表示するには、次の操作を行います。

コンソール

  1. [サーバー] ページに移動します。

    [サーバー] に移動

    [サーバー] ページには、すべてのサーバーと次の詳細が表示されます。

    フィールド 説明 例
    ステータス サーバーの可用性を示します。 チェックマークが付いた緑の円は、サーバーがプロビジョニングされて使用可能であることを示しています。
    名前 サーバー名。名前をクリックすると、サーバーに関する追加情報が表示されます。

    注: サーバーのプロビジョニング時に名前を入力しなかった場合は、このフィールドに ID が表示されます。    		 server-1
    ID サーバーに割り当てられた ID。
    • ID をクリックすると、サーバーに関する基本情報が表示されます。
    • このリソースのトラブルシューティングを行う場合は、ID を Google Cloud サポートと共有してください。
    		 at-1234567-svr001
    ロケーション Bare Metal Solution のリージョン asia-southeast1
    Pod

    サーバーを含む Pod。Pod は、Bare Metal Solution リソースを含む分離単位です。異なる Pod のリソースは接続できません。1 つのリージョンに複数の Pod を設定できます。

    [Pod] 列はデフォルトで無効になっています。有効にするには、次の操作を行います。

    1. [列表示オプション] をクリックします。
    2. [Pod] チェックボックスをオンにします。
    3. [OK] をクリックします。

    [Pod] 列を有効にしない場合は、サーバー名をクリックしてサーバーの Pod を表示できます。

    		 asia-southeast1-pod1
    サーバーの種類 サーバーの仕様 o2-standard-32-metal
    クライアント IP Google Virtual Private Cloud に接続するサーバー IP アドレス 10.200.0.5
    プライベート IP 他の Bare Metal Solution 環境リソースに接続するサーバー IP アドレス 192.168.2.5
    ラベル このサーバーに追加したラベルが表示されます。

    ラベルのテキストをコピーし、[ステータス] フィールドのすぐ上にある [フィルタ] ボックスに貼り付けることで、コンソールの出力をフィルタリングできます。    		 environment:test
    サーバーのアクティビティ ワークロードに影響する可能性がある Bare Metal Solution インフラストラクチャの問題について通知します。サーバーが正常に動作していて、問題がない場合、[サーバー アクティビティ] フィールドは空になります。

    ただし、サーバーに問題が発生した場合は、「異常検出」と表示されます。この場合は、Google で調査を行い、結果をお知らせします。問題の解決中にワークロードが中断する場合は、カスタマーケアにお問い合わせください。

  2. サーバーの詳細を表示するには、サーバーの名前をクリックします。

    [サーバーの詳細] ページに、次の詳細情報が表示されます。

    フィールド 説明
    ハイパースレッディング サーバーでハイパースレッディングが有効になっているかどうかを示します。
    OS イメージ サーバーで実行されている OS。
    ファームウェアのバージョン サーバーの現在のファームウェア バージョン。
    ネットワーク テンプレート サーバーで使用されているネットワーク テンプレート。
    SSH 認証鍵 サーバーの SSH 認証鍵（構成している場合）。
    パスワード暗号鍵 サーバーの暗号鍵（構成している場合）。
    ログイン情報 ログイン パスワードの取得手順。
    ユーザー アカウント ユーザー名と、暗号化された対応するパスワード。
    ネットワーク サーバーに接続されているネットワークの詳細。
    LUN サーバーに接続されている LUN の詳細。

gcloud

  1. Bare Metal Solution 環境内のサーバーを一覧表示してステータスを確認するには、プロジェクト ID を入力して gcloud bms instances list コマンドを発行します。

    gcloud bms instances list --project=PROJECT_ID

    次の出力例は、サーバー情報（サーバー名、種類、IP アドレス、状態など）を示しています。

    NAME               PROJECT              REGION           MACHINE_TYPE          IP_ADDRESSES             STATE
SERVER_NAME      PROJECT_ID        REGION         o2-standard-32-metal  192.168.1.1,192.168.2.1  RUNNING

    その他のコマンド オプション:

    • --region: 特定の Google Cloud リージョン内のデバイスを表示します。
    • --limit: 特定のデバイス数のみを表示するように出力を制限します。

  2. Bare Metal Solution 環境内の特定のサーバーのネットワークとストレージの情報を取得するには、サーバー名、プロジェクト ID、リージョンを入力して、gcloud bms instances describe コマンドを実行します。

    gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION

    次の出力例は、12 個の LUN、192.168.1.1 のクライアント ネットワーク、192.168.2.1 のプライベート ネットワークを持つ運用サーバーを示しています。

    luns:
- bootLun: true
  name: SERVER_NAME-lun000-b1
  sizeGb: '200'
  state: READY
  storageVolume: SERVER_NAME-vol000-b1
- name: STORAGE_DEVICE_NAME-lun001
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun002
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun003
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun004
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun005
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun006
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun007
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun008
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun009
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun010
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun011
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun012
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
machineType: o2-standard-32-metal
name: projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME
networks:
- ipAddress: 192.168.1.1
  macAddress:
  - 34:80:0D:52:AF:28
  - 34:80:0D:15:3E:0D
  network: STORAGE_DEVICE_NAME-vlan001
- ipAddress: 192.168.2.1
  macAddress:
  - 34:80:0D:52:AF:38
  - 34:80:0D:15:3E:1D
  network: STORAGE_DEVICE_NAME-vlan002
state: RUNNING

API

  1. Google Cloud コンソールで Cloud Shell ターミナル ウィンドウを開きます。

  2. Bare Metal Solution 環境のサーバーを一覧表示してステータスを確認するには、次の curl コマンドにプロジェクト ID とリージョンを入力します。このコマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter キーまたは Return キーを押します。

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"

  3. Bare Metal Solution 環境のサーバーのネットワークとストレージの情報を取得するには、次のコマンドを実行します。

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

ラベルを使用してサーバーを整理する

サーバーを整理するために、ラベルを使用できます。ラベルは Key-Value ペアで、各サーバーに設定し、ラベルに基づいてサーバーをフィルタリングできます。たとえば、ラベルを使用して、サーバーを目的、環境、場所、部門などでグループ化できます。ラベルはオプションです。

サーバーのラベルを追加または更新する

既存のサーバーのラベルを追加または更新できます。

コンソール

  1. [Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。

  2. ラベルを付けるサーバーで、[] をクリックします。

  3. [ラベルを編集] をクリックします。

  4. [ラベルエディタ] ページで次の操作を行います。

    1. [ラベルを追加] をクリックして、Key-Value ペアを追加します。
    2. ラベルを更新するには、既存のラベルを選択して値を変更します。
    3. [送信] をクリックします。

  5. [サーバー] ページに戻り、ページを更新して変更を表示します。

gcloud

サーバーのラベルを追加または更新するには、gcloud bms instances update コマンドを使用して、--update-labels オプションを指定します。

次のサンプル コマンドでは、environment = dev ラベルと location = branch ラベルを追加します。

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

既存のラベルに新しい値を指定すると、既存のラベルが新しいラベル値で更新されます。新しいラベルを指定すると、新しいラベルがラベルのリストに追加されます。

API

サーバーのラベルを追加または更新するには、次の curl コマンドでプロジェクト ID、リージョン、サーバー名、ラベルのリストを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプル コマンドでは、environment = test というラベルを割り当てます。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

サーバーからラベルを削除する

サーバーからラベルを削除できます。

コンソール

  1. [Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。

  2. 削除するラベルを持つサーバーの をクリックします。

  3. [ラベルを編集] をクリックします。

  4. [ラベルエディタ] ページで次の操作を行います。

    1. ラベルを削除するには、 をクリックします。
    2. [送信] をクリックします。

  5. [サーバー] ページに戻り、ページを更新して変更を表示します。

gcloud

サーバーからラベルを削除するには、次のオプションを指定して gcloud bms instances update コマンドを使用します。

  • --remove-labels: 指定したラベルを削除します。
  • --clear-labels: すべてのラベルを削除します。

次のサンプル コマンドは、ラベル department をサーバーから削除します。

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

次のサンプル コマンドは、サーバーからすべてのラベルを削除します。