ターゲットプールの使用

ターゲットプールは、外部パススルーネットワークロードバランサからトラフィックを受信するバックエンドインスタンスのグループです。ターゲットプールのすべてのバックエンドインスタンスは、同じ Google Cloud リージョンに存在する必要があります。外部パススルーネットワークロードバランサは、バックエンドサービスまたはターゲットプールのいずれかを使用してバックエンドインスタンスのグループを定義します。新しい外部パススルーネットワークロードバランサを作成する場合は、バックエンドサービスを使用することをおすすめします。

このページでは、ターゲットプールのバックエンドの構成オプションについて説明します。外部パススルーネットワークロードバランサの転送ルールがトラフィックをターゲットプールに送信すると、ロードバランサは送信元 IP アドレス、送信元ポート、宛先 IP アドレス、宛先ポートのハッシュに基づいてターゲットプールからインスタンスを選択します。

ターゲットプールに単一の仮想マシン（VM）を含める場合は、ロードバランシングではなくプロトコル転送機能の使用を検討してください。

ターゲットプールのプロパティ

ターゲットプールは、TCP と UDP のトラフィックを処理する転送ルールと連携します。ターゲットプールを転送ルールと組み合わせて使用するには、その前にターゲットプールを新たに作成する必要があります。

ターゲットプールではレガシー HTTP ヘルスチェックを使用します。

ターゲットプールは次のプロパティで構成されます。

name

このターゲットプールの名前。名前はこのプロジェクト内で一意であり、63 文字以内の長さで、[a-z]([-a-z0-9]*[a-z0-9])? という正規表現を使用する必要があります。つまり、先頭文字には小文字、その後続文字にはダッシュ、小文字、数字のいずれかを使用する必要があります。ただし最後の文字にはダッシュを使用できません。

description

省略可。このターゲットプールに関するユーザー定義の説明。

region

ターゲットプールのリージョンの完全修飾 URL。リージョンは、バックエンドインスタンスが存在するリージョンと同じにする必要があります。例:

"region" : "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION"

healthChecks[ ]

省略可。このターゲットプールに使用するヘルスチェックのリスト。設定しなくてもかまいません。特定のターゲットプールに設定できるヘルスチェックは 1 つだけです。詳しくは、ヘルスチェックをご覧ください。

instances[ ]

このターゲットプールのトラフィックを処理するインスタンス URL のリスト。すべてのインスタンスは、ターゲットプールと同じリージョンに存在している必要がありますが、インスタンスは単一のリージョン内の異なるゾーンに属することができます。例:

"instances" : [
  "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE",
  "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE-2"
]

sessionAffinity

省略可。バックエンドの仮想マシンインスタンスを選択するために使用する方法を制御します。この値は、ターゲットプールの作成時にのみ設定できます。設定した値は変更できません。ハッシュ方式では、以下の 5 つの値のサブセットに基づいてバックエンドを選択します。

送信元 IP / 宛先 IP
送信元ポート / 宛先ポート
レイヤ 4 プロトコル（TCP、UDP）

設定可能なハッシュは以下のとおりです。

NONE （ハッシュ値が指定されていない）（デフォルト）: 送信元 IP、宛先 IP、送信元ポート、宛先ポート、プロトコルを使用する 5 タプルハッシュ。新しい接続はそれぞれどのインスタンスになってもかまいませんが、所定の接続のすべてのトラフィックは、インスタンスが正常に保たれている場合は同じインスタンスに留まります。
CLIENT_IP_PROTO: 送信元 IP、宛先 IP、プロトコルを使用する 3 タプルハッシュ。クライアントからのすべての接続は、同じプロトコルを使用してインスタンスが正常に保たれている限り、同じインスタンスになります。
CLIENT_IP: 送信元 IP と宛先 IP を使用する 2 タプルハッシュ。クライアントからのすべての接続は、インスタンスが正常に保たれている限り、いずれのプロトコルでも同じインスタンスになります。

5 タプルハッシュにより、多くの仮想マシンにまたがる優れたトラフィックの分散が実現します。ただし、同じクライアントからの 2 番目のセッションは、送信元ポートが変わる可能性があるため、別のインスタンスに到達することがあります。同じクライアントのすべてのセッションが同じバックエンドに到達できるようにするには、バックエンドの正常性が保たれている限り CLIENT_IP_PROTO オプションまたは CLIENT_IP オプションを指定できます。

一般に、3 タプル方式または 2 タプル方式を選択した場合、デフォルトの 5 タプル方式よりも優れたセッションアフィニティが実現しますが、トラフィック全体は均等に分散されない可能性があります。

