配置文件

服务的每个版本都在 .yaml 文件中定义，此文件提供相应服务和版本的名称。YAML 文件通常与其定义的服务同名，但这不是必需的。如果您要部署一项服务的多个版本，则可以在同一目录中创建多个 yaml 文件，每个文件对应一个版本。

通常，您可以为每项服务创建一个目录，以包含相应服务的 YAML 文件和关联的源代码。可选的应用级配置文件（dispatch.yaml、cron.yaml、index.yaml 和 queue.yaml）包含在顶级应用目录中。以下示例展示了三项服务。在 service1 和 service2 中，源文件与 YAML 文件处于同一级别。在 service3 中，有两个版本的 YAML 文件。

对于小型简单项目，应用的所有文件都可以位于一个目录中：

每个 YAML 文件都必须包含版本参数。如需定义默认服务，您可以在文件中明确声明参数 service: default 或者不作声明。

每项服务的配置文件都定义了特定服务/版本的扩缩类型和实例类别。使用的扩缩参数取决于您指定的扩缩类型。如果未指定扩缩类型，则默认为自动扩缩。appengine-web.xml 参考文档部分介绍了扩缩和实例类别设置。

对于每项服务，您还可以指定相应设置，以将网址请求映射到特定脚本以及识别静态文件，进而提高服务器效率。这些设置也包含在 yaml 文件中，并在 appengine-web.xml 参考文档部分进行了说明。

default 服务

每个应用都有一项默认服务。您可以在 appengine-web.xml 中使用 service: default 设置定义默认服务，但并不强制要求这样做。与服务相关的所有配置参数都可以应用于默认服务。

可选配置文件

以下配置文件可以对应用于应用中所有服务的可选功能进行控制：

• dispatch.yaml 可以凌越路由默认规则，方法是根据网址中的路径或主机名将传入的请求发送到特定服务。
• queue.yaml 配置推送队列和拉取队列。
• index.yaml 指定使用 Datastore 查询时您的应用需要哪些索引。
• cron.yaml 配置在规定的时间或按固定时间间隔运行的计划任务。

要将这些配置文件的更新部署到 App Engine，请从这些文件所在的目录中运行以下命令：

    gcloud app deploy [CONFIG_FILE]

示例

以下示例演示了如何为拥有两项服务的应用配置各种 WAR 目录结构的文件：一项服务为处理 Web 请求的默认服务，另一项为用于后端处理的服务（名为 my-service）。

假设顶级 EAR 目录是“my-application”，请定义文件 my-application/META-INF/appengine-application.xml：

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<appengine-application xmlns="http://appengine.google.com/ns/1.0">
  <application>my-application</application>
</appengine-application>

为 my-application/default 和 my-application/my-service 这两个服务创建 WAR 目录。

现在，在每个指定服务参数的 WAR 文件中创建一个 appengine-web.xml 文件。该文件必须包含该服务的版本名称。如需定义默认服务，您可以在文件中明确声明参数 <service>default</service> 或者不作声明。以下是定义默认服务的文件 my-application/default/WEB-INF/appengine-web.xml：

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <application>my-application</application>
  <module>default</module>
  <version>uno</version>
  <threadsafe>true</threadsafe>
</appengine-web-app>

文件 my-application/my-service/WEB-INF/appengine-web.xml 定义将处理后台请求的服务：

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <application>my-application</application>
  <module>my-service</module>
  <version>uno</version>
  <threadsafe>true</threadsafe>
  <manual-scaling>
    <instances>5</instances>
  </manual-scaling>
</appengine-web-app>

最后，定义用于枚举服务的文件 my-application/META-INF/application.xml。请注意，默认服务应该是列出的首项服务。

<?xml version="1.0"
encoding="UTF-8"?>

<application
  xmlns="http://java.sun.com/xml/ns/javaee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
                      http://java.sun.com/xml/ns/javaee/application_5.xsd"
  version="5">

  <description>GAE Java SuperFun app</description>
  <display-name>SuperFun</display-name>

  <!-- Services -->
  <!-- The default service should be listed first -->
  <module>
    <web>
      <web-uri>default</web-uri>
      <context-root>default</context-root>
    </web>
  </module>
  <module>
    <web>
      <web-uri>my-service</web-uri>
      <context-root>my-service</context-root>
    </web>
  </module>

</application>

App Engine 将忽略 <context-root> 元素，因此 HTTP 客户端在为服务指定网址时无需将此类元素添加到网址路径之前。