请求的路由方式

区域 ID

REGION_ID 是 Google 根据您在创建应用时选择的区域分配的缩写代码。此代码不对应于国家/地区或省，尽管某些区域 ID 可能类似于常用国家/地区代码和省代码。对于 2020 年 2 月以后创建的应用，REGION_ID.r 包含在 App Engine 网址中。对于在此日期之前创建的现有应用，网址中的区域 ID 是可选的。

详细了解区域 ID。

确定

Python 2.7/3 |Java 8/11/17 |PHP 5/7+ |Ruby |Go 1.11 / 1.12+ |Node.js

本页面介绍了用户发出的 HTTP 请求到达服务相应版本的方式。请求可以通过以下方式路由：

• 使用网址进行路由

• 使用调度文件进行路由

• 使用 Cloud Load Balancing 进行路由

如果使用本地开发服务器测试应用，则可用的路由和调度功能略有不同。如需以编程方式创建同时适用于生产服务器和开发服务器的网址，请使用 ModulesService.getVersionHostname 方法。

如需了解详情，请参阅在开发服务器中路由。

使用网址进行路由

一旦您的应用能够在 App Engine 中运行，您就可以使用以下网址向应用发送 HTTP 请求：
https://PROJECT_ID.REGION_ID.r.appspot.com

其中，PROJECT_ID 是包含该应用的 Google Cloud 项目的 ID。

此网址将请求发送到您已配置为接收流量的版本的应用默认服务。

注意：我们建议使用 HTTPS 协议向应用发送请求。发送到 REGION_ID.r.appspot.com 的 HTTPS 请求必须使用字符串“-dot-”（而不是“.”）来分隔子网域。您可以将简单的“.”网址表示法用于您的自定义网域及 HTTP 请求。

服务和版本的网址

如果您的应用创建了多项服务，则每项服务都有自己的网址。服务的每个版本也都有自己的网址，因此您可以先行部署并测试一个新的版本，然后再将其配置为接收流量。

特定服务和版本的网址采用以下格式：

VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com

如果您不需要定位特定版本，则可以省略 VERSION-dot-。

如需检索应用的服务和版本的 ID，您可以使用以下任何工具：

控制台

在控制台中，您可以查看相应的实例、服务和版本页面。

gcloud

运行 gcloud app instances list 命令可以列出特定 Cloud 项目中的资源 ID。

API

如需以编程方式检索资源 ID，请参阅 Admin API 中的 list 方法。

示例网址

以下是 App Engine 的一些示例网址，其中显示了 App Engine 分配给您的应用的 appspot.com 网域以及您可以为应用设置的自定义网域。

• 向 default 服务的可用实例发送请求：

  
  https://PROJECT_ID.REGION_ID.r.appspot.com
  https://CUSTOM_DOMAIN

  为 default 服务中的流量配置的任何版本都会收到请求。

• 向特定服务的可用实例发送请求：

  
  https://SERVICE_ID-dot-PROJECT_ID.REGION_ID.r.appspot.com
  https://SERVICE_ID.CUSTOM_DOMAIN

  为所定位服务中的流量配置的任何版本都会收到请求。如果您定位的服务不存在，则系统会对请求进行软路由。

• 向

  default 服务中特定版本的可用实例发送请求：

  
  https://VERSION_ID-dot-default-dot-PROJECT_ID.REGION_ID.r.appspot.com
  https://VERSION_ID.CUSTOM_DOMAIN

  如果未定位服务，请求会发送到 default 服务。

软路由

如果一个请求与主机名的 PROJECT_ID.REGION_ID.r.appspot.com 部分匹配，但包含不存在的服务、版本或实例名称，则该请求会被路由到 default 服务。软路由不适用于自定义网域；如果主机名无效，发送到自定义网域的请求将返回 HTTP 404 状态代码。

定向路由

如果以下网址格式存在，那么这些网址格式必定可以被路由到其目标。您在调度文件中定义的格式永远不会拦截和重新路由这些请求：

• 向特定服务和版本的可用实例发送请求：

  
  https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com
  https://VERSION_ID.SERVICE_ID.PROJECT_ID.CUSTOM_DOMAIN

• 如果您使用的是手动扩缩服务，可以通过包含实例 ID 来定位实例并向其发送请求。实例 ID 是一个整数，范围介于 0 到正在运行的实例总数之间，可以按如下方式指定：

  向特定实例中的特定服务和版本发送请求：

  https://INSTANCE_ID-dot-VERSION_ID-dot-SERVICE_ID-dot-PROJECT_ID.REGION_ID.r.appspot.com
  https://INSTANCE_ID.VERSION_ID.SERVICE_ID.CUSTOM_DOMAIN

  注意：配置为自动扩缩或基本扩缩的服务不支持定位实例。实例 ID 必须是一个整数，范围介于 0 到正在运行的实例总数之间。无论您的扩缩类型或实例类别是什么，若未定位特定实例中的服务或版本，则无法向该实例发送请求。

使用调度文件进行路由

您可以创建调度文件以替换 App Engine 基于网址的路由规则并定义自己的自定义路由规则。使用调度文件，您可以根据传入请求网址中的路径或主机名将请求发送到特定服务。

创建调度文件

如需创建调度文件，请执行以下操作：

1. 在用于其他配置文件（例如 app.yaml）的同一目录中创建一个名为 dispatch.yaml 的文件。

2. 按照 dispatch.yaml 参考文档中的说明在该文件中定义路由规则。

对于路由规则，请注意以下事项：

