使用 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

控制台

开始配置

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 keepalive 超时	输入 5 到 1200 秒的超时值。默认值为 610 秒。
证书	选择现有的 SSL 证书或创建新证书。 如需创建 HTTPS 负载均衡器，您必须具有要在 HTTPS 代理中使用的 SSL 证书资源。您可以使用 Google 管理的 SSL 证书或自行管理的 SSL 证书创建 SSL 证书资源。 如需创建 Google 管理的证书，您必须拥有一个网域。该网域的 A 记录必须解析为负载均衡器的 IP 地址（在此示例中为 example-ip）。建议使用 Google 管理的证书，因为 Google Cloud 会自动获取、管理和续订这些证书。如果您没有网域，则可以使用自签名 SSL 证书进行测试。
可选：启用从 HTTP 到 HTTPS 的重定向	使用此复选框可启用从 HTTP 到 HTTPS 的重定向。 启用此复选框会创建一个额外的部分 HTTP 负载均衡器，它使用与 HTTPS 负载均衡器相同的 IP 地址，并将 HTTP 请求重定向到负载均衡器的 HTTPS 前端。 只有在选择 HTTPS 协议并使用预留 IP 地址时，才能选中此复选框。

如果您想在不设置 SSL 证书资源（或 Google 管理的证书所需要的网域）的情况下测试此过程，则可以设置 HTTP 负载均衡器。

如需创建 HTTP 负载均衡器，请验证以下选项已使用这些值进行配置：

属性	值（按照说明输入值或选择选项）
协议	HTTP
网络服务层级	高级
IP 版本	IPv4
IP 地址	example-ip
端口	80
可选：HTTP keepalive 超时	输入 5 到 1200 秒的超时值。默认值为 610 秒。

4. 点击完成。

后端配置

1. 点击后端配置。
2. 在后端服务和后端存储桶列表中，点击创建后端服务。
3. 在名称部分，输入名称。
4. 在后端类型下，选择无服务器网络端点组。
5. 保持协议不变。此参数会被忽略。
6. 在后端部分的新建后端中，选择创建无服务器网络端点组。
7. 在名称部分，输入名称。
8. 在区域中，选择 us-central1，然后选择 Cloud Run。
9. 选中选择服务名称。
10. 在服务列表中，选择您要为其创建负载均衡器的 Cloud Run 服务。
11. 点击创建。
12. 在新建后端部分中，点击完成。
13. 点击创建。

路由规则

路由规则决定了流量的定向方式。如需配置路由，您需要设置主机规则和路径匹配器，它们是外部应用负载均衡器网址映射的配置组件。

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. 创建网址映射以将传入的请求路由到此后端服务：

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

   此示例网址映射仅会定位一项代表单个无服务器应用的后端服务，因此我们不需要设置主机规则或路径匹配器。如果您有多项后端服务，则可以使用主机规则根据主机名将请求定向到不同的服务，还可以设置路径匹配器以根据请求路径将请求定向到不同的服务。

5. 如需创建 HTTPS 负载均衡器，您必须具有要在 HTTPS 目标代理中使用的 SSL 证书资源。您可以使用 Google 管理的 SSL 证书或自行管理的 SSL 证书创建 SSL 证书资源。建议使用 Google 管理的证书，因为 Google Cloud 会自动获取、管理和续订这些证书。
   
   如需创建 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. 创建目标 HTTPS 代理以将请求路由到您的网址映射：

   对于 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 keepalive 超时。超时值必须介于 5 到 1200 秒之间。默认值为 610 秒。
   • SSL_CERTIFICATE_NAME：SSL 证书的名称。
   • URL_MAP_NAME：网址映射的名称。
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. 在部署 Cloud Run 服务的同一区域中创建第二个无服务器 NEG。

   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：第二个无服务器 NEG 的名称
   • CLOUD_RUN_SERVICE_2：Cloud Run 服务的名称

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：第二个无服务器 NEG 的名称

Cloud Run

下表假定您有一个名为 example.com 的自定义网域，并且您的所有 Cloud Run 服务都使用外部应用负载均衡器映射到此网域。

Cloud Run functions

下表假定您有一个名为 example.com 的自定义网域，并且您的所有 Cloud Run functions 服务都映射到此网域。

App Engine

