ポートマッピングサービスを作成する

このページでは、サービスプロデューサーが Private Service Connect ポートマッピングを使用するサービスを公開する方法について説明します。

Private Service Connect ポートマッピングを使用すると、コンシューマー仮想マシン（VM）インスタンスは、1 つの Private Service Connect エンドポイントを介して、特定のプロデューサー VM の特定のサービスポートと非公開で通信できます。

始める前に

プロジェクトで Compute Engine API を有効にする必要があります。
ポートマッピング NEG に接続するネットワークエンドポイントごとに VM を作成する必要があります。VM はすべて同じリージョンに存在する必要があります。
公開サービスについてをご覧ください。
Private Service Connect のポートマッピングについてをご覧ください。

必要なロール

Private Service Connect ポートマッピングを使用してサービスを公開するために必要な権限を取得するには、プロデューサープロジェクトに対して次の IAM ロールを付与するよう管理者に依頼してください。

Compute ロードバランサ管理者（roles/compute.loadBalancerAdmin）
Compute ネットワーク管理者（roles/compute.networkAdmin）

ロールの付与の詳細については、アクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

ポートマッピングサービスを作成して公開する

ポートマッピングサービスは、内部パススルーネットワークロードバランサと同様ですが、トラフィックはロードバランシングされません。ポートマッピングサービスを作成して公開するには、次の操作を行います。

ポートマッピング NEG を作成する
ポートマッピング NEG にネットワークエンドポイントを追加する
ポートマッピングサービスを作成する
ポートマッピングサービスを公開する

ポートマッピング NEG を作成する

ポートマッピングネットワーク NEG は、ネットワークエンドポイントタイプが GCE_VM_IP_PORTMAP のリージョン NEG です。ポートマッピング NEG のタイプは、作成後に変更できません。

ポートマッピング NEG を作成するときに、サブネットを選択します。ポートマッピング NEG に関連付けるネットワークエンドポイントには、このサブネットのプライマリネットワークインターフェースが必要です。

コンソール

Google Cloud コンソールで、[ネットワークエンドポイントグループ] ページに移動します。

[ネットワークエンドポイントグループ] に移動
[ネットワークエンドポイントグループを作成] をクリックします。
名前を入力します。
[ネットワークエンドポイントグループの種類] をクリックし、[ポートマッピング NEG（リージョン）] を選択します。
リージョンを選択します。
ネットワークを選択します。
サブネットワークを選択します。
[作成] をクリックします。

gcloud

network-endpoints-groups create コマンドを使用します。

gcloud beta compute network-endpoint-groups create NEG \
    --region=REGION \
    --network=NETWORK \
    --subnet=SUBNET \
    --network-endpoint-type=GCE_VM_IP_PORTMAP

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

NEG: ポートマッピング NEG の名前
REGION: ポートマッピング NEG のリージョン
NETWORK: ポートマッピング NEG の VPC ネットワーク
SUBNET: ポートマッピング NEG のサブネット

API

POST リクエストを regionNetworkEndpointGroups.insert メソッドに送信します。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/networkEndpointGroups
{
  "name": "NEG",
  "networkEndpointType": "GCE_VM_IP_PORTMAP",
  "network": "projects/PROJECT_ID/global/networks/NETWORK",
  "subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET"
}

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

PROJECT_ID: ポートマッピング NEG のプロジェクト ID
REGION: ポートマッピング NEG のリージョン
NEG: ポートマッピング NEG の名前
NETWORK: ポートマッピング NEG の VPC ネットワーク
SUBNET: ポートマッピング NEG のサブネット

ポートマッピング NEG にネットワークエンドポイントを追加する

ポートマッピングを含む 1 つ以上のネットワークエンドポイントを作成し、ポートマッピング NEG に接続します。

ポートマッピング NEG のネットワークエンドポイントはゾーンであり、次の要件を満たす必要があります。

