上传和管理 Java 应用程序
上传到 Google App Engine
Eclipse Google 插件为 Eclipse 工具栏添加了几个按钮。使用“App Engine 部署”按钮可将应用程序上传到 App Engine:
在第一次上传应用程序之前,必须使用管理控制台注册一个 App Engine 的应用程序 ID。注册应用程序 ID,然后编辑 appengine-web.xml
文件并将 <application>...</application>
元素更改为包含新 ID。
在您点击“App Engine 部署”按钮后,Eclipse 将提示您输入管理员帐户用户名(您的电子邮件地址)和密码。输入您的帐户信息然后点击上传按钮,完成上传。Eclipse 将从 appengine-web.xml
文件获取应用程序 ID 和版本信息,并上传 war/
目录的内容。
通过访问应用程序的网址,在 App Engine 上测试应用程序:
http://<your application ID>.appspot.com/guestbook
App Engine Java SDK 含有用于和 App Engine 交互的命令。可使用该命令将您的应用程序的新版本代码、配置和静态文件上传到 App Engine。还可使用该命令来管理数据存储区索引以及下载日志数据。
上传应用程序
如果您使用的是 Eclipse 和 Google 插件,则可直接从 Eclipse 内上传您的应用程序。要上传应用程序,请点击工具栏上的 App Engine 部署按钮:。有关详细信息,请参阅 Google Eclipse 插件。
还可从命令提示符上传您的应用程序。要使用该命令的其他功能(如下载日志),则必须从命令提示符运行命令。用于运行的命令位于 SDK 的 appengine-java-sdk/bin/
目录中。
如果您使用的是 Windows 系统,则命令如下:
appengine-java-sdk/bin/appcfg.cmd [options] <action> <war-location>
如果您使用的是 Mac OS X 或 Linux 系统,则命令如下:
./appengine-java-sdk/bin/appcfg.sh [options] <action> <war-location>
该命令采用要执行的操作的名称和您的应用程序的 WAR 目录位置作为参数。
要上传应用程序,请使用 update
操作,如下所示:
./appengine-java-sdk/bin/appcfg.sh update myapp/war
这些命令是操作系统特定的包装脚本,可运行 appengine-java-sdk/lib/appengine-tools-api.jar
中的 Java 类 com.google.appengine.tools.admin.AppCfg
。
更新索引
当使用 update
操作上传应用程序时,更新将包括应用程序索引配置(datastore-indexes.xml
文件和 generated/datastore-indexes-auto.xml
文件)。如果索引配置定义了 App Engine 上还不存在的索引,则 App Engine 将创建此新索引。创建索引可能需要一些时间,时间长短取决于数据存储区中已存在的需要编入新索引的数据量。如果应用程序执行需要索引的查询但该索引还未构建完成,则该查询将引发异常。
要防止出现该问题,您必须确保在索引构建完成之前,要求新索引的应用程序的新版本不是应用程序的活动版本。其中一种做法是,每当您在配置中添加或更改索引时,即在 appengine-web.xml
中为应用程序指定一个新版本号。应用程序将以新版本上传,不会自动变成默认的版本。当您的索引已完成构建时,可使用管理控制台的“版本”部分将默认版本更改为新版本。
确保新索引在新的应用程序启用之前已构建的另一种方法是,在上传应用程序之前单独上传索引配置。要仅上传应用程序的索引配置,请使用 update_indexes
操作:
./appengine-java-sdk/bin/appcfg.sh update_indexes myapp/war
可从管理控制台的“索引”部分检查应用程序索引的状态。
管理计划任务
App Engine 支持计划任务(又称 cron job)。可在名为 cron.xml
的文件中指定这些任务,然后使用 update_cron
命令将其上传:
./appengine-java-sdk/bin/appcfg.sh update_cron myapp/war
在文件存在的情况下,appcfg update
也将上传 cron job 说明。有关 cron job 的详细信息,请参阅 Cron Job 文档。
下载日志
App Engine 将维护您的应用程序发出的消息的日志。App Engine 还将在日志中记录每个请求。您可从管理控制台的“日志”部分浏览应用程序的日志。
如果您希望对应用程序的日志执行详细分析,可将日志数据下载到您的计算机上的文件中。要将日志下载到名为 mylogs.txt
的文件中,请使用 request_logs
操作,如下所示:
./appengine-java-sdk/bin/appcfg.sh request_logs myapp/war mylogs.txt
默认情况下,该命令将下载从当前日历日(自太平洋时间午夜零点起)开始的 INFO 或更高日志级别(省略 DEBUG 级别的消息)的日志消息。该命令还将覆盖本地的日志文件。可使用命令行选项调整天数、最小日志级别以及是覆盖本地日志文件还是附加到本地日志文件。有关这些选项的详细信息,请参见下文。
命令行参数
AppCfg 命令采用一组选项、一个操作以及操作参数。
有以下操作可选:
-
为指定了应用程序根目录的应用程序上传文件。应用程序 ID 和版本是从
appengine-web.xml
文件获取的。 -
撤消指定应用程序完成的部分更新。如果更新中断并且命令报告由于锁定而无法更新应用程序,则可以使用此操作。
-
更新 App Engine 中的数据存储区索引以包括新添加的索引。如果新版本的应用程序需要添加到索引配置的额外索引定义,您可在上传新版本的应用程序之前在 App Engine 中更新索引配置。在上传新版本的应用程序之前几个小时运行该操作,可给予索引进行构建的时间并在部署应用程序时提供服务。
-
检索 App Engine 上运行的应用程序的日志数据。
output-file
是要创建或替换的文件的名称。如果output-file
为连字符 (-
),则日志数据将打印到控制台。以下选项适用于request_logs
:-
要检索的日志数据的天数(结束时间为国际协调时间当前日期的午夜)。0 值会检索所有可用日志。如果
--append
已指定,则默认为 0,否则默认为 1。 -
要检索的日志消息的最低日志级别。该值是一个与日志级别相对应的数字:4 表示“严重”,3 表示“错误”,2 表示“警告”,1 表示“信息”,0 表示“调试”。指定日志级别及更高级别的所有消息都会被检索。默认为 1(信息)。
--num_days=...
--severity=...
-
-
打印有关指定操作的帮助消息,然后退出。
appcfg.sh [options] update <war-location>
appcfg.sh [options] rollback <war-location>
appcfg.sh [options] update_indexes <war-location>
appcfg.sh [options] request_logs <war-location> <output-file>
appcfg.sh [options] help <war-location>
AppCfg 命令对所有操作接受以下选项:
-
应用程序管理员的 Google 帐户的电子邮件地址,适用于需要登录的操作。如果忽略了该值且以前使用该命令时未存储 cookie,则该命令会提示输入。
-
App Engine 服务器主机名。默认为
appengine.google.com
。 -
用于与远程过程调用配合使用的本地计算机的主机名。
-
指向 App Engine Java SDK 的路径(如果其位置不同于工具的位置)。
-
请勿将管理员登录凭证存储为 cookie;每次登录时都提示输入密码。
--email=...
--server=...
--host=...
--sdk_root=...
--passin