Cloud Run、App Engine、または Cloud Run functions を使用してグローバル外部アプリケーション ロードバランサを設定する。

コンソール

1. Google Cloud コンソールで、[外部 IP アドレス] ページに移動します。

   [外部 IP アドレス] に移動

2. [静的外部 IP アドレスを予約] をクリックします。

3. [名前] に「example-ip」と入力します。

4. [ネットワーク サービス ティア] で [プレミアム] を選択します。

5. [IP バージョン] で [IPv4] を選択します。

6. [種類] で [グローバル] を選択します。

7. [予約] をクリックします。

gcloud

gcloud compute addresses create example-ip \
    --network-tier=PREMIUM \
    --ip-version=IPV4 \
    --global

予約された IPv4 アドレスをメモします。

gcloud compute addresses describe example-ip \
    --format="get(address)" \
    --global

Console

構成を開始する

1. Google Cloud コンソールで、[ロード バランシング] ページに移動します。

   [ロード バランシング] に移動

2. [ロードバランサを作成] をクリックします。
3. [ロードバランサの種類] で [アプリケーション ロードバランサ（HTTP / HTTPS）] を選択し、[次へ] をクリックします。
4. [インターネット接続または内部] で [インターネット接続（外部）] を選択し、[次へ] をクリックします。
5. [グローバルまたはシングル リージョンのデプロイ] で [グローバル ワークロードに最適] を選択し、[次へ] をクリックします。
6. [ロードバランサの世代] で [グローバル外部アプリケーション ロードバランサ] を選択し、[次へ] をクリックします。
7. [構成] をクリックします。

基本構成

1. ロードバランサの名前に「serverless-lb」と入力します。
2. ウィンドウを開いたままにして続行します。

フロントエンドの構成

1. [フロントエンドの構成] をクリックします。
2. [名前] に名前を入力します。
3. HTTPS ロードバランサを作成するには、SSL 証明書（gcloud compute ssl-certificates list）が必要です。

   前述のように、Google マネージド証明書を使用することをおすすめします。

外部アプリケーション ロードバランサを構成するには、各フィールドを次のように指定します。

以下のオプションが次の値で構成されていることを確認します。

プロパティ	値（値を入力するか、指定されたオプションを選択）
プロトコル	HTTPS
ネットワーク サービス階層	プレミアム
IP バージョン	IPv4
IP アドレス	example-ip
ポート	443
省略可: HTTP キープアライブ タイムアウト	5～1,200 秒のタイムアウト値を入力します。デフォルト値は 610 秒です。
証明書	既存の SSL 証明書を選択するか、新しい証明書を作成します。 HTTPS ロードバランサを作成するには、HTTPS プロキシで使用する SSL 証明書リソースが必要です。SSL 証明書リソースは、Google マネージド SSL 証明書またはセルフマネージド SSL 証明書を使用して作成できます。 Google マネージド証明書を作成するには、ドメインが必要です。ドメインの A レコードは、ロードバランサの IP アドレス（この例では example-ip）に解決される必要があります。Google Cloud マネージド証明書を使用することをおすすめします。これらの証明書は Google Cloud で自動的に取得、管理、更新されます。ドメインがない場合は、自己署名 SSL 証明書を使用してテストできます。
省略可: HTTP から HTTPS へのリダイレクトを有効にする	このチェックボックスを使用して、HTTP から HTTPS へのリダイレクトを有効にします。 このチェックボックスをオンにすると、HTTPS ロードバランサと同じ IP アドレスを使用し、HTTP リクエストをロードバランサの HTTPS フロントエンドにリダイレクトする追加の部分的な HTTP ロードバランサが作成されます。 このチェックボックスは、HTTPS プロトコルが選択されていて、予約済みの IP アドレスが使用されている場合にのみ選択できます。

SSL 証明書リソース（または Google マネージド証明書によって必要とされるドメイン）を設定せずにこのプロセスをテストする場合は、HTTP ロードバランサを設定できます。

HTTP ロードバランサを作成するには、次のオプションがこれらの値で構成されていることを確認します。

プロパティ	値（値を入力するか、指定されたオプションを選択）
プロトコル	HTTP
ネットワーク サービス階層	プレミアム
IP バージョン	IPv4
IP アドレス	example-ip
ポート	80
省略可: HTTP キープアライブ タイムアウト	5～1,200 秒のタイムアウト値を入力します。デフォルト値は 610 秒です。

4. [完了] をクリックします。

バックエンドの構成

