将 App Engine Gradle 插件添加到项目后,您可以使用以下 App Engine 特定的 Gradle 任务:
任务 | 说明 |
---|---|
tasks |
显示已安装任务的帮助信息。 |
appengineStage |
生成用于部署的应用目录。 |
appengineDeploy |
暂存应用并将其部署到 App Engine。 |
appengineDeployCron |
将 cron.yaml 配置文件部署到 App Engine。 |
appengineDeployDispatch |
将 dispatch.yaml 配置文件部署到 App Engine。 |
appengineDeployDos |
将 dos.yaml 配置文件部署到 App Engine。 |
appengineDeployIndex |
将 index.yaml 配置文件部署到 App Engine。 |
appengineDeployQueue |
将 queue.yaml 配置文件部署到 App Engine。 |
jettyRun |
使用 Jetty 的默认配置运行开发服务器。如需详细了解 Gretty 插件,请参阅 Gretty 配置和 Gretty 任务。 |
要查看所有任务的列表,请运行以下命令:
gradle tasks
如需详细了解如何设置和使用 Gradle,请参阅使用 App Engine Gradle 和 GitHub 上的 app-gradle-plugin
代码库。
任务属性
gradle.build
文件的内容是描述构建的一组规则。它是基于 Groovy 语言用网域特定的语言编写的,用于描述构建作业。
每个任务都具有可供您使用的如下相关属性。您可以使用配置闭包、任务和属性,在 gradle.build
文件中指定这些属性。
在此示例中:
- 插件的配置闭包是
appengine
。 - 任务是
deploy
。 - 属性
stopPreviousVersion
和promote
设置为true
。
appengine.deploy.stopPreviousVersion = true
有关每项任务的可用属性列表,请参阅以下部分。
appengineStage
task(stage)
生成用于部署的应用目录。由 appengineDeploy
任务和 jettyRun
任务使用。
您可以使用以下属性:
属性 | 说明 |
---|---|
artifact |
包含所有类、资源和清单的构建作业工件。
默认为 build/libs/[YOUR_SERVLET].war 。
|
appEngineDirectory |
app.yaml 文件的位置。默认为 src/main/appengine 。 |
dockerDirectory |
Dockerfile 的位置。默认为 src/main/docker 。
|
stagingDirectory |
必需。要暂存应用的目录。默认值为 build/staged-app 。
|
appengineDeploy
task(deploy)
暂存应用并将其部署到 App Engine。
每个任务都具有可供您使用的如下相关属性。您可以使用配置闭包、任务和属性,在 gradle.build
文件中指定这些属性。
在以下示例中:
- 插件的配置闭包是
appengine
。 - 任务是
run
。 - 属性
port
设置为8080
。
如果您只需指定少数几项属性,则可以将它们设置为一行:
appengine.run.port = 8888
属性 | 说明 |
---|---|
appEngineDirectory |
.yaml 配置文件(Cron、索引等)的位置,用于配置特定部署(appengineDeployCron 等)。对于柔性环境的应用,默认为 src/main/appengine 。 |
bucket |
用于暂存与部署关联的文件的 Cloud Storage 存储桶。如果未指定此参数,则使用应用的默认存储桶。 |
deployables |
要部署的服务或配置的 YAML 文件。
默认为暂存目录中的 app.yaml 文件。如果找不到此文件,则尝试在暂存目录中自动生成必要的配置文件(例如 app.yaml )。 |
imageUrl |
使用特定的 Docker 映像进行部署。Docker 网址必须来自一个有效的 Artifact Registry 主机名。 |
project |
用于此调用的 Google Cloud Platform 项目名称。
默认值是初始化 gcloud 工具时选择的当前项目。 如需进行验证,请使用 gcloud config list project 。 |
promote |
提升已部署的版本以接收所有流量。默认值为 True。 |
server |
要连接的 App Engine 服务器。您通常不需要更改此值。 |
stopPreviousVersion |
在部署接收所有流量的新版本时,停止以前运行的版本。 |
version |
将由此部署创建或替换的应用版本。如果您未指定版本,系统会为您生成一个版本。 |
全局属性
属性 | 说明 |
---|---|
tools.cloudSdkHome |
可选属性,用于配置Google Cloud CLI 的位置。
通常情况下,当插件与 gcloud components install app-engine-java 一起安装时,插件会在 gcloud CLI 中找到它。 |