App Engine 概览

地区 ID

REGION_ID 是 Google 根据您在创建应用时选择的地区分配的缩写代码。此代码不对应于国家/地区或省,尽管某些地区 ID 可能类似于常用国家/地区代码和省代码。在 App Engine 网址中包含 REGION_ID.r 对于现有应用是可选项,但在不久后将成为所有新应用的必要项。

为了确保顺利过渡,我们正在逐步更新 App Engine 以使用地区 ID。如果我们尚未更新您的 Google Cloud 项目,则您不会看到应用的区域 ID。由于该 ID 对于现有应用是可选的,因此您在现有应用可以使用区域 ID 后无需更新网址或进行其他更改。

详细了解区域 ID

App Engine 应用由包含一项或多项服务的单个应用资源组成。每项服务都可以配置为使用不同的运行时和性能设置。在每项服务中,您都可以部署该服务的“版本”,而每个版本可以在一个或多个“实例”中运行,具体取决于您为它配置处理多少流量。

应用的组件

当您创建应用资源时,系统会在您的 Google Cloud 项目下创建 App Engine 应用。App Engine 应用是一个顶层容器,用于容纳构成应用的服务、版本和实例资源。当您创建 App Engine 应用时,所有的资源都将在您选择的区域中创建,包括应用代码以及一系列设置、凭据和应用的元数据。

每个 App Engine 应用至少包含一项服务,即 default 服务,这项服务可以保存许多版本,具体取决于应用的结算状态。如需了解详情,请参阅下面的限制

下图说明了运行多项服务的 App Engine 应用的层次结构。在此图中,应用具有两项包含多个版本的服务,并且其中两个版本正在多个实例上活跃运行:

应用服务、版本和实例的层次结构图

其他 Google Cloud 服务(例如 Datastore)将在您的 App Engine 应用中共享。如需了解详情,请参阅设计 Web 服务的结构

服务

使用 App Engine 中的“服务”将大型应用分解为可以安全共享 App Engine 功能并相互通信的逻辑组件。通常情况下,App Engine 服务的行为类似于微服务。因此,您可以在单项服务中运行整个应用,也可以设计并部署多项服务以作为一组微服务运行。

举例来说,用于处理客户请求的应用可以包含若干项服务,各自处理不同的任务,例如:

  • 来自移动设备的 API 请求
  • 内部的管理类请求
  • 结算流水线和数据分析等后端处理

App Engine 中的每项服务都包含来自应用的源代码以及相应的 App Engine 配置文件。部署到某服务的一组文件代表该服务的一个“版本”,每向该服务部署一次,就会在其中创建一个新的版本。

版本

通过在每项服务中包含应用的多个版本,您可以在该应用的不同版本之间快速切换,以执行回滚、测试或其他临时活动。您可以通过迁移拆分流量,将流量路由到应用的一个或多个特定版本。

实例

您可以在一个或多个“实例”上运行服务中的各个版本。默认情况下,App Engine 会扩缩您的应用资源规模,使其与负载匹配。您的应用可以增加运行实例数来保障性能,也能够缩减实例数来最大限度地减少空闲实例并降低费用。如需详细了解实例,请参阅实例的管理方式

应用请求

应用的每项服务以及这些服务中的每个版本都必须具有唯一的名称。然后您可以用这些唯一名称来确定网址,并将流量分配到对应的特定资源,例如:

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

请注意,VERSION-dot-SERVICE-dot-PROJECT_ID 的组合长度(其中 VERSION 是版本名称,SERVICE 是服务名称,PROJECT_ID 是项目 ID)不得超过 63 个字符,且首尾不能使用连字符。如果组合长度超过 63 个字符,您可能会看到错误 DNS address could not be found.

传入的用户请求将被路由到配置为处理流量的服务或版本。您还可以将请求定位并路由到特定的服务和版本。如需了解详情,请参阅处理请求

记录应用请求日志

当应用处理请求时,它还可以将自己的日志记录消息写入 stdoutstderr。如需详细了解应用的日志,请参阅写入应用日志

限制

您可以部署的服务和版本的最大数量取决于应用的价格方案:

限制 免费应用 付费应用
每个应用的服务数上限 5 105
每个应用的版本数上限 15 210

每项采用基本扩缩或手动扩缩的服务的实例数量也有限制:

每个手动/基本扩缩版本的实例数上限
免费应用 付费应用(美国) 付费应用(欧盟)
20 25(对于 us-central,则为 200) 25

应用网址中的字符数也存在限制。

说明 限制
VERSION-dot-SERVICE-dot-PROJECT_ID 网址的项目网址中的字符数上限 63