非マネージド VM をグループ化する

非マネージドインスタンスグループは、単一のプロジェクト、ゾーン、VPC ネットワーク、サブネットに存在する仮想マシン（VM）インスタンスの集まりです。非マネージドインスタンスグループは、個々の構成やチューニングが必要な VM をグループ化する場合に便利です。ロードバランサのバックエンドサービスで非マネージドインスタンスグループを使用できます。

一貫した構成設定が必要な VM の場合は、インスタンステンプレートに基づくマネージドインスタンスグループ（MIG）を使用します。可能であれば、非マネージドインスタンスグループの代わりにマネージドインスタンスグループの使用を検討してください。マネージドインスタンスグループの作成については、MIG の作成をご覧ください。

どちらのタイプのインスタンスグループもバックエンドとして Google Cloud ロードバランサに追加できます。詳細は、Cloud Load Balancing の概要を参照してください。Cloud Load Balancing がサポートするインスタンスグループあたりの 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
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

非マネージドインスタンスグループの操作

グループの作成

マネージドインスタンスグループとは異なり、非マネージドインスタンスグループは共通のインスタンステンプレートを共有しない固有の VM から構成されています。グループを作成した後、それぞれの VM をそのグループに追加するだけです。

コンソール

Google Cloud コンソールで、[インスタンスグループ] ページに移動します。
[インスタンスグループ] ページに移動
[インスタンスグループを作成] をクリックします。
[新しい非マネージドインスタンスグループ] をクリックします。
非マネージドインスタンスグループの名前を入力します。
[ロケーション] でリージョンとゾーンを選択します。
[ネットワーク] と [サブネットワーク] を選択します。
[VM インスタンス] で、このグループに追加する VM を選択します。
[作成] をクリックします。

gcloud

新しい非マネージドインスタンスグループを作成するには、instance-group unmanaged create コマンドを使用します。

gcloud compute instance-groups unmanaged create instance-group-name \
    --zone=zone

次のように置き換えます。

instance-group-name: 作成するグループの名前。
zone: グループを作成するゾーン。

REST

REST で非マネージドインスタンスグループを作成するには、instanceGroups.insert メソッドを使用して POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroups

{
   "name": "instance-group-name"
}

次のように置き換えます。

instance-group-name: 作成するグループの名前。
zone: グループを作成するゾーン。
project-id: グループを含むプロジェクトのプロジェクト ID。

Google Cloud CLI または REST を使用して新しい非マネージドインスタンスグループを作成した場合、VM は自動的に追加されません。非マネージドインスタンスグループへの VM の追加は、手動で行います。

グループの一覧表示と説明

既存の非マネージドインスタンスグループのリストを取得します。

コンソール

Google Cloud コンソールでは、[インスタンスグループ] ページに、既存の非マネージドインスタンスグループとマネージドインスタンスグループが一覧表示されます。

[インスタンスグループ] ページに移動

gcloud

Google Cloud CLI を使用してプロジェクト内のすべての非マネージドインスタンスグループを一覧表示するには、instance-groups 非マネージドリストを使用します。

gcloud compute instance-groups unmanaged list

特定の非マネージドインスタンスグループに関する情報を表示するには、instance-groups unmanaged describe コマンドを使用します。

gcloud compute instance-groups unmanaged describe instance-group-name \
   --zone=zone

次のように置き換えます。

instance-group-name: 記述するグループの名前。
zone: グループのゾーン。

REST

REST でインスタンスグループのリストを取得するには、instanceGroups.list メソッドを使用して GET リクエストを送信します。

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroups

API を使用して特定の非マネージドインスタンスグループに関する情報を取得するには、GET リクエストを instanceGroups.get メソッドを使用して送信します。

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroups/instance-group-name

次のように置き換えます。

instance-group-name: 記述するグループの名前。
zone: グループのゾーン。
project-id: グループを含むプロジェクトのプロジェクト ID。

グループの削除

