このページでは、単一テナントノードで VM をプロビジョニングする方法について説明します。単一テナントノードは、単一プロジェクトからの VM のみを実行する物理サーバーです。単一テナントノードで VM をプロビジョニングする前に、単一テナントノードの概要をご覧ください。
単一テナントノードで VM をプロビジョニングするには、次の手順を行う必要があります。
単一テナントノード テンプレートを作成する。単一テナントノード テンプレートは、単一テナントノード グループ内のすべての単一テナントノードに共通のプロパティを指定します。
前の手順で作成した単一テナントノード テンプレートを使用して、単一テナントノードを作成する。
VM を作成し、単一テナントノード グループで VM をプロビジョニングする。
始める前に
- 単一テナントノードで VM をプロビジョニングする前に、割り当てを確認します。予約するノードの数とサイズによっては、割り当て量の追加リクエストが必要になる場合があります。
-
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud のサービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
Google Cloud コンソールで、[単一テナントノード] ページに移動します。
[ノードグループを作成] をクリックします。
ノードグループの名前を指定します。
ノード テンプレートを作成する [リージョン] を指定します。指定したリージョンの任意のゾーンで、このノード テンプレートを使用してノードグループを作成できます。
ゾーンを指定し、[続行] をクリックします。
[ノード テンプレート] リストで、[ノード テンプレートを作成] をクリックして、単一テナントノード テンプレートの作成を開始します。
ノード テンプレートの名前を指定します。
このノード テンプレートに基づいて作成する、ノードグループ内の単一テナントノードのノードタイプを指定します。
(省略可): ノード テンプレートには次のプロパティも指定できます。
- ローカル SSD と GPU アクセラレータを追加します。
[CPU のオーバーコミットを有効にする] を選択して、ノードにスケジュールされている各 VM の CPU のオーバーコミット レベルを制御します。
ノード アフィニティ ラベルを追加します。アフィニティ ラベルを使用すると、ノードとノードグループを論理的にグループ化できます。後で VM をプロビジョニングする際、VM にアフィニティ ラベルを指定して、特定のノードまたはノードグループのセットに VM をスケジュールできます。詳細については、ノード アフィニティとアンチアフィニティをご覧ください。
[作成] をクリックして、ノード テンプレートの作成を完了します。
(省略可)別のリージョンに新しい単一テナントノード テンプレートを追加するには、上記の手順を繰り返します。
TEMPLATE_NAME
: 新しいノード テンプレートの名前。NODE_TYPE
: このテンプレートに基づいて作成された単一テナントノードのノードタイプ。gcloud compute sole-tenancy node-types list
コマンドを使用して、各ゾーンで使用可能なノードタイプのリストを取得します。REGION
: ノード テンプレートを作成するリージョン。指定したリージョンの任意のゾーンで、このテンプレートを使用してノードグループを作成できます。AFFINITY_LABELS
: アフィニティ ラベルの Key-Value([KEY=VALUE,...]
)。アフィニティ ラベルを使用すると、ノードとノードグループを論理的にグループ化できます。後で VM をプロビジョニングする際、VM にアフィニティ ラベルを指定して、特定のノードまたはノードグループのセットに VM をスケジュールできます。詳細については、ノード アフィニティとアンチアフィニティをご覧ください。GPU_TYPE
: このノード テンプレートに基づいて作成された各単一テナントノードの GPU のタイプ。GPU のゾーンの可用性については、gcloud compute accelerator-types list
コマンドを使用して、n1
またはg2
単一テナントノード タイプが利用可能なゾーンを選択します。ゾーンの可用性に応じて、次のいずれかに設定します。nvidia-l4
nvidia-tesla-p100
nvidia-tesla-p4
nvidia-tesla-t4
nvidia-tesla-v100
GPU_COUNT
: GPU のタイプに応じて指定する GPU の数。次の表に示すように、GPU のタイプに対して指定された値を設定します。GPU_TYPE
GPU_COUNT
nvidia-l4
8 nvidia-tesla-p100
4 nvidia-tesla-p4
4 nvidia-tesla-t4
4 nvidia-tesla-v100
8 DISK_COUNT
: SSD ディスクの数。16
または24
に設定します。DISK_SIZE
: ローカル SSD のパーティション サイズの値(省略可)。単位は GB です。サポートされているパーティション サイズは375
のみです。この値を設定しない場合は、デフォルト値の375
が使用されます。CPU_OVERCOMMIT_TYPE
: VM の CPU のオーバーコミット タイプ。enabled
またはnone
に設定します。PROJECT_ID
: プロジェクト ID。REGION
: ノード テンプレートを作成するリージョン。指定したリージョンの任意のゾーンで、このテンプレートを使用してノードグループを作成できます。TEMPLATE_NAME
: 新しいノード テンプレートの名前。NODE_TYPE
: このテンプレートに基づいて作成された単一テナントノードのノードタイプ。nodeTypes.list
メソッドを使用して、各ゾーンで使用可能なノードタイプのリストを取得します。KEY
: Key-Value ペアとして表現されるノード アフィニティ ラベルのキー部分を指定するnodeAffinityLabels
の値。アフィニティ ラベルを使用すると、ノードとノードグループを論理的にグループ化できます。後で VM をプロビジョニングする際、VM にアフィニティ ラベルを指定して、特定のノードまたはノードグループのセットに VM をスケジュールできます。詳細については、ノードのアフィニティとアンチアフィニティをご覧ください。VALUE
: ノード アフィニティ ラベルの Key-Value ペアの値の部分を指定するnodeAffinityLabels
の値。GPU_TYPE
: このノード テンプレートに基づいて作成された各単一テナントノードの GPU のタイプ。GPU のゾーンの可用性については、gcloud compute accelerator-types list
コマンドを使用して、n1
またはg2
単一テナントノード タイプが利用可能なゾーンを選択します。ゾーンの可用性に応じて、次のいずれかに設定します。nvidia-l4
nvidia-tesla-p100
nvidia-tesla-p4
nvidia-tesla-t4
nvidia-tesla-v100
GPU_COUNT
: このノード テンプレートに基づいて作成された各単一テナントノードの GPU の数。次の表に示すように、GPU のタイプに対して指定された値を設定します。GPU_TYPE
GPU_COUNT
nvidia-l4
8 nvidia-tesla-p100
4 nvidia-tesla-p4
4 nvidia-tesla-t4
4 nvidia-tesla-v100
8 DISK_SIZE
: ローカル SSD のパーティション サイズの値(省略可)。単位は GB です。サポートされているパーティション サイズは375
のみです。この値を設定しない場合は、デフォルト値の375
が使用されます。DISK_COUNT
: SSD ディスクの数。16
または24
に設定します。CPU_OVERCOMMIT_TYPE
: CPU オーバーコミット タイプ。enabled
、none
、CPU_OVERCOMMIT_TYPE_UNSPECIFIED
のいずれかに設定します。Google Cloud コンソールで、[単一テナントノード] ページに移動します。
[ノードグループを作成] をクリックしてノードグループの作成を開始します。
ノードグループの名前を指定します。
ノードグループのリージョンを指定して、そのリージョンで使用可能なノード テンプレートを表示します。
ノードグループを作成するリージョン内の [ゾーン] を指定します。
ノード テンプレートを指定してノードグループを作成するか、[ノード テンプレートを作成] をクリックして新しい単一テナントノード テンプレートを作成します。選択したノード テンプレートがノードグループに適用されます。
ノードグループのオートスケーラーの自動スケーリング モードには、次のいずれかを選択します。
オフ: ノードグループのサイズを手動で管理します。
オン: ノードグループに対するノードの追加または削除を自動的に行います。
スケールアウトのみ: 追加の容量が必要な場合に、ノードグループにノードを追加します。
ノードグループのノード数を指定します。ノードグループのオートスケーラーを有効にする場合は、ノードグループのサイズの範囲を指定します。この値は後で手動で変更できます。
[メンテナンス設定の構成] セクションで、単一テナントノード グループのメンテナンス ポリシーを次のいずれかの値に設定します。メンテナンス ポリシーを使用すると、ホスト メンテナンス イベント中のノードグループ上の VM の動作を構成できます。詳細については、メンテナンス ポリシーをご覧ください。
- デフォルト
- 再起動
- ノードグループ内で移行
単一テナントノード グループのメンテナンスは、次のように通常のメンテナンスの時間枠と高度なメンテナンス管理のいずれかを選択できます。
メンテナンスの時間枠: 単一テナントノード グループ内のノードに対して計画的なメンテナンス イベントを発生させる期間を選択します。
単一テナンシーに対して高度なメンテナンス管理を有効にする: 単一テナンシーに対する高度なメンテナンス管理により、単一テナントノード グループの計画メンテナンス イベントを制御し、メンテナンス関連の中断を最小限に抑えることができます。高度なメンテナンス管理を有効にするには、[単一テナンシーに対して高度なメンテナンス管理を有効にする] をクリックして、オンの位置に切り替えます。ノードのメンテナンスにこのオプションを使用すると、[メンテナンスの時間枠] フィールドは無効になり、メンテナンスは高度なメンテナンス管理での構成に従って行われます。
高度なメンテナンス管理は、デフォルトのメンテナンス ポリシーのみをサポートします。
共有設定の構成で次のいずれかを指定して、共有設定を構成します。
- ノードグループを組織内のすべてのプロジェクトと共有するには、[このノードグループを組織内のすべてのプロジェクトと共有する] を選択します。
- ノードグループを組織内の特定のプロジェクトと共有するには、[このノードグループを組織内の選択したプロジェクトと共有する] を選択します。
ノードグループを共有しない場合は、[このノードグループを他のプロジェクトと共有しない] を選択します。ノードグループの共有の詳細については、単一テナントノード グループを共有するをご覧ください。
[作成] をクリックして、ノードグループの作成を完了します。
GROUP_NAME
: 新しいノードグループの名前。TEMPLATE_NAME
: このグループの作成に使用するノード テンプレートの名前。TARGET_SIZE
: グループ内に作成するノードの数。ZONE
: ノードグループを作成するゾーン。これは、ノードグループのベースとするノード テンプレートと同じリージョンに存在している必要があります。MAINTENANCE_POLICY
: ノードグループに適用するメンテナンス ポリシー。詳細については、メンテナンス ポリシーをご覧ください。次のいずれかの値を指定する必要があります。default
restart-in-place
migrate-within-node-group
また、
--maintenance-interval
フラグを使用して、単一テナントノード グループに高度なメンテナンス管理を有効にすることもできます。詳細については、単一テナントノードで高度なメンテナンス管理を有効にするをご覧ください。START_TIME
: このノードグループに含まれる VM のメンテナンスの時間枠の開始時刻(GMT)。00:00
、04:00
、08:00
、12:00
、16:00
、20:00
のいずれかに設定します。設定しないと、ノードグループにメンテナンスの時間枠が設定されません。AUTOSCALER_MODE
: ノードグループに適用するオートスケーラー ポリシー。次のいずれかを指定する必要があります。off
: ノードグループのサイズを手動で管理します。on
: ノードグループにノードを自動的に追加する、またはノードグループからノードを自動的に削除します。only-scale-out
: 追加の容量が必要な場合にノードをノードグループに追加します。
MIN_NODES
: ノードグループの最小サイズ。デフォルト値は0
で、MAX_NODES
以下の整数値にする必要があります。MAX_NODES
: ノードグループの最大サイズ。指定する値は100
以下で、MIN_NODES
以上でなければなりません。AUTOSCALER_MODE
がoff
に設定されていない場合は、この値を指定する必要があります。PROJECT_ID
: プロジェクト ID。ZONE
: ノードグループを作成するゾーン。これは、ノードグループのベースとなるノード テンプレートと同じリージョンに存在している必要があります。TARGET_SIZE
: グループ内に作成するノードの数。REGION
: ノードグループを作成するリージョン。使用するノード テンプレートは、選択したリージョン内に存在している必要があります。TEMPLATE_NAME
: このグループの作成に使用するノード テンプレートの名前。GROUP_NAME
: 新しいノードグループの名前。MAINTENANCE_POLICY
: ノードグループに適用するメンテナンス ポリシー。次のいずれかの値を指定する必要があります。DEFAULT
RESTART_IN_PLACE
MIGRATE_WITHIN_NODE_GROUP
また、
maintenanceInterval
フィールドを使用して、単一テナントノード グループに高度なメンテナンス管理を有効にすることもできます。詳細については、単一テナントノードで高度なメンテナンス管理を有効にするをご覧ください。START_TIME
: このノードグループに含まれる VM のメンテナンスの時間枠の開始時刻(GMT)。00:00
、04:00
、08:00
、12:00
、16:00
、20:00
のいずれかに設定します。設定しないと、ノードグループにメンテナンスの時間枠が設定されません。AUTOSCALER_MODE
: ノードグループに適用するオートスケーラー ポリシー。次のいずれかの値を指定する必要があります。OFF
: ノードグループのサイズを手動で管理します。ON
: ノードグループにノードを自動的に追加する、またはノードグループからノードを自動的に削除します。ONLY_SCALE_OUT
: 追加の容量が必要な場合にノードをノードグループに追加します。
MIN_NODES
: ノードグループの最小サイズ。デフォルトは0
です。MAX_NODES
以下の整数値を指定する必要があります。MAX_NODES
: ノードグループの最大サイズ。指定する値は100
以下で、MIN_NODES
以上でなければなりません。AUTOSCALER_MODE
がOFF
に設定されていない場合は、この値を指定する必要があります。Google Cloud コンソールで、[単一テナントノード] ページに移動します。
[ノードグループ] をクリックします。
VM インスタンスをプロビジョニングするノードグループの [名前] をクリックします。また任意ですが、特定の単一テナントノードで VM をプロビジョニングするには、VM をプロビジョニングする特定の単一テナントノードの名前をクリックします。
[インスタンスを作成] をクリックしてこのノードグループに VM インスタンスをプロビジョニングして、自動的に割り当てられる [名前]、[リージョン]、[ゾーン] の値を確認し、必要に応じて値を変更します。
[マシン ファミリー]、[シリーズ]、[マシンタイプ] を指定して、[マシンの構成] を選択します。単一テナントノードのタイプに対応する [シリーズ] を選択します。
[ブートディスク]、[ファイアウォール] などの設定を必要に応じて変更します。
[単一テナンシー] をクリックして、自動的に割り当てられた [ノード アフィニティのラベル] を確認し、[参照] を使用して必要に応じて調整します。
[管理] をクリックし、[ホスト メンテナンス時] で次のいずれかを選択します。
VM インスタンスを移行(推奨): メンテナンス イベント中にノードグループ内の別のノードに VM が移行される。
終了: メンテナンス イベント中に VM が停止します。
[自動再起動] で次のいずれかを選択します。
オン(推奨): メンテナンス イベントのために VM が停止した場合、VM を自動的に再起動します。
オフ: メンテナンス イベント後、VM は自動的に再起動しません。
[作成] をクリックして、単一テナント VM の作成を完了します。
VM_NAME
: 新しい単一テナント VM の名前。ZONE
: 単一テナント VM をプロビジョニングするゾーン。IMAGE_FAMILY
: VM の作成に使用するイメージのイメージ ファミリー。IMAGE_PROJECT
: イメージ ファミリーのイメージ プロジェクト。GROUP_NAME
: VM をプロビジョニングするノードグループの名前。MACHINE_TYPE
: 単一テナント VM のマシンタイプ。gcloud compute machine-types list
コマンドを使用して、プロジェクトで使用可能なマシンタイプのリストを取得します。MAINTENANCE_POLICY
: メンテナンス イベント中の単一テナント VM の再起動動作を指定します。次のいずれかに設定します。MIGRATE
: メンテナンス イベント中にノードグループの別のノードに VM が移行されます。TERMINATE
: メンテナンス イベント中に VM が停止します。
GPU_TYPE
: GPU のタイプ。ノード テンプレートの作成時に指定されたアクセラレータ タイプのいずれかに設定します。GPU_COUNT
: この VM に接続するノード テンプレートによって指定された合計 GPU の数。デフォルト値は1
です。SSD_INTERFACE
: ローカル SSD インターフェースのタイプ。ローカル SSD をサポートするノード テンプレートから作成されたインスタンスにのみ設定できます。インスタンスの作成時にこれを指定し、ノード テンプレートがローカル SSD をサポートしていない場合は、インスタンスの作成に失敗します。ブートディスク イメージ ドライバが NVMe 用に最適化されている場合はnvme
、それ以外の場合はscsi
に設定します。ローカル SSD パーティションごとに、このフラグと対応する値を 1 回指定します。PROJECT_ID
: プロジェクト ID。VM_ZONE
: 単一テナント VM をプロビジョニングするゾーン。MACHINE_TYPE_ZONE
: マシンタイプのゾーン。MACHINE_TYPE
: 単一テナント VM のマシンタイプ。machineTypes.list
メソッドを使用して、プロジェクトで使用可能なマシンタイプのリストを取得します。VM_NAME
: 新しい単一テナント VM の名前。MAINTENANCE_POLICY
: メンテナンス イベント中の単一テナント VM の再起動動作を指定します。次のいずれかに設定します。MIGRATE
: メンテナンス イベント中にノードグループの別のノードに VM が移行されます。TERMINATE
: メンテナンス イベント中に VM が停止します。
RESTART_ON_FAILURE
: 停止後に単一テナントの VM を再起動するかどうかを示します。デフォルトはtrue
です。GROUP_NAME
: VM をプロビジョニングするノードグループの名前。NETWORK
: この VM のネットワーク リソースの URL。REGION
: この VM のサブネットワークが属するリージョン。SUBNETWORK
: この VM のサブネットワーク リソースの URL。GPU_TYPE
: GPU のタイプ。ノード テンプレートの作成時に指定されたアクセラレータ タイプのいずれかに設定します。GPU_COUNT
: この VM に接続するノード テンプレートによって指定された合計 GPU の数。デフォルト値は1
です。IMAGE_PROJECT
: イメージ ファミリーのイメージ プロジェクト。IMAGE_FAMILY
: VM の作成に使用するイメージのイメージ ファミリー。LOCAL_SSD_ZONE
: ローカル SSD のゾーン。SSD_INTERFACE
: ローカル SSD インターフェースのタイプ。ブートディスク イメージ ドライバが NVMe 用に最適化されている場合はNVME
、それ以外の場合はSCSI
に設定します。gcloud compute instance-templates create
コマンドを使用して、単一テナントノード グループで作成する VM のグループのマネージド インスタンス グループ テンプレートを作成します。gcloud compute instance-templates create INSTANCE_TEMPLATE \ --machine-type=MACHINE_TYPE \ --image-project=IMAGE_PROJECT \ --image-family=IMAGE_FAMILY \ --node-group=GROUP_NAME \ [--accelerator type=GPU_TYPE,count=GPU_COUNT \] [--local-ssd interface=SSD_INTERFACE]
次のように置き換えます。
INSTANCE_TEMPLATE
: 新しいインスタンス テンプレートの名前。MACHINE_TYPE
: 単一テナント VM のマシンタイプ。gcloud compute machine-types list
コマンドを使用して、プロジェクトで使用可能なマシンタイプのリストを取得します。IMAGE_PROJECT
: イメージ ファミリーのイメージ プロジェクト。IMAGE_FAMILY
: VM の作成に使用するイメージのイメージ ファミリー。GROUP_NAME
: VM をプロビジョニングするノードグループの名前。このインスタンス テンプレートを使用して、複数のゾーンに存在するリージョン MIG を作成する場合は、--node-affinity-file
フラグを使用して、リージョン MIG のノードグループの値のリストを指定します。GPU_TYPE
: GPU のタイプ。ノード テンプレートの作成時に指定されたアクセラレータ タイプのいずれかに設定します。GPU_COUNT
: この VM に接続するノード テンプレートによって指定された合計 GPU の数。デフォルト値は1
です。SSD_INTERFACE
: ローカル SSD インターフェースのタイプ。ブートディスク イメージ ドライバが NVMe 用に最適化されている場合はnvme
、それ以外の場合はscsi
に設定します。ローカル SSD パーティションごとに、このフラグと対応する値を 1 回指定します。
gcloud compute instance-groups managed create
コマンドを使用して、単一テナントノード グループ内に、マネージド インスタンス グループを作成します。gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --size=SIZE \ --template=INSTANCE_TEMPLATE \ --zone=ZONE
次のように置き換えます。
INSTANCE_GROUP_NAME
: このインスタンス グループの名前。SIZE
: このインスタンス グループに含める VM の数。ノードグループには、このマネージド インスタンス グループのインスタンスに対応する十分なリソースが必要です。マネージド インスタンス グループ オートスケーラーを使用して、マネージド インスタンス グループのサイズを自動的に管理します。INSTANCE_TEMPLATE
: この MIG の作成に使用するインスタンス テンプレートの名前。テンプレートには、適切なノードグループを指す 1 つ以上のノード アフィニティ ラベルが必要です。ZONE
: マネージド インスタンス グループを作成するゾーン。リージョン MIG の場合は、--zone
フラグを--region
フラグに置き換えてリージョンを指定します。また、--zones
フラグを追加して、ノードグループが存在するすべてのゾーンを指定します。
instanceTemplates.insert
メソッドを使用して、単一テナントノード グループ内に、マネージド インスタンス グループ テンプレートを作成します。POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/TEMPLATE_ZONE/instance-templates { "name": "INSTANCE_TEMPLATE", "properties": { "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE", "scheduling": { "nodeAffinities": [ { "key": "compute.googleapis.com/node-group-name", "operator": "IN", "values": [ "GROUP_NAME" ] } ] }, "networkInterfaces": [ { "network": "global/networks/NETWORK", "subnetwork": "regions/REGION/subnetworks/SUBNETWORK" } ], "guestAccelerators": [ { "acceleratorType": GPU_TYPE, "acceleratorCount": GPU_COUNT } ], "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY" } }, { "type":"SCRATCH", "initializeParams":{ "diskType":"zones/LOCAL_SSD_ZONE/diskTypes/local-ssd" }, "autoDelete":true, "interface":"SSD_INTERFACE" } ] } }
次のように置き換えます。
PROJECT_ID
: プロジェクト ID。TEMPLATE_ZONE
: インスタンス テンプレートを作成するゾーン。INSTANCE_TEMPLATE
: 新しいインスタンス テンプレートの名前。MACHINE_TYPE_ZONE
: マシンタイプのゾーン。MACHINE_TYPE
: 単一テナント VM のマシンタイプ。machineTypes.list
メソッドを使用して、プロジェクトで使用可能なマシンタイプのリストを取得します。GROUP_NAME
: VM をプロビジョニングするノードグループの名前。このインスタンス テンプレートを使用して、複数のゾーンに存在するリージョン MIG を作成する場合は、リージョン MIG のゾーンと同じゾーンに存在するノードグループのリストを指定します。NETWORK
: このインスタンス テンプレートのネットワーク リソースの URL。REGION
: このインスタンス テンプレートのサブネットワークが属するリージョン。SUBNETWORK
: このインスタンス テンプレートのサブネットワーク リソースの URL。GPU_TYPE
: GPU のタイプ。ノード テンプレートの作成時に指定されたアクセラレータ タイプのいずれかに設定します。GPU_COUNT
: この VM に接続するノード テンプレートによって指定された合計 GPU の数。デフォルト値は1
です。IMAGE_PROJECT
: イメージ ファミリーのイメージ プロジェクト。IMAGE_FAMILY
: VM の作成に使用するイメージのイメージ ファミリー。LOCAL_SSD_ZONE
: ローカル SSD のゾーン。SSD_INTERFACE
: ローカル SSD インターフェースのタイプ。ブートディスク イメージ ドライバが NVMe 用に最適化されている場合はNVME
、それ以外の場合はSCSI
に設定します。
instanceGroupManagers.insert
メソッドを使用して、以前に作成したインスタンス テンプレートに基づいて単一テナントノード グループに MIG を作成します。また、リージョン MIG を作成する場合は、regionInstanceGroupManagers.insert
メソッドを使用し、インスタンス テンプレートに指定されているように、すべてのノードグループのリージョンとゾーンを指定します。たとえば、ゾーン MIG を作成するには、次のリクエストを使用します。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "baseInstanceName": "NAME_PREFIX", "name": "INSTANCE_GROUP_NAME", "targetSize": SIZE, "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE" }
次のように置き換えます。
PROJECT_ID
: プロジェクト ID。ZONE
: マネージド インスタンス グループを作成するゾーン。NAME_PREFIX
: マネージド インスタンス グループ内の各インスタンスの接頭辞名。INSTANCE_GROUP_NAME
: インスタンス グループの名前。SIZE
: このインスタンス グループに含める VM の数。ノードグループには、このマネージド インスタンス グループのインスタンスに対応する十分なリソースが必要です。マネージド インスタンス グループ オートスケーラーを使用して、マネージド インスタンス グループのサイズを自動的に管理します。INSTANCE_TEMPLATE
: このグループの作成に使用するインスタンス テンプレートの URL。テンプレートには、適切なノードグループを指すノード アフィニティ ラベルが必要です。
gcloud compute sole-tenancy node-templates create
コマンドを使用して、本番環境ワークロードのアフィニティ ラベルのセットを含むノード テンプレートを作成します。gcloud compute sole-tenancy node-templates create prod-template \ --node-type=n1-node-96-624 \ --node-affinity-labels workload=frontend,environment=prod
gcloud compute sole-tenancy node-templates describe
コマンドを使用して、ノード テンプレートに割り当てられたノード アフィニティ ラベルを確認します。gcloud compute sole-tenancy node-groups create
コマンドを使用して、本番環境テンプレートを使用するノードグループを作成します。gcloud compute sole-tenancy node-groups create prod-group \ --node-template=prod-template \ --target-size=1
本番環境の VM 用に、VM のアフィニティを指定する
node-affinity-prod.json
ファイルを作成します。たとえば、workload=frontend
とenvironment=prod
の両方のアフィニティを持つノード上でのみ実行される VM を指定するファイルを作成する場合があります。Cloud Shell を使用してノード アフィニティ ファイルを作成するか、選択したロケーションでノード アフィニティ ファイルを作成します。[ { "key" : "workload", "operator" : "IN", "values" : ["frontend"] }, { "key" : "environment", "operator" : "IN", "values" : ["prod"] } ]
gcloud compute instances create
コマンドでnode-affinity-prod.json
ファイルを使用して、アフィニティ ラベルが一致するノードグループで VM をスケジュールします。gcloud compute instances create prod-vm \ --node-affinity-file node-affinity-prod.json \ --machine-type=n1-standard-2
gcloud compute instances describe
コマンドを使用してscheduling
フィールドを確認し、VM に割り当てられたノード アフィニティを表示します。開発用の VM の場合、Cloud Shell を使用して
node-affinity-dev.json
を作成するか、選択したロケーションで作成することで、開発用の VM のアフィニティを指定します。たとえば、workload=frontend
が指定されているノードグループで、environment=prod
でないノードグループであれば、どのノードグループでも実行される VM を構成するファイルを作成します。[ { "key" : "workload", "operator" : "IN", "values" : ["frontend"] }, { "key" : "environment", "operator" : "NOT_IN", "values" : ["prod"] } ]
gcloud compute instances create
コマンドでnode-affinity-dev.json
ファイルを使用して、開発用 VM を作成します。gcloud compute instances create dev-vm \ --node-affinity-file=node-affinity-dev.json \ --machine-type=n1-standard-2
gcloud compute instances describe
コマンドを使用してscheduling
フィールドを確認し、VM に割り当てられているノード アンチアフィニティを表示します。[単一テナントノード] ページに移動します。
削除するノードグループの [名前] をクリックします。
ノードグループ内のノードごとに、ノードの名前をクリックして、ノードの詳細ページで個々の VM インスタンスを削除するか、個々の VM を削除する標準的な手順を行います。マネージド インスタンス グループ内の VM を削除するには、マネージド インスタンス グループを削除します。
ノードグループのすべてのノードで実行されているすべての VM インスタンスを削除したら、[単一テナントノード] ページに戻ります。
[ノードグループ] をクリックします。
削除するノードグループの名前を選択します。
[削除] をクリックします。
gcloud compute sole-tenancy node-groups list-nodes
コマンドを使用して、ノードグループのノードで実行中の VM インスタンスを一覧表示します。gcloud compute sole-tenancy node-groups list-nodes GROUP_NAME \ --zone=ZONE
次のように置き換えます。
GROUP_NAME
: ノードグループの名前ZONE
: ノードグループのゾーン
ノードグループで実行されている VM がある場合は、個別の VM を削除する手順またはマネージド インスタンス グループを削除する手順を行います。
ノードグループのすべてのノードで実行されているすべての VM を削除したら、
gcloud compute sole-tenancy node-groups delete
コマンドを使用してノードグループを削除します。gcloud compute sole-tenancy node-groups delete GROUP_NAME \ --zone=ZONE
次のように置き換えます。
GROUP_NAME
: ノードグループの名前ZONE
: ノードグループのゾーン
nodeGroups.listNodes
メソッドを使用して、ノードグループ内のノードで実行中の VM インスタンスを一覧表示します。POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/GROUP_NAME/listNodes
次のように置き換えます。
PROJECT_ID
: プロジェクト IDZONE
: ノードグループのゾーンGROUP_NAME
: VM を一覧表示するグループ
ノードグループで実行されている VM がある場合は、個別の VM を削除する手順またはマネージド インスタンス グループを削除する手順を行います。
ノードグループのすべてのノードで実行されるすべての VM を削除したら、
nodeGroups.delete
メソッドを使用してノードグループを削除します。DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/GROUP_NAME
次のように置き換えます。
PROJECT_ID
: プロジェクト IDZONE
: ノードグループのゾーンGROUP_NAME
: 削除するノードグループの名前
Google Cloud コンソールで、[単一テナントノード] ページに移動します。
[ノード テンプレート] をクリックします。
未使用のノード テンプレートの名前を選択します。
[削除] をクリックします。
TEMPLATE_NAME: 削除するノード テンプレートの名前
REGION: ノード テンプレートのリージョン
PROJECT_ID: プロジェクト ID
REGION: ノード テンプレートを含む Google Cloud リージョン
TEMPLATE_NAME: 削除するノード テンプレートの名前
- 単一テナントノードの料金について詳しくは、単一テナントノードの料金をご覧ください。
単一テナントノード グループで自動スケーリングを有効にする方法については、ノードグループ オートスケーラーをご覧ください。
既存のライセンスを Google Cloud に移行する方法については、既存のライセンスの移行をご覧ください。
単一テナントノードの詳細については、単一テナントノードをご覧ください。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
詳細については、Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
単一テナントノード テンプレートを作成する
単一テナントノード テンプレートは、単一テナントノード グループのプロパティを指定するリージョン リソースです。ノードグループを作成する前に、ノード テンプレートを作成する必要があります。ただし、Google Cloud コンソールを使用している場合は、単一テナントノードの作成中にノード テンプレートを作成する必要があります。
Console
ノードグループを作成する前に、単一テナントノード テンプレートを作成する必要があります。Google Cloud コンソールを使用して、単一テナントノード グループの作成中にノード テンプレートを作成する必要があります。新しいノード テンプレートは、ノードグループのプロパティで指定したリージョンと同じリージョンに作成されます。
ノード テンプレートを表示するには、[単一テナントノード] ページで [ノード テンプレート] をクリックします。
gcloud
gcloud compute sole-tenancy node-templates create
コマンドを使用してノード テンプレートを作成します。gcloud compute sole-tenancy node-templates create TEMPLATE_NAME \ --node-type=NODE_TYPE \ [--region=REGION \] [--node-affinity-labels=AFFINITY_LABELS \] [--accelerator type=GPU_TYPE,count=GPU_COUNT \] [--disk type=local-ssd,count=DISK_COUNT,size=DISK_SIZE \] [--cpu-overcommit-type=CPU_OVERCOMMIT_TYPE]
次のように置き換えます。
REST
nodeTemplates.insert
メソッドを使用してノード テンプレートを作成します。POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/nodeTemplates { "name": "TEMPLATE_NAME", "nodeType": "NODE_TYPE", "nodeAffinityLabels": { "KEY": "VALUE", ... }, "accelerators": [ { "acceleratorType": "GPU_TYPE", "acceleratorCount": GPU_COUNT } ], "disks": [ { "diskType": "local-ssd", "diskSizeGb": DISK_SIZE, "diskCount": DISK_COUNT } ], "cpuOvercommitType": CPU_OVERCOMMIT_TYPE }
次のように置き換えます。
単一テナントノード グループを作成する
以前の手順で作成した単一テナントノードのテンプレートを使用して、単一テナントノードを作成します。単一テナントノード グループは、単一テナントノード テンプレートで指定されたプロパティを継承します。また、指定しなければならない追加の値があります。
コンソール
gcloud
gcloud compute sole-tenancy node-groups create
コマンドを実行して、以前の手順で作成したノード テンプレートに基づいてノードグループを作成します。gcloud compute sole-tenancy node-groups create GROUP_NAME \ --node-template=TEMPLATE_NAME \ --target-size=TARGET_SIZE \ [--zone=ZONE \] [--maintenance-policy=MAINTENANCE_POLICY \] [--maintenance-window-start-time=START_TIME \] [--autoscaler-mode=AUTOSCALER_MODE: \ --min-nodes=MIN_NODES \ --max-nodes=MAX_NODES]
次のように置き換えます。
REST
以前の手順で作成したノード テンプレートに基づいてノードグループを作成するには、
nodeGroups.insert
メソッドを使用します。POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups?initialNodeCount=TARGET_SIZE
{ "nodeTemplate": "regions/REGION/nodeTemplates/TEMPLATE_NAME", "name": "GROUP_NAME", "maintenancePolicy": MAINTENANCE_POLICY, "maintenanceWindow": { "startTime": "START_TIME" } "autoscalingPolicy": { "mode": AUTOSCALER_MODE, "minNodes": MIN_NODES, "maxNodes": MAX_NODES }, }次のように置き換えます。
単一テナント VM をプロビジョニングする
以前の手順で作成したノード テンプレートに基づいてノードグループを作成したら、単一テナントノード グループに個々の VM をプロビジョニングできます。
前の手順でノード テンプレートに割り当てたアフィニティ ラベルと一致するアフィニティ ラベルを使用する特定のノードまたはノードグループに VM をプロビジョニングするには、VM インスタンスを作成する標準的な手順に沿って、VM にアフィニティ ラベルを割り当てます。
または、次の手順を使用して、ノードグループの詳細ページから単一テナントノードに VM をプロビジョニングできます。VM をプロビジョニングするノードグループに基づき、Compute Engine によってアフィニティ ラベルが割り当てられます。
コンソール
gcloud
gcloud compute instances create
コマンドを使用して、単一テナントノード グループに VM をプロビジョニングします。gcloud compute instances create VM_NAME \ [--zone=ZONE \] --image-family=IMAGE_FAMILY \ --image-project=IMAGE_PROJECT \ --node-group=GROUP_NAME \ --machine-type=MACHINE_TYPE \ [--maintenance-policy=MAINTENANCE_POLICY \] [--accelerator type=GPU_TYPE,count=GPU_COUNT \] [--local-ssd interface=SSD_INTERFACE \] [--restart-on-failure]
--restart-on-failure
フラグは、単一テナント VM が停止後に再起動するかどうかを示します。このフラグは、デフォルトで有効になっています。無効にするには--no-restart-on-failure
を使用します。次のように置き換えます。
REST
instances.insert
メソッドを使用して、単一テナントノード グループに VM をプロビジョニングします。POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/VM_ZONE/instances
{ "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE", "name": "VM_NAME", "scheduling": { "onHostMaintenance": MAINTENANCE_POLICY, "automaticRestart": RESTART_ON_FAILURE, "nodeAffinities": [ { "key": "compute.googleapis.com/node-group-name", "operator": "IN", "values": [ "GROUP_NAME" ] } ] }, "networkInterfaces": [ { "network": "global/networks/NETWORK", "subnetwork": "regions/REGION/subnetworks/SUBNETWORK" } ], "guestAccelerators": [ { "acceleratorType": GPU_TYPE, "acceleratorCount": GPU_COUNT } ], "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY" } }, { "type":"SCRATCH", "initializeParams":{ "diskType":"zones/LOCAL_SSD_ZONE/diskTypes/local-ssd" }, "autoDelete":true, "interface":"SSD_INTERFACE" } ] }次のように置き換えます。
単一テナント VM のグループのプロビジョニング
マネージド インスタンス グループ(MIG)を使用すると、同一の単一テナント VM のグループをプロビジョニングできます。アフィニティ ラベルを使用すると、単一テナント VM のグループをプロビジョニングする単一テナントノードまたはノードグループを指定できます。
リージョン MIG の場合、各リージョン MIG のゾーンにノードグループを作成し、リージョン MIG のインスタンス テンプレートでノードグループのノード アフィニティを指定する必要があります。
gcloud
REST
ノード アフィニティ ラベルの構成
ノード アフィニティ ラベルを使用すると、ノードグループを論理的にグループ化し、特定のノードグループのセットに VM をスケジュールできます。ノード アフィニティ ラベルを使用して、異なるゾーンのノードグループに VM をスケジュールすることもできます。その場合でも、ノードグループの論理グループを維持できます。次の手順は、アフィニティ ラベルを使用して、本番環境のワークロードに使用される特定のノードグループに VM を関連付ける例を示しています。この例では、単一の VM をスケジュールする方法を示していますが、マネージド インスタンス グループを使用して VM のグループをスケジュールすることもできます。
gcloud
ノード アンチアフィニティ ラベルの構成
ノード アフィニティ ラベルをアンチアフィニティ ラベルとして構成すると、VM が特定のノードで実行されるのを防ぐことができます。たとえば、アンチアフィニティ ラベルを使用すると、開発目的で使用している VM が、本番環境の VM と同じノードでスケジュールされないようにすることが可能です。次の例は、アフィニティ ラベルを使用して、特定のノードグループで VM が実行されないようにする方法を示しています。この例では、単一の VM をスケジュールする方法を示していますが、マネージド インスタンス グループを使用して VM のグループをスケジュールすることもできます。
gcloud
ノードグループの削除
単一テナントノード グループを削除する必要がある場合は、まずノードグループからすべての VM を削除します。
Console
gcloud
REST
ノード テンプレートの削除
ノード テンプレートは、そのテンプレートを使用しているすべてのノードグループを削除した後に削除できます。
コンソール
gcloud
gcloud compute sole-tenancy node-templates delete
コマンドを使用して、未使用のノード テンプレートを削除します。gcloud compute sole-tenancy node-templates delete TEMPLATE_NAME \ --region=REGION
次のように置き換えます。
REST
compute.nodeTemplates.delete
メソッドを使用して、未使用のノード テンプレートを削除します。DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/nodeTemplates/TEMPLATE_NAME
次のように置き換えます。
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-12-05 UTC。
-