Java 运行时

Java 运行时是负责安装应用代码和依赖项，然后在柔性环境中运行该应用的软件栈。

• 11 版及更高版本使用 Buildpack 构建，要求您在 app.yaml 文件中选择操作系统。例如，如需使用 Java 21，您必须指定 Ubuntu 22 作为操作系统。

• Java 8 / Jetty 9 运行时为 OpenJDK 8 和 Eclipse Jetty 9 提供对 Java Servlet 3.1 规范的支持。Jetty 映像继承自 OpenJDK 映像。

如需查看受支持的 Java 版本及其对应的 Ubuntu 版本的完整列表，请参阅运行时支持时间表。

前提条件

如需使用 Java 运行时，请执行以下操作：

• 您必须安装 gcloud CLI 420.0.0 版或更高版本。您可以通过运行 gcloud components update 命令来更新 CLI 工具。如需查看已安装的版本，您可以运行 gcloud version 命令。

• 如需使用 Maven 进行部署，您需要将 App Engine Maven 插件添加到 pom.xml 中，如下所示：

  <plugin>
     <groupId>com.google.cloud.tools</groupId>
     <artifactId>appengine-maven-plugin</artifactId>
     <version>2.7.0</version>
  </plugin>

  您还可有 gcloud app deploy 命令或 App Engine Gradle 插件等其他部署选项。

整理文件

您的源代码树应如下所示：

MyDir/
  [pom.xml]
  [build.gradle]
  [index.yaml]
  [cron.yaml]
  [dispatch.yaml]
  src/main/
    appengine/
      app.yaml
    docker/
      [Dockerfile]
    java/
      com.example.mycode/
        MyCode.java
    webapp/
      [index.html]
      [jsp.jsp]
      WEB-INF/
        [web.xml]

选择 Java 版本

新运行时版本

对于 Java 运行时版本 11 版及更高版本，您必须在 app.yaml 文件中添加 runtime_config 和 operating_system 设置以指定操作系统。

注意：Java 11/17 运行时仅支持部署可执行 JAR 文件。 这些新版运行时不包含任何 Web 服务框架，这些框架会限制您使用基于 Servlet 的框架或库。

（可选）您可以通过在 app.yaml 文件中添加 runtime_version 设置来指定运行时版本。默认情况下，如果未指定 runtime_version 设置，则使用最新的 Java 版本。

示例

• 如需在 Ubuntu 22 上指定 Java 21，请运行以下命令：

  runtime: java
  env: flex
  
  runtime_config:
      operating_system: "ubuntu22"
      runtime_version: "21"
  

• 如需在 Ubuntu 22 上指定受支持的最新 Java 版本，请运行以下命令：

    runtime: java
    env: flex
  
    runtime_config:
        operating_system: "ubuntu22"
  

过往运行时版本

对于 Java 8，请在 app.yaml 文件中指定 runtime_config 和 jdk 设置。

Java 8 支持：

• Eclipse Jetty 9 运行时，并使用 Servlet 3.1 运行 Jetty 9。
• 您自己的服务器代码，作为应用的一部分侦听端口 8080。此功能允许您使用 SparkJava 和 Spring-Boot 等微服务框架。

示例

• 指定 Jetty 版本 9（默认 / 可选）：

    runtime_config:
      jdk: openjdk8
      server: jetty9
  

• 指定 Java 8 版：

    runtime_config:
      jdk: openjdk8
  

• Java 8 版 app.yaml 示例：

  runtime: java
  env: flex
  
  handlers:
  - url: /.*
    script: this field is required, but ignored

如需了解如何配置 Maven，请参阅 pom.xml；如需了解如何配置 Gradle，请参阅 build.gradle。

可选文件

以下配置文件为可选项：

• index.yaml

• cron.yaml

• dispatch.yaml

请将这些文件置于 MyDir 的顶层。如果要使用其中的任何文件，您必须使用 gcloud app deploy 命令对其进行单独部署。

如果您未使用 Servlet 3.x 注解，则需要可选的 web.xml。

您可以在 webapp/ 目录中放置静态 Web 内容以及 JavaServer 页面。App Engine 柔性环境使用 Jetty 9 作为其 Servlet 容器；Jetty 9 使用 Apache Jasper 作为默认 JSP 实现，并且包含 JSTL 标记库。

Dockerfile 文件是可选项，用于自定义 Java 运行时。

启用 gzip 压缩

gzip 处理程序是 Jetty 的捆绑模块，但默认情况下不会激活。如需激活此模块，请在 app.yaml 文件中设置环境变量 JETTY_MODULES_ENABLE=gzip：

