服务的每个版本都在 .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 参考文档部分进行了说明。
默认服务
每个应用都有一项默认服务。您可以在 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 客户端在为服务指定网址时无需将此类元素添加到网址路径之前。