Die Java 8-/Jetty 9-Laufzeit

Die Java 8-/Jetty 9-Laufzeit bietet OpenJDK 8 und Eclipse Jetty 9 mit Unterstützung für die Java Servlet 3.1-Spezifikation. Informationen zur spezifischen Jetty-Version in dieser Laufzeit finden Sie unter Jetty-Attribute im GitHub-Projekt für das Laufzeit-Image.

Vorbereitung

Laden Sie die neueste Version der Google Cloud CLI herunter oder aktualisieren Sie Ihre gcloud CLI auf die aktuelle Version:
```
gcloud components update
```
Für die Bereitstellung mithilfe von Maven müssen Sie das App Engine-Maven-Plug-in in pom.xml aufnehmen:
```
<plugin>
   <groupId>com.google.cloud.tools</groupId>
   <artifactId>appengine-maven-plugin</artifactId>
   <version>2.7.0</version>
</plugin>
```
Die Bereitstellung ist außerdem über den Befehl gcloud app deploy oder das Gradle-Plug-in für App Engine möglich.

Dateien organisieren

Der Quellbaum sollte so aussehen:

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]

`app.yaml`

Eine app.yaml-Datei ist erforderlich. Definieren Sie eine Datei, die so aussieht:

flexible/helloworld/src/main/appengine/app.yaml

Auf GitHub ansehen

runtime: java
env: flex

handlers:
- url: /.*
  script: this field is required, but ignored

Das Laufzeit-Image gcr.io/google-appengine/jetty wird automatisch ausgewählt, wenn Sie eine WAR-Datei (*.war) bereitstellen.

Wenn Sie dieses Image als Basis für eine benutzerdefinierte Laufzeit verwenden möchten, können Sie runtime: custom in Ihrer app.yaml-Datei angeben und dann das Dockerfile so schreiben:

FROM gcr.io/google-appengine/jetty
ADD your-application.war $APP_DESTINATION

Durch diese Zeilen wird die WAR-Datei am richtigen Speicherort für den Docker-Container hinzugefügt.

Andere app.yaml-Einstellungen werden unter app.yaml verwenden beschrieben.

Die Datei pom.xml dient zur Konfiguration von Maven, build.gradle zur Konfiguration von Gradle.

Optionale Dateien

Die folgenden Konfigurationsdateien sind optional:

Platzieren Sie diese Dateien auf der obersten Ebene von MyDir. Wenn Sie diese Dateien verwenden, müssen Sie sie separat mit dem Befehl gcloud app deploy bereitstellen.

Die Datei web.xml ist optional und wird nur benötigt, wenn Sie keine Servlet 3.x-Anmerkungen verwenden.

Sie können statische Webinhalte sowie Ihre JavaServer-Seiten in Ihrem webapp/-Verzeichnis ablegen. Die flexible Umgebung von App Engine verwendet als Servlet-Container Jetty 9, das wiederum Apache Jasper als Standard-JSP-Implementierung verwendet und JSTL-Taglibs umfasst.

Die Dockerfile-Datei ist optional und wird zum Anpassen der Java-Laufzeit verwendet.

gzip-Komprimierung aktivieren

Der Handler für gzip wird zusammen mit Jetty bereitgestellt, ist aber standardmäßig nicht aktiviert. Um dieses Modul zu aktivieren, legen Sie die Umgebungsvariable JETTY_MODULES_ENABLE=gzip in der Datei app.yaml fest:

env_variables:
  JETTY_MODULES_ENABLE: 'gzip'

Schnellstart verwenden

Jetty kann den Start Ihrer Anwendung beschleunigen, wenn der Inhalt vorab gescannt wird und Konfigurationsdateien erzeugt werden. Wenn Sie ein erweitertes Image verwenden, können Sie den Schnellstart aktivieren, indem Sie /scripts/jetty/quickstart.sh in Ihrem Dockerfile ausführen, nachdem die Anwendungs-WAR hinzugefügt wurde.

FROM launcher.gcr.io/google/jetty
ADD your-application.war $JETTY_BASE/webapps/root.war

# generate quickstart-web.xml
RUN /scripts/jetty/quickstart.sh

Umgebungsvariablen

Sie können die folgenden optionalen Umgebungsvariablen festlegen, die für die Java 8-/Jetty 9-Laufzeit spezifisch sind. Sie können auch OpenJDK 8-Umgebungsvariablen festlegen.