各ネットワークエンドポイントは、ポートマッピング NEG と同じサブネットにプライマリネットワークインターフェースを持つ Compute Engine VM を参照します。
各ネットワークエンドポイントは、一意のクライアント宛先ポートを参照します。
各ネットワークエンドポイントは、サービスポートと VM の一意の組み合わせを参照する必要があります。

コンソール

Google Cloud コンソールで、[ネットワークエンドポイントグループ] ページに移動します。

[ネットワークエンドポイントグループ] に移動
更新するポートマッピング NEG の名前をクリックします。
[ネットワークエンドポイントを追加] をクリックします。
[VM インスタンス] をクリックして、VM を選択します。
[VM ポート 1] をクリックし、サービスポートを入力します。
[クライアントポート 1] をクリックし、クライアントの宛先ポートを入力します。
追加するネットワークエンドポイントごとに、[ネットワークエンドポイントを追加] をクリックして、ネットワークエンドポイントの詳細を入力します。
[作成] をクリックします。

gcloud

network-endpoint-groups update コマンドを使用します。接続するネットワークエンドポイントごとに --add-endpoint フラグを指定します。

gcloud beta compute network-endpoint-groups update NEG \
    --region=REGION \
    --add-endpoint=client-destination-port=CLIENT_DESTINATION_PORT_1,instance=projects/PROJECT_ID/zones/ZONE_1/instances/VM_1_NAME,port=VM_1_PORT \
    --add-endpoint=client-destination-port=CLIENT_DESTINATION_PORT_2,instance=projects/PROJECT_ID/zones/ZONE_2/instances/VM_2_NAME,port=VM_2_PORT

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

NEG: ポートマッピング NEG の名前
REGION: ポートマッピング NEG のリージョン
CLIENT_DESTINATION_PORT_1: 最初のネットワークエンドポイントのクライアント宛先ポート
PROJECT_ID: プロデューサープロジェクトのプロジェクト ID
ZONE_1: 最初のネットワークエンドポイントのゾーン
VM_1_NAME: 最初のネットワークエンドポイントの宛先 VM の名前
VM_1_PORT: 最初のネットワークエンドポイントのサービスポート
CLIENT_DESTINATION_PORT_2: 2 番目のネットワークエンドポイントのクライアント宛先ポート
ZONE_2: 2 番目のネットワークエンドポイントのゾーン
VM_2_NAME: 2 番目のネットワークエンドポイントの宛先 VM の名前
VM_2_PORT: 2 番目のネットワークエンドポイントのサービスポート

API

POST リクエストを regionNetworkEndpointGroups.attachNetworkEndpoints メソッドに送信します。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/networkEndpointGroups/NEG/attachNetworkEndpoints
{
  "networkEndpoints": [
    {
      "clientDestinationPort":CLIENT_DESTINATION_PORT_1,
      "instance": "projects/PROJECT_ID/zones/ZONE_1/instances/VM_1_NAME",
      "port": SERVICE_PORT_1
    },
    {
      "clientDestinationPort": CLIENT_DESTINATION_PORT_2,
      "instance": "projects/PROJECT_ID/zones/ZONE_2/instances/VM_2_NAME",
      "port": SERVICE_PORT_2
    }
  ]
}

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

PROJECT_ID: プロデューサープロジェクトのプロジェクト ID
REGION: ポートマッピング NEG のリージョン
NEG: ポートマッピング NEG の名前
CLIENT_DESTINATION_PORT_1: 最初のネットワークエンドポイントのクライアント宛先ポート
ZONE_1: 最初のネットワークエンドポイントのゾーン
VM_1_NAME: 最初のネットワークエンドポイントの宛先 VM の名前
SERVICE_PORT_1: 最初のネットワークエンドポイントのサービスポート
CLIENT_DESTINATION_PORT_2: 2 番目のネットワークエンドポイントのクライアント宛先ポート
ZONE_2: 2 番目のネットワークエンドポイントのゾーン
VM_2_NAME: 2 番目のネットワークエンドポイントの宛先 VM の名前
SERVICE_PORT_2: 2 番目のネットワークエンドポイントのサービスポート