インスタンスグループをロードバランサに追加する

このページでは、既存のマネージドインスタンスグループ（MIG）をロードバランサのバックエンドサービスまたはターゲットプールに追加する方法について説明します。

ロードバランサはユーザートラフィックを分散し、アプリケーションでパフォーマンスの問題が発生するリスクを軽減します。Cloud Load Balancing では、マネージドインスタンスグループと非マネージドインスタンスグループの両方を使用してトラフィックが処理されます。使用しているロードバランサのタイプに応じて、ターゲットプールまたはバックエンドサービスにインスタンスグループを追加できます。

MIG バックエンドを使用して特定のタイプのロードバランサを作成する方法については、Cloud Load Balancing のドキュメントをご覧ください。

始める前に

まだ設定していない場合は、認証を設定します。認証とは、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.

マネージドインスタンスグループをバックエンドサービスに追加する

ロードバランサを作成するには、ほとんどの種類でバックエンドサービスが必要です。

バックエンドサービスには複数のバックエンドを含めることができます。インスタンスグループはバックエンドの一種です。インスタンスグループ内のインスタンスがロードバランサからのトラフィックに応答します。それにより、バックエンドサービスは使用できるインスタンス、処理可能なトラフィック数、現在処理しているトラフィック数を認識するようになります。また、バックエンドサービスはヘルスチェックをモニタリングし、異常なインスタンスにはトラフィックを送信しません。

マネージドインスタンスグループをバックエンドサービスに追加するには、以下の手順を実施します。

コンソール

Google Cloud コンソールの [ロードバランシング] ページに移動します。
[ロードバランシング] ページに移動
マネージドインスタンスグループを追加するバックエンドサービスの名前をクリックします。
[編集] をクリックします。
[+ バックエンドを追加] をクリックします。
追加するインスタンスグループを選択します。
変更するオプション設定があれば編集します。
変更を保存します。

gcloud

add-backend コマンドを実行します。

    gcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
        --instance-group=INSTANCE_GROUP \
        [--instance-group-region=INSTANCE_GROUP_REGION | --instance-group-zone=INSTANCE_GROUP_ZONE] \
        --balancing-mode=BALANCING_MODE

バランシングモードのサポートは、ロードバランサのタイプによって異なります。完全なリストについては、各ロードバランサで使用できるバランシングモードをご覧ください。

マネージドインスタンスグループの負荷分散モードに応じて、パラメータを追加する必要があります。詳細については、SDK の add-backend コマンドをご覧ください。

REST

REST API を使用してバックエンドサービスを追加するには、backendServices をご覧ください。

制限事項

リージョン MIG でのロードバランシングは、RATE と UTILIZATION のバランス調整モードで max-rate ターゲット容量をサポートしていません。各ロードバランサの使用ガイドラインの詳細については、ロードバランシングモードとターゲット容量の設定をご覧ください。

マネージドインスタンスグループをターゲットプールに追加する

ターゲットプールは、1 つ以上の仮想マシンインスタンスが含まれるオブジェクトです。ターゲットプールは外部パススルーネットワークロードバランサで使用され、ロードバランサによって接続されているターゲットプールにユーザーリクエストが転送されます。このターゲットプールに含まれるインスタンスによってこれらのリクエストが処理され、レスポンスが返されます。インスタンスグループに対してインスタンスが追加または削除されると、その変更に合わせてターゲットプールが自動的に更新されるように、マネージドインスタンスグループをターゲットプールに追加できます。

マネージドインスタンスグループをターゲットプールに追加する前に、ターゲットプールを用意しておく必要があります。詳細については、ターゲットプールの追加に関するドキュメントをご覧ください。

既存のマネージドインスタンスグループをターゲットプールに追加する手順は次のとおりです。この操作を行うと、マネージドインスタンスグループに含まれるすべての VM インスタンスがターゲットプールに追加されます。

コンソール

Google Cloud コンソールの [ターゲットプール] ページに移動します。
[ターゲットプール] ページに移動
インスタンスグループを追加するターゲットプールをクリックします。
[編集] ボタンをクリックします。
[VM インスタンス] セクションまで下にスクロールして、[インスタンスグループを選択] をクリックします。
プルダウンメニューからインスタンスグループを選択します。
変更を保存します。

gcloud

set-target-pools コマンドを実行します。

gcloud compute instance-groups managed set-target-pools INSTANCE_GROUP \
        --target-pools TARGET_POOL,..

ここで

INSTANCE_GROUP はインスタンスグループの名前です。
TARGET_POOL,.. は、このインスタンスグループの追加先である 1 つ以上のターゲットプールの名前です。

REST

リージョン MIG またはゾーン MIG の setTargetPools メソッドを呼び出します。次に例を示します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP/setTargetPools

ここで

PROJECT_ID はこのリクエストのプロジェクト ID です。
REGION はインスタンスグループのリージョンです。
INSTANCE_GROUP はインスタンスグループの名前です。

リクエストの本文には、このグループを追加するターゲットプールの URI のリストを含める必要があります。次に例を示します。