マネージドインスタンスグループとは異なり、非マネージドインスタンスグループを削除してもそのグループ内の VM は削除されません。非マネージドインスタンスグループを削除すると、VM の論理グループのみが削除されます。

グループが Google Cloud ロードバランサのバックエンドである場合、インスタンスグループは削除できません。まずバックエンドサービスからバックエンドを削除する必要があります。

コンソール

Google Cloud コンソールで、[インスタンスグループ] ページに移動します。
[インスタンスグループ] ページに移動
リストから 1 つ以上の非マネージドインスタンスグループを選択します。
[削除] をクリックしてグループを削除します。グループは削除されますが、グループ内の VM は削除されません。

gcloud

非マネージドインスタンスグループを削除するには、instance-group unmanaged delete コマンドを使用します。

gcloud compute instance-groups unmanaged delete instance-group-name \
    --zone=zone

次のように置き換えます。

instance-group-name: 削除するグループの名前。
zone: グループのゾーン。

REST

非マネージドインスタンスグループを REST で削除するには、instanceGroups.delete メソッドを使用して DELETE リクエストを送信します。

DELETE https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroups/instance-group-name

次のように置き換えます。

instance-group-name: 削除するグループの名前。
zone: グループのゾーン。
project-id: グループを含むプロジェクトのプロジェクト ID。

グループメンバー

VM の追加

非マネージドインスタンスグループを作成したら、グループに VM を追加できます。ただし、各 VM の最初の（または唯一の）ネットワークインターフェース（nic0）が同じ VPC ネットワークに接続されている場合のみ、VM をグループ化できます。非マネージドインスタンスグループに追加できる VM の最大数は 2,000 台です。グループに 2,000 台を超える VM を追加する場合は、サポートにお問い合わせください。

コンソール

Google Cloud コンソールで、[インスタンスグループ] ページに移動します。
[インスタンスグループ] ページに移動
リストの [名前] 列で、VM を追加するインスタンスグループの名前をクリックします。ページが開き、インスタンスグループのプロパティとすでにグループに含まれている VM のリストが表示されます。
この非マネージドインスタンスグループを変更するには、[編集] をクリックします。
[VM インスタンス] から、グループに追加する既存の VM を 1 つ以上選択します。既存の VM と同じゾーン、VPC ネットワーク、サブネット内の VM のみを選択できます。
新しい VM をグループに追加するには、[保存] をクリックします。

gcloud

インスタンスを非マネージドインスタンスグループに追加するには、instance-group unmanaged add-instances コマンドを使用します。

gcloud compute instance-groups unmanaged add-instances instance-group-name \
    --zone=zone \
    --instances=list-of-VM-names

次のように置き換えます。

instance-group-name: VM を追加するグループの名前。
zone: グループのゾーン。
list-of-VM-names: 同じゾーン、VPC ネットワーク、サブネット内の VM のカンマ区切りリスト。

REST

非マネージドインスタンスグループに VM を追加するには、instanceGroups.addInstances メソッドを使用して POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroups/instance-group-name/addInstances

   {
      "instances": [
         {
         "instance": "https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-1-name",
         "instance": "https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-2-name",
         ....
         }
      ]
   }

次のように置き換えます。

instance-group-name: VM を追加するグループの名前。
zone: グループのゾーン。
project-id: グループを含むプロジェクトのプロジェクト ID。
instance-1-name と instance-2-name: グループに追加する、同じゾーン、VPC ネットワーク、サブネット内の VM の名前。

VM のリスト

非マネージドインスタンスグループ内のメンバー VM のリストを取得できます。

コンソール

Google Cloud コンソールで、[インスタンスグループ] ページに移動します。
[インスタンスグループ] ページに移動
リストの [名前] 列で、表示する非マネージドインスタンスグループの名前をクリックします。グループに含まれるインスタンスのリストが記載されたページが表示されます。

gcloud