断片化された UDP パケット: 断片化の可能性がある UDP トラフィックを負荷分散する場合は、セッションアフィニティを CLIENT_IP_PROTO または CLIENT_IP に設定します。NONE（5 タプルハッシュ）は使用しないでください。最初のフラグメントを除き、UDP フラグメントにはポート番号が含まれません。このため、ロードバランサがポートのないフラグメントをドロップする可能性があります。詳しくは、ロードバランシングと断片化された UDP パケットをご覧ください。

注意: クライアントの大部分がプロキシサーバーの背後にある場合は、CLIENT_IP_PROTO または CLIENT_IP を使用しないでください。使用すると、これらのクライアントからのトラフィックはすべて同じインスタンスに送信されます。

backupPool

省略可。別のターゲットプールリソースの完全修飾 URL。バックアッププールは、別のターゲットプールが参照するターゲットプールです。この機能を使用するには、failoverRatio も定義する必要があります。ターゲットプール内の正常な仮想マシンの比率が failoverRatio を下回った場合、外部パススルーネットワークロードバランサはトラフィックをバックアッププールに送信します。ターゲットプールごとに提供できるバックアッププールは 1 つだけです。バックアッププールは、ターゲットプールと同じリージョンに存在する必要があります。ターゲットプール内の正常なインスタンスの比率がフェイルオーバーの比率を下回った場合は、トラフィックをルーティングするため、外部パススルーネットワークロードバランサは以下のルールを使用します。

ターゲットプールの合計インスタンス数に対する正常なインスタンス数の比率がフェイルオーバー率よりも小さい場合、トラフィックはバックアッププールの正常なインスタンスに送信されます。
ターゲットプールの合計インスタンス数に対する正常なインスタンス数の比率がフェイルオーバー率よりも小さいが、バックアッププールに正常なインスタンスが残っていない場合、トラフィックはターゲットプールに残っている正常なインスタンスに送信されます。
ターゲットプールが空ではなく、ターゲットプールとバックアッププールの両方のヘルスチェックに失敗した場合、トラフィックは最後の手段としてターゲットプールのすべてのインスタンスに送信されます。
ターゲットプールが空で、バックアッププールのすべてのインスタンスでヘルスチェックに失敗すると、最後の手段として、トラフィックはバックアッププールのすべてのインスタンスに送信されます。

サポートの対象となるフェイルオーバーのレベルは 1 つだけです。たとえば、ターゲットプール A にバックアッププール B があり、バックアッププール B にバックアッププール C がある場合、ターゲットプール A へのトラフィックは、バックアッププール B にのみ送信できます。バックアッププール C には送信できません。

failoverRatio

省略可。このターゲットプールが正常でないとされる基準となる浮動小数点数を 0.0～1.0 の範囲で指定します。たとえば、この値が 0.1 に設定されていると、正常なインスタンス数が 0.1（10%）未満の場合、このターゲットプールは正常ではないとされます。フェイルオーバー比が 0.0 の場合、正常であるとみなされるには、少なくとも 1 つのバックエンドが正常である必要があります。フェイルオーバー比が 1.0 に設定されている場合、正常と見なされるには、すべてのインスタンスが正常である必要があります。backupPool フィールドを定義する場合は、このプロパティを定義する必要があります。

フェイルオーバーの条件

条件	新しい接続先
フェイルオーバー率 !=0、ターゲットプールの正常な VM >= FR	ターゲットプール
フェイルオーバー率 =0、ターゲットプールの正常な VM >0	ターゲットプール
フェイルオーバー率 !=0、ターゲットプールの正常な VM <FR、バックアッププールの少なくとも 1 つの VM が正常	バックアッププール
フェイルオーバー率 =0、ターゲットプールの正常な VM =0、バックアッププールの少なくとも 1 つの VM が正常	バックアッププール
ターゲットプールに 1 つ以上の VM がある、ターゲットプールのすべての VM が正常ではない、バックアッププールのすべての VM が正常ではない	ターゲットプール（最後の手段）
ターゲットプールに VM はなく、バックアッププールのすべての VM が正常ではない	バックアッププール（最後の手段）
ターゲットプールに VM がなく、バックアッププールに VM がない	トラフィックのドロップ

ターゲットプールの作成

コンソール

Google Cloud コンソールではターゲットプールを作成できません。ターゲットプールを作成するには、Google Cloud CLI または API を使用します。