• 您最多可以定义 20 个路由规则。每个规则都必须包含 url 和 service 元素。
• 这些规则必须使用 HTTP 网址格式，这种格式采用“.”表示法分隔子网域。不支持使用 HTTPS“-dot-”表示法定义的网址。
• 这些规则也适用于您在 Cron 文件中定义的网址。

例如，您可以创建一个调度文件，将诸如 https://simple-sample.uc.r.appspot.com/mobile/ 的移动请求路由到移动前端，并将诸如 https://simple-sample.uc.r.appspot.com/work/ 的工作器请求路由到静态后端：

dispatch:
  # Send all mobile traffic to the mobile frontend.
  - url: "*/mobile/*"
    service: mobile-frontend

  # Send all work to the one static backend.
  - url: "*/work/*"
    service: static-backend

部署调度文件

如需在不改变当前服务版本的情况下部署调度配置文件，请根据您的环境，在包含调度文件的目录中使用下面其中一种命令：

gcloud

gcloud app deploy dispatch.yaml

Maven

mvn appengine:deployDispatch dispatch.yaml

Gradle

gradle appengineDeployDispatch dispatch.yaml

IDE

如果您使用 IntelliJ 或 Eclipse，则可以使用部署表单来选择要部署的各个配置文件。

使用 Cloud Load Balancing 进行路由

Cloud Load Balancing 是一个单独的产品，可为在 Google Cloud 上运行的所有应用启用高级网络配置。

为无服务器应用启用 HTTP(S) 负载平衡后，您可以执行以下操作：

• 配置无服务器应用，使其通过未与其他服务共享的专用 IPv4 和/或 IPv6 IP 地址提供服务。

• 重复使用用于 Compute Engine、Google Kubernetes Engine 和 Cloud Storage 的相同 SSL 证书和私钥。这样就不需要为无服务器应用管理单独的证书。

负载平衡器不会干扰 dispatch.yaml 文件中的路由规则或与之交互。在无服务器 NEG 将流量定向到 App Engine 之前，不会评估 dispatch.yaml 规则。

注意事项：

• 我们建议您使用入站流量控制，以使应用仅接收从负载平衡器和 VPC（如果使用 VPC）发送的请求。否则，用户可以使用应用的 App Engine 网址来绕过负载平衡器、Google Cloud Armor 安全政策、SSL 证书和通过负载平衡器传递的私钥。

在开发服务器中进行路由

发现实例地址

本地开发服务器会在启动时创建所有实例。请注意，此时本地开发服务器不支持基本扩缩实例。创建的每个实例都分配有自己的端口。服务器的日志消息流中会显示端口分配。Web 客户端可以通过定位特定实例的端口与其通信。系统仅会为自动扩缩服务创建一个实例（和端口）。在服务器日志中，这一过程如下所示（请注意，服务以前称为模块）：

INFO: Module instance service-auto is running at http://localhost:37251/

系统会为手动扩缩服务的每个实例分配一个唯一的端口：

INFO: Module instance service-manual instance 0 is running at http://localhost:43190/
INFO: Module instance service-manual instance 1 is running at http://localhost:52642/

此外，还会为每个手动扩缩服务分配一个额外的端口，以便客户端可以在不指定特定实例的情况下访问服务。发送到此端口的请求会自动路由到其中一个已配置的实例：

INFO: Module instance service-manual is running at http://localhost:12361/

下表显示了如何在开发服务器和 App Engine 环境中调用这些服务：

服务	实例	开发服务器地址	App Engine 地址
service-auto	（未使用）	http://localhost:37251/	https://v1-dot-service-auto-dot-PROJECT_ID.REGION_ID.r.appspot.com/
service-manual	0	http://localhost:43190/	https://0-dot-v1-dot-service-manual-dot-PROJECT_ID.REGION_ID.r.appspot.com/

由本地开发服务器使用。如需了解详情，请参阅 Apache Maven 或 Gradle。

调度文件

运行本地开发服务器时，所有调度文件会被忽略。定位实例的唯一方法是通过这些实例的端口。

限制对服务的访问

默认情况下，所有服务都处于公开状态。如果要限制对某项服务的访问权限，请向该服务的安全限制条件添加 <role-name>admin</role-name> 元素。

有关 App Engine 网址的其他详细信息

了解网址中的地区 ID

REGION_ID 是 Google 根据您在创建应用时选择的区域分配的缩写代码。此代码不对应于国家/地区或省，尽管某些区域 ID 可能类似于常用国家/地区代码和省代码。对于 2020 年 2 月以后创建的应用，REGION_ID.r 包含在 App Engine 网址中。对于在此日期之前创建的现有应用，网址中的区域 ID 是可选的。

您可以使用以下工具查看应用的区域 ID：

控制台

在控制台中，您可以查看应用实例、服务和版本的网址。

所有这些网址都包含地区 ID。

gcloud

部署应用或服务时，gcloud app deploy 命令会在部署成功后显示网址。此网址包含地区 ID。

如需查看已部署服务的网址，请执行以下操作：

1. 输入 gcloud app versions list 命令列出特定服务的版本。例如，如需列出默认服务的版本，请输入 gcloud app versions list --service=default。

2. 输入 gcloud app versions describe 命令。该命令的输出结果包含带应用地区 ID 的版本网址。例如，如需为默认服务描述版本 20191023t101741，请输入 gcloud app versions describe 20191023t101741 --service=default。

域名包含在请求数据中

请求对应的域名包含在传递给您的应用的请求数据中。因此，您可以使用请求数据来控制您的应用如何根据请求中的域名进行响应。例如，如果您希望重定向到一个官方网域，可以在应用编码中检查 Host 请求标头，然后根据域名作出相应的响应。