Vorhandene Anwendung aktualisieren

Sie müssen Ihre Anwendungen auf die neueste unterstützte Laufzeitversion aktualisieren, um weiterhin Sicherheitsupdates zu erhalten und Anspruch auf technischen Support zu haben.

Das Upgradeprozess einer vorhandenen Anwendung hängt von der Laufzeitversion ab, die Ihre Anwendung derzeit verwendet:

  • Java 8: Sie müssen Ihre App zur neuesten unterstützten Java-Version migrieren. Java 8 hat das Ende des Supports am 31. Januar 2024 erreicht. Ihre vorhandenen Java 8-Anwendungen werden weiterhin ausgeführt und erhalten Traffic. Sie können jedoch keine neuen Anwendungen bereitstellen oder vorhandene Anwendungen aktualisieren, die Laufzeiten verwenden, für die der Support abgelaufen ist.

  • Java-Laufzeiten der zweiten Generation (nach Ende der Unterstützung): Wenn Sie ein Upgrade auf eine unterstützte Java-Version durchführen möchten, gehen Sie so vor:

    • Aktualisieren Sie die app.yaml-Datei, indem Sie eine Java-Version angeben, mit der Ihre App ausgeführt werden soll. Beispiel:

        runtime: javaVERSION
      

      Dabei ist VERSION die MAJOR-Versionsnummer. Wenn Sie beispielsweise die neueste Java-Version (Java 21) verwenden möchten, geben Sie 21 an. Weitere Informationen finden Sie in der Java-Laufzeitübersicht.

    • Wenn Sie gebündelte Legacy-Dienste verwenden, müssen Sie Ihre Anwendungen aktualisieren, dass sie auf einem der Folgenden ausgeführt werden:

      • Java Enterprise Edition 10 (EE10 – Standard, empfohlen): Java EE10 unterstützt keine javax.servlet.* APIs und erfordert die Aktualisierung Ihrer Anwendungen und Drittanbieterabhängigkeiten, um neuere Java-Artefakte wie Namespace Jakarta zu verwenden.

      • Java Enterprise Edition 8 (EE8): Mit Java EE8 können Sie javax.servlet.* APIs verwenden. Sie müssen jedoch kleinere Konfigurationsänderungen an der Datei appengine-web.xml vornehmen.

        Alle Optionen finden Sie unter Upgrade auf Java 21 für gebündelte Legacy-Dienste.

  • Java 17:

    Diese Version wird von der App Engine unterstützt. So führen Sie ein Upgrade auf die neueste unterstützte Version durch:

    • Aktualisieren Sie die Datei app.yaml, indem Sie eine Java-Version angeben, mit der Ihre App ausgeführt werden soll. Beispiel:

        runtime: javaVERSION
      

      Dabei ist VERSION die MAJOR-Versionsnummer. Wenn Sie beispielsweise die neueste Java-Version (Java 21) verwenden möchten, geben Sie 21 an. Weitere Informationen finden Sie in der Java-Laufzeitübersicht.

    • Wenn Sie gebündelte Legacy-Dienste verwenden, müssen Sie Ihre Anwendungen aktualisieren, dass sie auf einem der Folgenden ausgeführt werden:

      • Java Enterprise Edition 10 (EE10 – Standard, empfohlen): Java EE10 unterstützt keine javax.servlet.* APIs und erfordert die Aktualisierung Ihrer Anwendungen und Drittanbieterabhängigkeiten, um neuere Java-Artefakte wie Namespace Jakarta zu verwenden.

      • Java Enterprise Edition 8 (EE8): Mit Java EE8 können Sie javax.servlet.* APIs verwenden. Sie müssen jedoch kleinere Konfigurationsänderungen an der Datei appengine-web.xml vornehmen.

      Alle Optionen finden Sie unter Upgrade auf Java 21 für gebündelte Legacy-Dienste.

Upgrade auf Java 21 für gebündelte Legacy-Dienste

Java-Laufzeitkompatibilität

In der folgenden Tabelle sehen Sie, welche Java-Versionen mit Ihren Jetty- und Servlet-Versionen kompatibel sind:

Enterprise Edition (EE) Jetty-Version Java-Version Servlet Kompatibilität
EE7 9.4 11 2.5 oder 3.1
EE7 9.4 17 2.5 oder 3.1
EE8 12 21 2.5 und höher Java EE8 ist abwärtskompatibel mit Java EE6 und höher. Weitere Informationen finden Sie unter Upgrade auf Java 21 in EE8.
EE10 12 21 6.0 empfohlen Java 21 ist standardmäßig für die Ausführung von EE10 konfiguriert. Wenn Sie Java EE10 verwenden möchten, müssen Sie die Servlets und Abhängigkeiten Ihrer Anwendung so aktualisieren, dass der Jakarta-Namespace enthalten ist. Weitere Informationen finden Sie unter Java 21 in EE10 upgraden.

Upgrade auf Java 21 in EE10

Wenn Sie Java 21 in Enterprise Edition 10 (EE10) verwenden möchten, müssen Sie die Servlets und Abhängigkeiten Ihrer Anwendung in Ihren Maven- und Gradle-Dateien so aktualisieren, dass der Namespace Jakarta enthalten ist:

  1. Ändern Sie die Versionsnummer in der Konfigurationsdatei web.xml in version=6.0. Beispiel:

        <web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"
          version="6.0">
          ...
        </web-app>
    
  2. Benennen Sie die Servlets und Abhängigkeiten Ihrer Anwendung von javax.servlet.* in jakarta.servlet.* um:

         import jakarta.servlet.ServletException;
         import jakarta.servlet.annotation.WebServlet;
         import jakarta.servlet.http.Cookie;
         import jakarta.servlet.http.HttpServlet;
         import jakarta.servlet.http.HttpServletRequest;
         import jakarta.servlet.http.HttpServletResponse;
    
         @WebServlet(name = "viewer", urlPatterns = {"/view"})
         public class MyServlet extends HttpServlet {
        ......
    
  3. Aktualisieren Sie je nach Jakarta-Namespace die verbleibenden Anwendungs-Drittanbieter-Abhängigkeiten auf neuere Java-Artefakte.

  4. Optional: Java 21 unterstützt virtuelle Threads. Wenn Sie virtuelle Threads aktivieren möchten, fügen Sie der Datei appengine-web.xml das Attribut appengine.use.virtualthreads im Tag system-properties hinzu.

Upgrade auf Java 21 in EE8

Sie können javax.servlet.* APIs unter Java EE 8 weiterhin ohne größere Änderungen an der Anwendungskonfiguration verwenden, da Jetty 12 rückwärtskompatibel mit Java EE 6 und höher ist. Zur Ausführung Ihrer Anwendungen auf Java EE8 müssen Sie ein neues system-properties-Tag in Ihrer appengine-web.xml-Datei mit dem nicht standardmäßigen app.engine.use.EE8 Konfiguration deklarieren.:

   <?xml version="1.0" encoding="utf-8"?>
   <appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
      <runtime>java21</runtime>
      <system-properties>
        <property name="appengine.use.EE8" value="true"/>
      </system-properties>
      <app-engine-apis>true</app-engine-apis>
   </appengine-web-app>

Optional: Java 21 unterstützt virtuelle Threads. Wenn Sie virtuelle Threads aktivieren möchten, fügen Sie die Eigenschaft appengine.use.virtualthreads in das Tag system-properties ein. Beispiel: <property name="appengine.use.virtualthreads" value="true"/>