Google Cloud CLI を使用してターゲットプールベースの外部パススルーネットワークロードバランサを作成する方法については、ターゲットプールを使用して外部パススルーネットワークロードバランサを設定するをご覧ください。

gcloud

gcloud compute を使用してターゲットプールを作成するには、target-pools create コマンドを使用します。

  gcloud compute target-pools create TARGET_POOL \
      [--backup-pool=BACKUP_POOL] \
      [--description=DESCRIPTION] \
      [--failover-ratio=FAILOVER_RATIO] \
      [--http-health-check=HEALTH_CHECK] \
      [--region=REGION]
      [--session-affinity=SESSION_AFFINITY; default="NONE"]

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

TARGET_POOL: ターゲットプールの名前
BACKUP_POOL: バックアップターゲットプールの名前
DESCRIPTION: ターゲットプールの説明
FAILOVER_RATIO: ターゲットプールが正常ではないと宣言されるタイミング（0.0～1.0 の値）
HEALTH_CHECK: このターゲットプールのヘルスチェック
REGION: ターゲットプールのリージョン
SESSION_AFFINITY: バックエンド仮想マシンインスタンスの選択に使用されるメソッド

API

API を使用してターゲットプールを作成するには、次の URI に HTTP POST リクエストを送信します。

  https://www.googleapis.com/v1/compute/projects/PROJECT_ID/regions/REGION/targetPools
  {
    "name": name,
    "instances": [
       "https://www.googleapis.com/v1/compute/project/PROJECT_ID/zones/ZONE/instances/INSTANCE",
       "https://www.googleapis.com/v1/compute/project/PROJECT_ID/zones/ZONE/instances/INSTANCE-2",
    ]
  }

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

PROJECT_ID: Google Cloud プロジェクト ID
ZONE: ターゲットプールのインスタンスのゾーン
INSTANCE、INSTANCE-2: ターゲットプールに追加するインスタンス

ターゲットプールのインスタンスの追加または削除

コンソール

ターゲットプールは Google Cloud コンソールでは編集できません。ターゲットプールを編集するには、Google Cloud CLI または API を使用します。

gcloud

gcloud compute を使用してターゲットプールにインスタンスを追加するには、target-pools add-instances コマンドを使用します。

  gcloud compute target-pools add-instances TARGET_POOL \
      --instances=INSTANCE,[INSTANCE-2,...]

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

TARGET_POOL: ターゲットプールの名前
INSTANCE、INSTANCE-2: ターゲットプールに追加するインスタンスの名前

インスタンスを削除するには、target-pools remove-instances コマンドを使用します。

  gcloud compute target-pools remove-instances TARGET_POOL \
      --instances=INSTANCE,[INSTANCE-2,...]

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

TARGET_POOL: ターゲットプールの名前
INSTANCE、INSTANCE-2: ターゲットプールから削除するインスタンスの名前

API

API の場合は、POST リクエストを次の URI に送信します。

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/removeInstance
  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/addInstance