下表假定您有一个名为 example.com 的自定义网域，并且您的所有 App Engine 服务都映射到此网域。

API 网关

下表假定您有一个名为 example.com 的自定义网域，并且您的所有 API Gateway 服务都映射到此网域。

控制台

对于新的负载均衡器，您可以使用与本主题前面介绍的相同的端到端流程。配置后端服务时，请不要选择特定服务，而是输入网址掩码。

如果您已有负载均衡器，则可以修改后端配置，并让无服务器 NEG 指向网址掩码而不是特定服务。

如需将基于网址掩码的无服务器 NEG 添加到现有的后端服务，请执行以下操作：

1. 转到 Google Cloud 控制台中的“负载均衡”页面。
   转到“负载均衡”页面
2. 点击要修改其后端服务的负载均衡器的名称。
3. 在负载均衡器详情页面上，点击修改 edit。
4. 在修改全球外部应用负载均衡器页面上，点击后端配置。
5. 在后端配置页面上，针对要修改的后端服务点击修改 edit。
6. 点击添加后端。
7. 选择创建无服务器网络端点组。
   1. 为名称输入 helloworld-serverless-neg。
   2. 在区域下，选择 us-central1。
   3. 在无服务器网络端点组类型下，选择其中创建了无服务器应用（或服务或功能）的平台。
      1. 选择使用网址掩码。
      2. 输入网址掩码。如需了解如何创建网址掩码，请参阅构建网址掩码。
      3. 点击创建。
8. 在新建后端部分中，点击完成。
9. 点击更新。

gcloud：Cloud Run

如需使用示例网址掩码 example.com/<service> 创建无服务器 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 functions

如需使用示例网址掩码 example.com/<service> 创建无服务器 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> 创建无服务器 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> 创建无服务器 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. 在修改全球外部应用负载均衡器页面上，点击后端配置。

5. 在后端配置页面上，针对要修改的后端服务点击 edit 修改。

6. 向下滚动并展开高级配置部分。

7. 在离群值检测部分中，选中启用复选框。

8. 点击 edit 修改以配置离群值检测。

   验证以下选项是否配置了这些值：

   属性	值
   连续错误数	5
   间隔时间	1000
   基本移除时间	30000
   最大移除百分比	50
   引发强制执行的连续错误数	100

   在此示例中，离群值检测分析每秒运行一次。如果 Envoy 代理收到的连续 HTTP 5xx 状态代码数为 5 个或更多，则后端端点会从 Envoy 代理的负载均衡池中移除 30 秒。当强制百分比设置为 100% 时，后端服务会在每次运行离群值检测分析时从这些特定 Envoy 代理的负载均衡池中逐出运行状况不佳的端点。如果满足移除条件，则最多可以从负载均衡池中移除 50% 的后端端点。

9. 点击保存。

10. 如需更新后端服务，请点击更新。

11. 如需更新负载均衡器，请在修改全球外部应用负载均衡器页面上点击更新。

gcloud

1. 将后端服务导出到 YAML 文件。

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

   将 BACKEND_SERVICE_NAME 替换为后端服务的名称。

2. 修改后端服务的 YAML 配置，以添加离群值检测字段，如 outlierDetection 部分中的以下 YAML 配置所示。

   在此示例中，离群值检测分析每秒运行一次。如果 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：第二个无服务器 NEG 的名称

3. 通过导入最新配置来更新后端服务。

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

   离群值检测现已在后端服务上启用。

控制台

1. 如需确保要删除的无服务器 NEG 当前未被任何后端服务使用，请转到负载均衡高级菜单中的后端服务标签页。
   转到“后端服务”标签页
2. 如果无服务器 NEG 当前正在使用：
   1. 点击使用无服务器 NEG 的后端服务的名称。
   2. 点击修改 edit。
   3. 从后端列表中，点击 delete 以从后端服务中移除无服务器 NEG 后端。
   4. 点击保存。
3. 转到 Google Cloud 控制台中的网络端点组页面。
   转到“网络端点组”页面
4. 选中您要删除的无服务器 NEG 对应的复选框。
5. 点击删除。
6. 再次点击删除进行确认。

gcloud

如需从后端服务中移除无服务器 NEG，您必须指定在其中创建该 NEG 的区域。此外，您还必须指定 --global 标志，因为 helloworld-backend-service 是全球性资源。

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