非マネージドインスタンスグループの VM を一覧表示するには、instance-group unmanaged list-instances コマンドを使用します。

gcloud compute instance-groups unmanaged list-instances instance-group-name \
   --zone=zone

次のように置き換えます。

instance-group-name: リストするメンバーのグループの名前。
zone: グループのゾーン。

REST

非マネージドインスタンスグループの VM のリストを取得するには、instanceGroups.listInstances メソッドを使用して POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroups/instance-group-name/listInstances

次のように置き換えます。

instance-group-name: リストするメンバーのグループの名前。
zone: グループのゾーン。
project-id: グループを含むプロジェクトのプロジェクト ID。

VM の削除

非マネージドインスタンスグループから VM を削除できます。インスタンスグループから VM を削除しても VM 自体は削除されません。

コンソール

Google Cloud コンソールで、[インスタンスグループ] ページに移動します。
[インスタンスグループ] ページに移動
リストの [名前] 列で、VM を削除するインスタンスグループの名前をクリックします。ページが開き、インスタンスグループプロパティと、グループに含まれる VM のリストが表示されます。
リストで、グループから削除する 1 つ以上の VM を選択します。
[グループから削除] をクリックします。非マネージドインスタンスグループから削除した VM は、停止または削除しない限り、引き続き存在し、実行されます。

gcloud

VM を非マネージドインスタンスグループから削除するには、instance-group unmanaged remove-instances コマンドを使用します。

gcloud compute instance-groups unmanaged remove-instances instance-group-name \
    --zone=zone \
    --instances=list-of-VM-names

次のように置き換えます。

instance-group-name: 削除するインスタンスを含むグループの名前。
zone: グループのゾーン。
list-of-VM-names: グループから削除する VM のカンマ区切りリスト。

REST

非マネージドインスタンスグループから VM を削除するには、instanceGroups.removeInstances メソッドを使用して POST リクエストを送信します。次のように、複数の VM を同時に削除できます。

POST https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroups/instance-group-name/removeInstances
{
    "instances": [
        {
        "instance": "https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-1-name",
        "instance": "https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-2-name",
        ....
        }
    ]
}

次のように置き換えます。

instance-group-name: 削除するインスタンスを含むグループの名前。
zone: グループのゾーン。
project-id: グループを含むプロジェクトのプロジェクト ID。
instance-1-name と instance-2-name: グループとの関連付けを解除する VM の名前。

名前付きポートの操作

名前付きポートとは、ポートの名前と番号を表す Key-Value ペアです。ポート名は、サービスまたはアプリケーションの名前を表します。ポート番号は、サービスまたはアプリケーションが動作しているポートを表します。

名前付きポートは、Cloud Load Balancing で使用されます。プロキシとして機能するロードバランサは、そのバックエンドサービスの構成内で、単一の名前付きポートに登録されます。ポート名は、各インスタンスグループのバックエンドの名前付きポートマッピングに基づいて、ポート番号に変換されます。

たとえば、バックエンドサービスは、http-port という名前のポートに登録できます。バックエンドインスタンスのグループには、http-port:80 という名前のポートを含めることができます。バックエンドインスタンスのグループは、TCP などのプロトコルを使用して、ポート 80 上のグループ内の VM にトラフィックを送信するようにロードバランサに指示します。プロトコルは、ロードバランサのバックエンドサービスで定義されます。

名前付きポートは、プロキシロードバランサで使用されるシンプルなメタデータです。名前付きポートは Compute Engine のネットワークまたはファイアウォールのリソースを制御しません。

複数のポート番号を持つ名前付きポート

各サービス名に複数のポートを割り当てることができます。また、ポートごとに複数のサービス名を割り当てることもできます。

次の点に注意してください。

トラフィックは、同じポート名を持つポート間で分散されます。
特定のバックエンドサービスは、一度に 1 つの名前付きポートにのみトラフィックを転送できます。
名前付きポートに複数のポート番号を使用する場合は、それらがすべて同じアプリケーション用のポートである必要があります。