リクエストの本文で、追加または削除するインスタンスの完全修飾 URI を指定する必要があります。

  {
   "instances": [
      {"instance": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE"},
      {"instance": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE-2"}
    ]
  }

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

PROJECT_ID: Google Cloud プロジェクト ID
TARGET_POOL: 更新するターゲットプールの名前
REGION: ターゲットプールがあるリージョン
ZONE: 更新されたインスタンスが存在するゾーン
INSTANCE、INSTANCE-2: ターゲットプールに追加するインスタンス

詳細については、API リファレンスドキュメントの targetPools.addInstance と targetPools.removeInstance のメソッドをご覧ください。

ターゲットプールの一覧表示

コンソール

ターゲットプールのリストを表示するには、ロードバランシングの詳細設定メニューを使用します。

詳細設定ページの [ターゲットプール] タブに移動します。
[ターゲットプール] に移動

このページには、ターゲットプールのリストが表示されます。

gcloud

gcloud compute を使用して既存のターゲットプールの一覧を表示するには、target-pools list コマンドを使用します。

  gcloud compute target-pools list

詳細出力を得るには、describe コマンドを使用してプール名を指定します。

API

API の場合は、次の URI に GET リクエストを送信します。

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools

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

PROJECT_ID: Google Cloud プロジェクト ID
REGION: ターゲットプールがあるリージョン

ターゲットプールの情報の取得

コンソール

ターゲットプールに関する情報を取得するには、ロードバランシングの詳細設定メニューを使用します。

詳細設定ページの [ターゲットプール] タブに移動します。
[ターゲットプール] に移動
詳細を表示するには、ターゲットプールの名前をクリックします。

gcloud

gcloud compute を使用して単一のターゲットプールに関する情報を取得するには、target-pools describe コマンドを使用します。

  gcloud compute target-pools describe TARGET_POOL

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

TARGET_POOL: ターゲットプールの名前

API

API の場合は、次の URI に空の GET リクエストを送信します。

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL

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

PROJECT_ID: Google Cloud プロジェクト ID
TARGET_POOL: 更新するターゲットプールの名前
REGION: ターゲットプールがあるリージョン

インスタンスのヘルスステータスの取得

コンソール

ターゲットプール内のインスタンスのヘルスステータスを取得するには、ロードバランシングの詳細設定メニューを使用します。

詳細設定ページの [ターゲットプール] タブに移動します。
[ターゲットプール] に移動
ターゲットプールの名前をクリックします。
[ターゲットプールの詳細] ページに、すべてのインスタンスとヘルスステータスが表示されます。

gcloud

gcloud compute を使用して、ターゲットプール内の 1 つまたはすべてのインスタンスの現在のヘルスステータスを確認するには、gcloud compute target-pools get-health コマンドを実行します。

  gcloud compute target-pools get-health TARGET_POOL

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

TARGET_POOL: ターゲットプールの名前

構成済みのヘルスチェックの指定に従い、コマンドからヘルスステータスが正常または異常のいずれかで戻されます。

API

API の場合は、リクエストボディに指定したインスタンスを使用して、HTTP POST リクエストを次の URI に対して実行します。

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/getHealth

  {
    "instance": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE"
  }

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

PROJECT_ID: Google Cloud プロジェクト ID
TARGET_POOL: 更新するターゲットプールの名前
REGION: ターゲットプールがあるリージョン
ZONE: インスタンスが存在するゾーン
INSTANCE: ヘルスチェックステータスを確認するインスタンス

ターゲットプールの削除

ターゲットプールを削除するには、そのターゲットプールがどの転送ルールでも参照されていないことを確認する必要があります。転送ルールがターゲットプールを参照している場合は、その参照を解除するため、転送ルールを削除する必要があります。

コンソール

Google Cloud コンソールを使用してターゲットプールを削除するには、ロードバランシングの詳細設定メニューを使用します。

詳細設定ページの [ターゲットプール] タブに移動します。
[ターゲットプール] に移動
ターゲットプールの名前をクリックします。
[削除] をクリックします。
[ターゲットプールの削除] ウィンドウで、[削除] をクリックします。

gcloud

gcloud compute を使用してターゲットプールを削除するには、target-pools delete コマンドを使用します。

  gcloud compute target-pools delete TARGET_POOL

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

TARGET_POOL: 削除するターゲットプールの名前

API

API の場合は、次の URI に空の DELETE リクエストを送信します。

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL

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

PROJECT_ID: Google Cloud プロジェクト ID
TARGET_POOL: 更新するターゲットプールの名前
REGION: ターゲットプールがあるリージョン

ターゲットプールのヘルスチェックの追加または削除

ヘルスチェックオブジェクトは、ターゲットプールとの関連付けまたは関連付けの解除が可能なスタンドアロンのグローバルリソースです。

ターゲットプールに関連付けられたヘルスチェックがない場合、外部パススルーネットワークロードバランサはすべてのインスタンスが正常であるとし、ターゲットプール内のすべてのインスタンスにトラフィックを送信します。ただし、ヘルスチェックが関連付けられていないターゲットプールのヘルスステータスを照会すると unhealthy ステータスが戻され、そのターゲットプールにヘルスチェックが備わっていないことが示されます。インスタンスの管理をサポートするため、ターゲットプールにはヘルスチェックを関連付けることを推奨します。

外部パススルーネットワークロードバランサは、レガシー HTTP ヘルスチェックを使用して、ターゲットプール内のインスタンスの状態を判断します。外部パススルーネットワークロードバランサで使用できるのはレガシー HTTP ヘルスチェックのみです。レガシー HTTPS ヘルスチェックは使用できません。

コンソール

Google Cloud コンソールを使用する場合は、ターゲットプールバックエンドを使用して外部パススルーネットワークロードバランサを作成する際に、レガシー HTTP ヘルスチェックを作成できます。

Google Cloud コンソールの [ヘルスチェック] ページで、スタンドアロンのレガシーヘルスチェックを作成することはできません。

gcloud

gcloud compute を使用してターゲットプールにヘルスチェックを追加するには、target-pools add-health-checks コマンドを使用します。

  gcloud compute target-pools add-health-checks TARGET_POOL \
      --http-health-check=HEALTH_CHECK

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

TARGET_POOL: ターゲットプールの名前
HEALTH_CHECK: このターゲットプールで使用されるレガシー HTTP ヘルスチェック

ヘルスチェックを削除するには、target-pools remove-health-checks コマンドを使用します。

  gcloud compute target-pools remove-health-checks TARGET_POOL \
    --http-health-check=HEALTH_CHECK

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

TARGET_POOL: ターゲットプールの名前
HEALTH_CHECK: このターゲットプールから削除されるレガシー HTTP ヘルスチェック

API

API を使用してヘルスチェックの関連付けまたは関連付けの解除を行うには、適切な URI に HTTP POST リクエストを送信します。

  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/removeHealthCheck
  https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/addHealthCheck

リクエストの本文には、関連付けるまたは関連付けを解除するヘルスチェックが含まれている必要があります。

  {
    "healthCheck": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/httpHealthChecks/HEALTH_CHECK"
  }

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

PROJECT_ID: Google Cloud プロジェクト ID
TARGET_POOL: 更新するターゲットプールの名前
REGION: ターゲットプールがあるリージョン
HEALTH_CHECK: ターゲットプールに関連付ける、または関連付けを解除するレガシー HTTP ヘルスチェック

詳細については、targetPools.addHealthCheck と targetPools.removeHealthCheck の API リファレンスドキュメントをご覧ください。

バックアップターゲットプールの追加または削除

ターゲットプールを初めて作成する際、ターゲットプールが正常でなくなった場合にトラフィックを受信するバックアップターゲットプールを指定できます。

バックアップターゲットプールを一度もセットアップしたことがない場合は、機能が正しく動作するようにヘルスチェックもセットアップする必要があります。

コンソール

ターゲットプールは Google Cloud コンソールでは編集できません。ターゲットプロキシを編集するには、Google Cloud CLI または API を使用します。

gcloud

gcloud compute を使用してバックアッププールリソースを更新するには、target-pools set-backup コマンドを使用します。

  gcloud compute target-pools set-backup TARGET_POOL \
      --backup-pool=BACKUP_POOL \
      --failover-ratio=FAILOVER_RATIO

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

TARGET_POOL: ターゲットプールの名前
BACKUP_POOL: バックアップターゲットプールの名前
FAILOVER_RATIO: ターゲットプールが正常ではないと宣言されるタイミング（0.0～1.0 の値）

API

API を使用してバックアッププールを更新または削除するリクエストを実行するには、次の URI に POST リクエストを送信します。

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/TARGET_POOL/setBackup?failoverRatio=FAILOVER_RATIO

  {
    "target": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetPools/BACKUP_POOL"
  }

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

PROJECT_ID: Google Cloud プロジェクト ID
TARGET_POOL: 更新するターゲットプールの名前
REGION: ターゲットプールがあるリージョン
BACKUP_POOL: ターゲットプールに関連付けるバックアッププールの名前
FAILOVER_RATIO: フェイルオーバー率

空のターゲットを定義した場合、またはフェイルオーバーの比率を定義しなかった場合、このターゲットプールのバックアッププールは動作しません。

次のステップ

ターゲットプールの詳細については、API リファレンスドキュメントの targetPools.setBackup をご覧ください。
転送ルールの詳細については、転送ルールの概要をご覧ください。

ターゲット プールの使用

ターゲット プールのプロパティ

フェイルオーバーの条件

ターゲット プールの作成

コンソール

gcloud

API

ターゲット プールのインスタンスの追加または削除

コンソール

gcloud

API

ターゲット プールの一覧表示

コンソール

gcloud

API

ターゲット プールの情報の取得

コンソール

gcloud

API

インスタンスのヘルス ステータスの取得

コンソール

gcloud

API

ターゲット プールの削除

コンソール

gcloud

API

ターゲット プールのヘルスチェックの追加または削除

コンソール

gcloud

API

バックアップ ターゲット プールの追加または削除

コンソール

gcloud

API

次のステップ

ターゲットプールの使用

ターゲットプールのプロパティ

ターゲットプールの作成

ターゲットプールのインスタンスの追加または削除

ターゲットプールの一覧表示

ターゲットプールの情報の取得

インスタンスのヘルスステータスの取得

ターゲットプールの削除

ターゲットプールのヘルスチェックの追加または削除

バックアップターゲットプールの追加または削除