1. [バックエンドの構成] をクリックします。
2. [バックエンド サービスとバックエンド バケット] リストで、[バックエンド サービスを作成] をクリックします。
3. [名前] に名前を入力します。
4. [バックエンド タイプ] で、[サーバーレス ネットワーク エンドポイント グループ] を選択します。
5. [プロトコル] は変更せず、そのままにします。このパラメータは無視されます。
6. [バックエンド] セクションの [新しいバックエンド] で、[サーバーレス ネットワーク エンドポイント グループを作成] を選択します。
7. [名前] に名前を入力します。
8. [リージョン] で、[us-central1] を選択し、[Cloud Run] を選択します。
9. [サービス名を選択] を選択します。
10. [サービス] リストで、ロードバランサを作成する Cloud Run サービスを選択します。
11. [作成] をクリックします。
12. [新しいバックエンド] セクションで、[完了] をクリックします。
13. [作成] をクリックします。

ルーティング ルール

ルーティング ルールは、トラフィックの転送方法を決定します。ルーティングを構成するには、ホストルールとパスマッチャーを設定します。これは外部アプリケーション ロードバランサの URL マップの構成要素です。

1. [ルーティング ルール] をクリックします。

2. デフォルトのホストとパスを保持します。この例では、すべてのリクエストが前の手順で作成したバックエンド サービスに送信されます。

構成の確認

1. [確認と完了] をクリックします。
2. すべての設定を確認します。
3. 省略可: [同等のコード] をクリックして、ロードバランサの作成に使用する REST API リクエストを表示します。
4. [作成] をクリックします。
5. ロードバランサの作成が完了するまで待ちます。
6. ロードバランサの名前（serverless-lb）をクリックします。
7. ロードバランサの IP アドレスをメモします（次のタスクで使用します）。次のタスクでは IP_ADDRESS とします。

gcloud

1. サーバーレス アプリにサーバーレス NEG を作成します。

   Cloud Run サービスを使用してサーバーレス NEG を作成するには:

      gcloud compute network-endpoint-groups create SERVERLESS_NEG_NAME \
          --region=us-central1 \
          --network-endpoint-type=serverless  \
          --cloud-run-service=CLOUD_RUN_SERVICE_NAME
      

   その他のオプションについては、gcloud compute network-endpoint-groups create の gcloud リファレンス ガイドをご覧ください。
2. バックエンド サービスを作成します。

      gcloud compute backend-services create BACKEND_SERVICE_NAME \
          --load-balancing-scheme=EXTERNAL_MANAGED \
          --global
      

3. サーバーレス NEG をバックエンドとしてバックエンド サービスに追加します。

      gcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
          --global \
          --network-endpoint-group=SERVERLESS_NEG_NAME \
          --network-endpoint-group-region=us-central1
      

4. 受信リクエストをバックエンド サービスに転送するための URL マップを作成します。

      gcloud compute url-maps create URL_MAP_NAME \
          --default-service BACKEND_SERVICE_NAME
      

   この URL マップの例では、1 つのサーバーレス アプリを表す 1 つのバックエンド サービスのみを対象としているため、ホストルールやパスマッチャーを設定する必要はありません。複数のバックエンド サービスを対象とする場合、ホスト名に基づいてリクエストを特定のサービスに転送するにはホストルールを使用します。また、パスマッチャーを設定すると、リクエストパスに基づいてリクエストを特定のサービスに転送できます。

5. HTTPS ロードバランサを作成するには、HTTPS ターゲット プロキシで使用する SSL 証明書リソースが必要です。SSL 証明書リソースは、Google マネージド SSL 証明書またはセルフマネージド SSL 証明書を使用して作成できます。このうち、Google Cloud が自動的に取得、管理、更新する Google マネージド証明書をおすすめします。
   
   Google マネージド証明書を作成するには、ドメインが必要です。ドメインがない場合は、自己署名 SSL 証明書を使用してテストできます。
   
   Google マネージド SSL 証明書リソースを作成するには、次のコマンドを実行します。

      gcloud compute ssl-certificates create SSL_CERTIFICATE_NAME \
          --domains DOMAIN
      

   セルフマネージド SSL 証明書リソースを作成するには、次のコマンドを実行します。

      gcloud compute ssl-certificates create SSL_CERTIFICATE_NAME \
          --certificate CRT_FILE_PATH \
          --private-key KEY_FILE_PATH
      