{
  "targetPools": [
    "regions/us-central1/targetPools/example-targetpool-1",
    "regions/us-central1/targetPools/example-targetpool-2"
  ]
}

マネージドインスタンスグループへの名前付きポートの割り当て

名前付きポートとは、ポートの名前と番号を表す 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

名前付きポートを作成する

このタスクに必要な権限

このタスクを行うには、次の権限が必要です。

インスタンスグループの compute.instanceGroups.update

コンソール

Google Cloud コンソールで、[インスタンスグループ] ページに移動します。
[インスタンスグループ] に移動
名前付きポートを指定するインスタンスグループの名前をクリックします。インスタンスグループのプロパティが記載されたページが表示されます。
[編集] をクリックして、このマネージドインスタンスグループを変更します。
[ポートマッピング] セクションで、[ポートを追加] をクリックし、目的のポート名と、その名前に関連付けるポート番号を入力します。さらにエントリが必要な場合は、[ポートを追加] を再度クリックします。
[保存] をクリックして、変更を保存し、マネージドインスタンスグループ内のインスタンスに名前付きポートを適用します。

gcloud

マネージドインスタンスグループの場合は、instance-groups managed set-named-ports コマンドを使用して 1 つ以上の名前付きポートを設定します。非マネージドグループの場合は、instance-groups set-named-ports コマンドを使用します。

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

次に例を示します。

gcloud compute instance-groups managed 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 managed set-named-ports INSTANCE_GROUP \
      --named-ports name1:10,name1:20,name1:80,\
                    name2:8080,name3:8080,\
                    name4:9000

get-named-ports コマンドを使用して、マネージドインスタンスグループに対する名前付きポートの割り当てを確認します。

gcloud compute instance-groups managed get-named-ports INSTANCE_GROUP

NAME  PORT
name1 10
name1 20
name1 80
name2 8080
name3 8080
name4 9000

REST

instanceGroupManagers API は、setNamedPorts API メソッドを提供していません。このタスクを実行するには、代わりに instanceGroups API を使用してください。

instanceGroups API へのリクエストを作成し、インスタンスグループの名前を含めます。特定のグループに関する情報を取得して、その情報からグループの現在の fingerprint 値を取得します。リクエスト本文に fingerprint と 1 つ以上の namedPorts 値のペアを含めます。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroups/INSTANCE_GROUP/setNamedPorts

{
  "fingerprint": "42WmSpB8rSM=",
  "namedPorts": [
    {
       "name": "PORT_NAME",
       "port": PORT_NUMBER
    },
    {
       "name": "PORT_NAME",
       "port": PORT_NUMBER
    }
  ]
 }

たとえば、ポート 10、20、80 が同じアプリケーション用の場合、これらのポートすべてに name1 を割り当てることができます。さらに、ポート 8080 に name2 と name3 の 2 つの名前を割り当てることもできます。また、次の例のように、ポート 9000 を name4 に割り当てることもできます。

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-group/setNamedPorts

{
   "fingerprint": "42WmSpB8rSM=",
   "namedPorts": [
      {
       "name": "name1",
       "port": 8080
      },
      {
       "name": "name2",
       "port": 9000
      }
   ]
}

各サービス名に複数のポートを割り当てるには、そのサービス名の複数の項目を作成します。たとえば、ポート 10、20、80 を name1 に割り当てることができます。さらに、ポート 8080 を name2 に割り当てます。

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-group/setNamedPorts

{
   "fingerprint": "42WmSpB8rSM=",
   "namedPorts": [
      {
       "name": "name1",
       "port": 10
      },
      {
       "name": "name1",
       "port": 20
      }
      {
       "name": "name1",
       "port": 80
      }
      {
       "name": "name2",
       "port": 8080
      }
      {
       "name": "name3",
       "port": 80
      }
      {
       "name": "name4",
       "port": 8080
      }
   ]
}

マネージドインスタンスグループにすでに割り当てられている名前付きポートのリストを表示するには、そのグループを指す GET リクエストを作成します。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP

次のステップ

可用性の高いアプリでのロードバランシングの使用のチュートリアルを試す。
マネージドインスタンスグループに使用できるインスタンステンプレートの作成。
リージョンマネージドインスタンスグループを作成する。
マネージドインスタンスグループの自動修復の有効化。
マネージドインスタンスグループの自動スケーリングを有効にする。

インスタンス グループをロードバランサに追加する

始める前に

Console

gcloud

REST

マネージド インスタンス グループをバックエンド サービスに追加する

コンソール

gcloud

REST

制限事項

マネージド インスタンス グループをターゲット プールに追加する

コンソール

gcloud

REST

マネージド インスタンス グループへの名前付きポートの割り当て

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

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

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

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

名前付きポートを作成する

このタスクに必要な権限

コンソール

gcloud

REST

次のステップ

インスタンスグループをロードバランサに追加する

マネージドインスタンスグループをバックエンドサービスに追加する

マネージドインスタンスグループをターゲットプールに追加する

マネージドインスタンスグループへの名前付きポートの割り当て

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

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