env_variables:
  JETTY_MODULES_ENABLE: 'gzip'

使用快速启动

通过预扫描应用内容并生成配置文件，Jetty 可以加快应用的启动时间。 如果您使用的是扩展映像，则可以在添加应用 WAR 文件后，在 Dockerfile 中执行 /scripts/jetty/quickstart.sh 命令激活快速启动：

环境变量

您可以设置以下专用于 Java 8 / Jetty 9 运行时的可选环境变量。您也可以设置 OpenJDK 8 环境变量。

如需设置环境变量，请在 app.yaml 文件中使用 env_variables 键。

环境变量	Maven Prop	值/备注
JETTY_PROPERTIES		附加到 $JETTY_ARGS，采用 name=value 对格式的逗号分隔列表
JETTY_MODULES_ENABLE		附加到 $JETTY_ARGS，需要启用的逗号分隔模块列表
JETTY_MODULES_DISABLE		从 $JETTY_BASE/start.d 中移除，需要禁用的逗号分隔模块列表
JETTY_ARGS		传递给 Jetty 的 start.jar 文件的参数。用于自定义 Jetty 配置的任何参数都应该通过此变量传递。
JAVA_OPTS		JVM 运行时参数

增强型 Cloud Logging（Beta 版）

在 App Engine 柔性环境中运行时，您可以通过设置 JETTY_ARGS 环境变量来配置 Java Util Logging，以将日志发送到 Google Logging。例如：

 env_variables:
   JETTY_ARGS: -Djava.util.logging.config.file=WEB-INF/logging.properties

您必须提供一个以如下方式配置 LoggingHandler 对象的 logging.properties 文件：

handlers=com.google.cloud.logging.LoggingHandler

# Optional configuration
.level=INFO
com.google.cloud.logging.LoggingHandler.level=FINE
com.google.cloud.logging.LoggingHandler.log=gae_app.log
com.google.cloud.logging.LoggingHandler.formatter=java.util.logging.SimpleFormatter
java.util.logging.SimpleFormatter.format=%3$s: %5$s%6$s

本地测试

当您在本地环境进行测试时，可以使用模拟的 Google Cloud 服务，而非远程 Google Cloud 服务。您可以使用的模拟器包括：

• Datastore

• Pub/Sub

• Bigtable

在运行应用之前，请使用 gcloud 命令启动它们：

gcloud beta emulators datastore start
gcloud beta emulators pubsub start
gcloud beta emulators bigtable start

Maven

在 maven pom.xml 文件中插入以下配置行，以添加 Jetty 9 Maven 插件：

<plugin>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>jetty-maven-plugin</artifactId>
  <version>9.4.2.v20170220</version>
</plugin>

如需在本地运行您的应用，请使用 Maven 命令：

mvn jetty:run-exploded

Gradle

按照创建新的 Gradle 项目中的说明，将 Gretty Gradle 插件添加到 build.gradle 文件，然后使用以下命令：

gradle jettyRun

部署应用

如需初始化 Google Cloud CLI，请运行以下命令：

gcloud init

完成配置后，您可以运行以下命令，使用 Google Cloud CLI 部署包含 app.yaml 和 WAR 文件的目录：

gcloud app deploy app.yaml

如果您使用了可选的配置文件（index.yaml、cron.yaml 和 dispatch.yaml），请务必使用 gcloud 命令单独对其进行部署。例如：

gcloud app deploy cron.yaml

Maven

使用 Maven 部署应用：

mvn package appengine:deploy -Dapp.deploy.projectId=PROJECT_ID

将 PROJECT_ID 替换为您的 Google Cloud 项目的 ID。 如果您的 pom.xml 文件已经指定了您的项目 ID，则您无需在运行的命令中添加 -Dapp.deploy.projectId 属性。

Gradle

使用 Gradle 部署应用：

gradle appengineDeploy

自定义 Java 8 / Jetty 9 运行时

您不需要 Dockerfile 文件，就可以将应用部署到 Java 8 / Jetty 9 运行时。 不过，如果您的应用需要额外配置，您可以明确提供一个 Dockerfile 文件，在其中自定义 Java 运行时。请注意，Dockerfile 文件必须包含基本映像。您可以将其他指令添加到 Dockerfile 文件，以自定义 Java 运行时。请参阅构建自定义运行时。

在这种情况下，your-application.war 是 target/ 目录 (maven) 或 build/staged-app/ (gradle) 目录中构建的 WAR 文件的名称。