6. URL マップにリクエストを転送するターゲット HTTP(S) プロキシを作成します。

   HTTP ロードバランサの場合は、HTTP ターゲット プロキシを作成します。

      gcloud compute target-http-proxies create TARGET_HTTP_PROXY_NAME \
         --http-keep-alive-timeout-sec=HTTP_KEEP_ALIVE_TIMEOUT_SEC \
         --url-map=URL_MAP_NAME
      

   HTTPS ロードバランサの場合は、HTTPS ターゲット プロキシを作成します。プロキシはロードバランサの一部であり、HTTPS ロード バランシング用の SSL 証明書を保持するため、この手順で証明書も読み込みます。

      gcloud compute target-https-proxies create TARGET_HTTPS_PROXY_NAME \
          --http-keep-alive-timeout-sec=HTTP_KEEP_ALIVE_TIMEOUT_SEC \
          --ssl-certificates=SSL_CERTIFICATE_NAME \
          --url-map=URL_MAP_NAME
      

   以下を置き換えます。

   • TARGET_HTTP_PROXY_NAME: ターゲット HTTP プロキシの名前。
   • TARGET_HTTPS_PROXY_NAME: ターゲット HTTPS プロキシの名前。
   • HTTP_KEEP_ALIVE_TIMEOUT_SEC: クライアント HTTP キープアライブ タイムアウトの指定に使用するオプション フィールド。タイムアウト値は 5～1,200 秒の範囲で指定してください。デフォルト値は 610 秒です。
   • SSL_CERTIFICATE_NAME: SSL 証明書の名前。
   • URL_MAP_NAME: URL マップの名前。
7. 受信リクエストをプロキシに転送する転送ルールを作成します。
   
   

   HTTP ロードバランサの場合:

      gcloud compute forwarding-rules create HTTP_FORWARDING_RULE_NAME \
      --load-balancing-scheme=EXTERNAL_MANAGED \
      --network-tier=PREMIUM \
      --address=example-ip \
      --target-http-proxy=TARGET_HTTP_PROXY_NAME \
      --global \
      --ports=80
      

   HTTPS ロードバランサの場合:

      gcloud compute forwarding-rules create HTTPS_FORWARDING_RULE_NAME \
          --load-balancing-scheme=EXTERNAL_MANAGED \
          --network-tier=PREMIUM \
          --address=example-ip \
          --target-https-proxy=TARGET_HTTPS_PROXY_NAME \
          --global \
          --ports=443
      

コンソール

1. Google Cloud コンソールで、[ロード バランシング] ページに移動します。

   [ロード バランシング] に移動

2. バックエンド サービスを編集するロードバランサの名前をクリックします。

3. [ロードバランサの詳細] ページで、[edit編集] をクリックします。

4. [グローバル外部アプリケーション ロードバランサの編集] ページで、[バックエンドの構成] をクリックします。

5. [バックエンドの構成] ページで、変更するバックエンド サービスの [edit編集] をクリックします。

6. [バックエンド] セクションで、[バックエンドを追加] をクリックします。

7. [サーバーレス ネットワーク エンドポイント グループ] リストで、[サーバーレス ネットワーク エンドポイント グループの作成] を選択します。

8. サーバーレス NEG の名前を入力します。

9. [リージョン] で europe-west1 を選択します。

10. [サーバーレス ネットワーク エンドポイント グループの種類] では、[Cloud Run] を選択し、次の操作を行います。

    1. [サービスの選択] オプションを選択します。
    2. [サービス] リストで、ロードバランサを作成する Cloud Run サービスを選択します。

11. [作成] をクリックします。

12. [新しいバックエンド] ページで、[完了] をクリックします。

13. [保存] をクリックします。

14. バックエンド サービスを更新するには、[更新] をクリックします。

15. ロードバランサを更新するには、[グローバル外部アプリケーション ロードバランサの編集] ページで [更新] をクリックします。

gcloud

1. 2 つ目のサーバーレス NEG を Cloud Run サービスがデプロイされているのと同じリージョンに作成します。

   gcloud compute network-endpoint-groups create SERVERLESS_NEG_NAME_2 \
     --region=europe-west1 \
     --network-endpoint-type=SERVERLESS \
     --cloud-run-service=CLOUD_RUN_SERVICE_2
   

   以下を置き換えます。

   • SERVERLESS_NEG_NAME_2: 2 番目のサーバーレス NEG の名前
   • CLOUD_RUN_SERVICE_2: Cloud Run サービスの名前。

2. 2 番目のサーバーレス NEG をバックエンドとしてバックエンド サービスに追加します。

   gcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
     --global \
     --network-endpoint-group=SERVERLESS_NEG_NAME_2 \
     --network-endpoint-group-region=europe-west1
   

   以下を置き換えます。

   • BACKEND_SERVICE_NAME: バックエンド サービスの名前
   • SERVERLESS_NEG_NAME_2: 2 番目のサーバーレス NEG の名前

Cloud Run