Zum Festlegen von Umgebungsvariablen verwenden Sie den Schlüssel env_variables in der Datei app.yaml.

Umgebungsvariable	Maven-Eigenschaft	Wert/Kommentar
`JETTY_PROPERTIES`		Kommagetrennte Liste von `name=value` Paaren, die an `$JETTY_ARGS` angehängt sind
`JETTY_MODULES_ENABLE`		Kommagetrennte Liste der Module, die durch Anhängen an `$JETTY_ARGS` aktiviert werden sollen
`JETTY_MODULES_DISABLE`		Kommagetrennte Liste der Module, die durch Entfernen aus `$JETTY_BASE/start.d` deaktiviert werden sollen
`JETTY_ARGS`		Argumente, die an `start.jar` von Jetty übergeben werden. Alle für die benutzerdefinierte Jetty-Konfiguration verwendeten Argumente sollten hier übergeben werden.
`JAVA_OPTS`		JVM-Laufzeitargumente

Erweitertes Cloud-Logging (Betaversion)

Beim Ausführen in der flexiblen App Engine-Umgebung können Sie Javautil Logging so konfigurieren, dass Logs an Cloud Logging gesendet werden, indem Sie die Umgebungsvariable JETTY_ARGS festlegen. Beispiel:

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

Sie müssen eine logging.properties-Datei bereitstellen, mit der ein LoggingHandler konfiguriert wird:

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

Lokales Testen

Wenn Sie Tests in der lokalen Umgebung durchführen, können Sie anstelle der Remote-Clouddienste von Google emulierte Clouddienste von Google nutzen. Sie können die folgenden Emulatoren verwenden:

Verwenden Sie den Befehl gcloud, um sie zu starten, bevor Sie die Anwendung ausführen:

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

Maven

Fügen Sie diese Zeilen in die Maven-Datei pom.xml ein, um das Jetty 9-Maven-Plug-in hinzuzufügen:

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

Verwenden Sie den Maven-Befehl, um Ihre Anwendung lokal auszuführen:

mvn jetty:run-exploded

Gradle

Gehen Sie so vor, wie in der Anleitung Neues Gradle-Projekt erstellen beschrieben, um das Gretty-Gradle-Plug-in in Ihre Datei build.gradle aufzunehmen. Verwenden Sie den folgenden Befehl:

gradle jettyRun

Anwendung bereitstellen

Führen Sie zum Initialisieren der Google Cloud CLI Folgendes aus:

gcloud init

Nachdem Sie die Konfigurationen abgeschlossen haben, können Sie das Google Cloud CLI verwenden, um dieses Verzeichnis mit den app.yaml- und WAR-Dateien so bereitzustellen:

gcloud app deploy app.yaml

Wenn Sie eine der optionalen Konfigurationsdateien (index.yaml, cron.yaml und dispatch.yaml) verwenden, stellen Sie sie mit dem Befehl gcloud separat bereit. Beispiel:

gcloud app deploy cron.yaml

Maven

Verwenden Sie Maven zum Bereitstellen der Anwendung:

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

Ersetzen Sie PROJECT_ID durch die ID Ihres Cloud-Projekts. Wenn in der Datei pom.xml bereits Ihre Projekt-ID angegeben ist, müssen Sie das Attribut -Dapp.deploy.projectId nicht in dem von Ihnen ausgeführten Befehl einfügen.

Gradle

Verwenden Sie Gradle zum Bereitstellen Ihrer Anwendung:

gradle appengineDeploy

Java 8-/Jetty 9-Laufzeit anpassen

Sie brauchen kein Dockerfile, um Ihre Anwendung in der Java 8-/Jetty 9-Laufzeit zu implementieren. Wenn Ihre Anwendung eine zusätzliche Konfiguration erfordert, können Sie zum Anpassen der Java-Laufzeit explizit ein Dockerfile bereitstellen. Das Dockerfile muss das Basis-Image gcr.io/google-appengine/jetty enthalten. Sie können dem Dockerfile zusätzliche Anweisungen hinzufügen, um die Java-Laufzeit anzupassen. Siehe Benutzerdefinierte Laufzeiten erstellen.

Ihr Dockerfile sollte folgendermaßen beginnen:

FROM gcr.io/google-appengine/jetty
ADD your-application.war $APP_DESTINATION
# YOUR DOCKER COMMANDS

In diesem Fall ist your-application.war der Name der erstellten WAR-Datei in Ihrem target/-Verzeichnis (Maven) oder build/staged-app/ (Gradle).