たとえば、ポート 80 は通常 TLS をサポートしていないため、http:80,http:8080 は機能しますが http:80,http:443 は機能しません。

インスタンスグループに複数の名前付きポートを割り当てられます。名前付きポート http-port に登録され、2 つのバックエンドインスタンスのグループを持つ、バックエンドサービスの例を見てみましょう。

名前付きポート http-port:80 を持つ instance-group-a
名前付きポート http-port:79 を持つ instance-group-b

このバックエンドサービスは、instance-group-a の VM にはポート 80 に、instance-group-b の VM にはポート 79 にトラフィックを送信します。

同じインスタンスグループを複数のバックエンドサービス（複数のロードバランサの場合）に追加し、インスタンスグループが各ロードバランサの異なるポートにサービスを提供する場合、すべてのポート番号を単一の名前付きポートに追加しないでください。代わりに、一意の名前付きポートを作成し、それを各バックエンドサービスが提供する必要のあるポートのセットにマップします。

たとえば、3 つのアプリケーションがあり、それぞれに独自のロードバランサがあるとします。各アプリケーションには固有のポート番号があります（app1 は 81、app2 は 82、app3 は 83）。3 つのバックエンドサービスがすべて共通のインスタンスグループを使用している場合、このインスタンスグループの名前付きポートを [app1:81, app2:82, app3:83] として割り当てます。

名前付きポートとヘルスチェック

バックエンドサービスで複数のポート番号を持つ名前付きポートを外部アプリケーションロードバランサまたは内部アプリケーションロードバランサで機能させるには、ヘルスチェックに特定のポート番号ではなく --use-serving-port フラグを設定する必要があります。このオプションは Google Cloud コンソールでは使用できません。--use-serving-port を設定するには、Google Cloud CLI または API を使用する必要があります。

たとえば、あるバックエンドサービスのトラフィックを 3 つのポート（81、82、83）でロードバランシングするアプリケーションで、単一のインスタンスグループを使用するとします。このインスタンスグループのポートは [app:81, 82, 83] として割り当てることができます。このシナリオのヘルスチェックには --use-serving-port フラグが必要です。

詳細については、負荷分散のヘルスチェックのドキュメントをご覧ください。

名前付きポートとファイアウォールルール

名前付きポートが Google Cloud のファイアウォールルールの作成や変更を行うことはありません。バックエンド VM へのトラフィックを許可するには、必要なファイアウォールルールを作成する必要があります。

名前付きポートとバックエンドサービス

インスタンスグループの構成に加えて、バックエンドサービスも構成する必要があります。たとえば、インスタンスグループに my-service-name という名前の名前付きポートとポート 8888 を設定したとします。

gcloud compute instance-groups set-named-ports my-unmanaged-ig \
    --named-ports=my-service-name:8888

この場合、バックエンドサービスの --port-name を my-service-name に設定して、バックエンドサービス構成の名前付きポートを参照する必要があります。

gcloud compute backend-services update my-backend-service \
    --port-name=my-service-name

名前付きポートの作成

コンソール

Google Cloud コンソールで、[インスタンスグループ] ページに移動します。
[インスタンスグループ] に移動
リストの [名前] 列で、名前付きポートを指定するインスタンスグループの名前をクリックします。インスタンスグループのプロパティが記載されたページが表示されます。
この非マネージドインスタンスグループを変更するには、[編集] をクリックします。
[ポートマッピング] セクションで、[ポートを追加] をクリックし、ポート名と番号を入力します。必要に応じて、他の名前付きポートを追加または削除します。
[保存] をクリックして、非マネージドインスタンスグループの名前付きポートのリストを更新します。

gcloud

非マネージドインスタンスグループに名前付きポートを追加するには、instance-groups unmanaged set-named-ports コマンドを使用します。