この表では、example.com というカスタム ドメインがあり、すべての Cloud Run サービスが外部アプリケーション ロードバランサを使用してこのドメインにマッピングされていることを前提としています。

Cloud Run functions

この表では、example.com という名前のカスタム ドメインがあり、すべての Cloud Run functions のサービスがこのドメインにマッピングされていることを前提としています。

App Engine

この表では、example.com という名前のカスタム ドメインがあり、すべての App Engine サービスがこのドメインにマッピングされていることを前提としています。

API Gateway

この表では、example.com という名前のカスタム ドメインがあり、すべての API Gateway サービスがこのドメインにマッピングされていることを前提としています。

Console

新しいロードバランサの場合、このトピックで説明したものと同じエンドツーエンドのプロセスを使用できます。バックエンド サービスを構成する場合は、特定のサービスを選択する代わりに、URL マスクを入力します。

既存のロードバランサがある場合は、バックエンド構成を編集し、サーバーレス NEG に特定のサービスの代わりに URL マスクを指定できます。

URL マスクベースのサーバーレス NEG を既存のバックエンド サービスに追加するには:

1. Google Cloud Console の [Cloud Load Balancing] ページに移動します。
   [負荷分散] ページに移動
2. バックエンド サービスを編集するロードバランサの名前をクリックします。
3. [ロードバランサの詳細] ページで、[編集] editをクリックします。
4. [Edit global external Application Load Balancer] ページで、[Backend configuration] をクリックします。
5. [バックエンドの構成] ページで、変更するバックエンド サービスの [編集] edit をクリックします。
6. [バックエンドを追加] をクリックします。
7. [サーバーレス ネットワーク エンドポイント グループの作成] を選択します。
   1. [名前] に「helloworld-serverless-neg」と入力します。
   2. [リージョン] で、us-central1 を選択します。
   3. [サーバーレス ネットワーク エンドポイント グループの種類] で、サーバーレス アプリが作成されたプラットフォーム（またはサービスまたは関数）を選択します。
      1. [URL マスクを使用] を選択します。
      2. URL マスクを入力します。URL マスクを作成する方法については、URL マスクの作成をご覧ください。
      3. [作成] をクリックします。
8. [新しいバックエンド] セクションで、[完了] をクリックします。
9. [更新] をクリックします。

gcloud: Cloud Run

example.com/<service> のサンプル URL マスクを使用してサーバーレス NEG を作成するには:

gcloud compute network-endpoint-groups create helloworld-neg-mask \
  --region=us-central1 \
  --network-endpoint-type=serverless \
  --cloud-run-url-mask="example.com/<service>"

gcloud: Cloud Run 関数

example.com/<service> のサンプル URL マスクを使用してサーバーレス NEG を作成するには:

gcloud compute network-endpoint-groups create helloworld-neg-mask \
 --region=us-central1 \
 --network-endpoint-type=serverless \
 --cloud-function-url-mask="example.com/<service>"

gcloud: App Engine

example.com/<service> のサンプル URL マスクを使用してサーバーレス NEG を作成するには:

gcloud compute network-endpoint-groups create helloworld-neg-mask \
    --region=us-central1 \
    --network-endpoint-type=serverless \
    --app-engine-url-mask="example.com/<service>"

gcloud: API Gateway

example.com/<gateway> のサンプル URL マスクを使用してサーバーレス NEG を作成するには:

gcloud beta compute network-endpoint-groups create helloworld-neg-mask \
  --region=us-central1 \
  --network-endpoint-type=serverless \
  --serverless-deployment-platform=apigateway.googleapis.com \
  --serverless-deployment-resource=my-gateway \
  --serverless-deployment-url-mask="example.com/<gateway>"

コンソール

1. Google Cloud コンソールで、[ロード バランシング] ページに移動します。

   [ロード バランシング] に移動

2. バックエンド サービスを編集するロードバランサの名前をクリックします。

3. [ロードバランサの詳細] ページで、[edit編集] をクリックします。

4. [Edit global external Application Load Balancer] ページで、[バックエンドの構成] をクリックします。

5. [バックエンドの構成] ページで、変更するバックエンド サービスの [edit編集] をクリックします。

6. 下にスクロールして [高度な構成] セクションを開きます。

7. [外れ値検出] セクションで、[有効にする] チェックボックスをオンにします。

8. [edit編集] をクリックして外れ値検出を構成します。

   以下のオプションが次の値で構成されていることを確認します。

   プロパティ	値
   連続するエラー	5
   間隔	1000
   ベースの排出時間	30000
   最大排出率	50
   連続するエラーの適用	100

   この例では、外れ値検出分析が 1 秒ごとに実行されます。Envoy プロキシが連続して受信した HTTP 5xx ステータス コードの数が 5 以上の場合、バックエンド エンドポイントは Envoy プロキシのロード バランシング プールから 30 秒間除外されます。適用の割合が 100% に設定されている場合、バックエンド サービスでは、外れ値検出分析が実行されるたびに、これらの特定の Envoy プロキシのロード バランシング プールから正常でないエンドポイントが排出されます。除外条件が満たされると、ロード バランシング プールからバックエンド エンドポイントの最大 50% が排出されます。

9. [保存] をクリックします。

10. バックエンド サービスを更新するには、[更新] をクリックします。

11. ロードバランサを更新するには、[Edit global external Application Load Balancer] ページで [更新] をクリックします。

gcloud

1. バックエンド サービスを YAML ファイルにエクスポートします。

   gcloud compute backend-services export BACKEND_SERVICE_NAME \
     --destination=BACKEND_SERVICE_NAME.yaml --global
   

   BACKEND_SERVICE_NAME は、バックエンド サービスの名前に置き換えます。

2. outlierDetection セクションの次の YAML 構成でハイライト表示されているように、バックエンド サービスの YAML 構成を編集して、外れ値検出のフィールドを追加します。

   この例では、外れ値検出分析が 1 秒ごとに実行されます。Envoy プロキシが連続して受信した HTTP 5xx ステータス コードの数が 5 以上の場合、バックエンド エンドポイントは Envoy プロキシのロード バランシング プールから 30 秒間除外されます。適用の割合が 100% に設定されている場合、バックエンド サービスでは、外れ値検出分析が実行されるたびに、これらの特定の Envoy プロキシのロード バランシング プールから正常でないエンドポイントが排出されます。除外条件が満たされると、ロード バランシング プールからバックエンド エンドポイントの最大 50% が排出されます。

   name: BACKEND_SERVICE_NAME
   backends:
   - balancingMode: UTILIZATION
     capacityScaler: 1.0
     group: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/networkEndpointGroups/SERVERLESS_NEG_NAME
   - balancingMode: UTILIZATION
     capacityScaler: 1.0
     group: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_B/networkEndpointGroups/SERVERLESS_NEG_NAME_2
   outlierDetection:
     baseEjectionTime:
       nanos: 0
       seconds: 30
     consecutiveErrors: 5
     enforcingConsecutiveErrors: 100
     interval:
       nanos: 0
       seconds: 1
     maxEjectionPercent: 50
   port: 80
   selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE_NAME
   sessionAffinity: NONE
   timeoutSec: 30
   ...
   

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

   • BACKEND_SERVICE_NAME: バックエンド サービスの名前
   • PROJECT_ID: オブジェクトの ID
   • REGION_A と REGION_B: ロードバランサを構成したリージョン
   • SERVERLESS_NEG_NAME: 最初のサーバーレス NEG の名前
   • SERVERLESS_NEG_NAME_2: 2 番目のサーバーレス NEG の名前

3. 最新の構成をインポートして、バックエンド サービスを更新します。

   gcloud compute backend-services import BACKEND_SERVICE_NAME \
     --source=BACKEND_SERVICE_NAME.yaml --global
   

   バックエンド サービスで外れ値検出が有効になりました。

Console

1. 削除するサーバーレス NEG が現在バックエンド サービスによって使用されていないことを確認するには、負荷分散の詳細設定メニューの [バックエンド サービス] タブに移動します。
   [バックエンド サービス] タブに移動
2. サーバーレス NEG が使用中の場合、次の操作を行います。
   1. サーバーレス NEG を使用するバックエンド サービスの名前をクリックします。
   2. [編集] edit をクリックします。
   3. [バックエンド] のリストで delete をクリックし、バックエンド サービスからサーバーレス NEG バックエンドを削除します。
   4. [保存] をクリックします。
3. Google Cloud コンソールの [ネットワーク エンドポイント グループ] ページに移動します。
   [ネットワーク エンドポイント グループ] ページに移動
4. 削除するサーバーレス NEG のチェックボックスをオンにします。
5. [削除] をクリックします。
6. もう一度 [削除] をクリックして確定します。

gcloud

バックエンド サービスからサーバーレス NEG を削除するには、NEG が作成されたリージョンを指定する必要があります。helloworld-backend-service はグローバル リソースであるため、--global フラグも指定する必要があります。

gcloud compute backend-services remove-backend helloworld-backend-service \
    --network-endpoint-group=helloworld-serverless-neg \
    --network-endpoint-group-region=us-central1 \
    --global

サーバーレス NEG を削除するには:

gcloud compute network-endpoint-groups delete helloworld-serverless-neg \
    --region=us-central1