gcloud compute instance-groups unmanaged set-named-ports instance-group-name \
    --zone=zone \
    --named-ports=port-name:port-number,...

非マネージドインスタンスグループの名前付きポートを一覧表示するには、instance-groups unmanaged get-named-ports コマンドを使用します。

set-named-ports コマンドを使用して、1 つ以上の名前付きポートを設定します。

gcloud compute instance-groups unmanaged set-named-ports INSTANCE_GROUP \
      --named-ports PORT_NAME:PORT,PORT_NAME:PORT

例:

gcloud compute instance-groups unmanaged set-named-ports INSTANCE_GROUP \
      --named-ports name1:80,name2:8080

各サービス名に複数のポートを割り当てる、または各サービスに複数の名前を割り当てるには、各名前またはポートに 1 つ以上の項目を作成します。たとえば、ポート 10、20、80 が同じアプリケーション用の場合、これらのポートすべてに name1 を割り当てることができます。さらに、ポート 8080 に name2 と name3 の 2 つの名前を割り当てることもできます。また、次の例のように、ポート 9000 を name4 に割り当てることもできます。

gcloud compute instance-groups unmanaged set-named-ports INSTANCE_GROUP \
      --named-ports name1:10,name1:20,name1:80,\
                    name2:8080,name3:8080,\
                    name4:9000

Google Cloud CLI を使用して非マネージドインスタンスグループからすべての名前付きポートを削除するには、名前付きポートのリストを空にして instance-group 非マネージド set-named-ports を使用します。

gcloud compute instance-groups unmanaged set-named-ports instance-group-name \
    --zone=zone \
    --named-ports=""

上記のすべての例で、次を置換します（存在する場合）。

instance-group-name: インスタンスグループの名前。
zone: グループのゾーン。
port-name と port-number: ポート名とポート番号は、選択した名前からポート番号へのマッピングを表します。複数のマッピングはカンマで区切って指定できます。たとえば、port-one:80,port-two:8080 は名前付きポートの有効なリストです。

REST

インスタンスグループを記述して fingerprint をメモします。
名前付きポートを追加するには、instanceGroups.setNamedPorts メソッドを使用して POST リクエストを送信します。すべての名前付きポートを削除する場合は、namedPorts を空のリストに設定します。
```
POST https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroups/instance-group-name/setNamedPorts

{
    "fingerprint": "fingerprint",
    "namedPorts": [
        {
        "name": "port-name",
        "port": port-number
        },
        {
        "name": "port-name",
        "port": port-number
        },
        ....
    ]
}
```
次のように置き換えます。
- instance-group-name: インスタンスグループの名前。
- zone: グループのゾーン。
- project-id: グループを含むプロジェクトのプロジェクト ID。
- port-name と port-number: ポート名とポート番号は、選択した名前からポート番号へのマッピングを表します。
- fingerprint: 前の手順でメモしたフィンガープリントです。

次のステップ

単一ゾーンの VM を含むマネージドインスタンスグループを作成する。
リージョン内の複数のゾーンに VM を持つマネージドインスタンスグループを作成する。
Cloud Load Balancing の詳細を学習する。

非マネージド VM をグループ化する

始める前に

Console

gcloud

REST

非マネージド インスタンス グループの操作

グループの作成

コンソール

gcloud

REST

グループの一覧表示と説明

コンソール

gcloud

REST

グループの削除

コンソール

gcloud

REST

グループ メンバー

VM の追加

コンソール

gcloud

REST

VM のリスト

コンソール

gcloud

REST

VM の削除

コンソール

gcloud

REST

名前付きポートの操作

複数のポート番号を持つ名前付きポート

名前付きポートとヘルスチェック

名前付きポートとファイアウォール ルール

名前付きポートとバックエンド サービス

名前付きポートの作成

コンソール

gcloud

REST

次のステップ

非マネージドインスタンスグループの操作

グループメンバー

名前付きポートとファイアウォールルール

名前付きポートとバックエンドサービス