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. Sie sollten auch eine Migration zu Cloud Run in Betracht ziehen, der neuesten Entwicklung von Google Cloud Serverless. Cloud Run wurde zur Verbesserung der Nutzererfahrung von App Engine entwickelt. Es beinhaltet viele der besten Features sowohl der Standardumgebung als auch der flexiblen Umgebung. Einen Vergleich von Features und Informationen zur Migration finden Sie im Vergleichsleitfaden für App Engine und Cloud Run.

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 11 oder Java 17:

Diese Laufzeiten sind unterstützte Java-Versionen. So führen Sie ein Upgrade auf die neueste Supportversion durch:
- Zum Aktualisieren der Datei app.yaml geben Sie die Version von Java an, die von der Anwendung ausgeführt werden soll. Beispiel:
```
  runtime: javaVERSION
```
  Dabei ist VERSION die MAJOR-Versionsnummer.
  
  Beispiel: Geben Sie für Java 21 die Zahl 21 wie runtime: java21 an. Weitere Informationen finden Sie in der Übersicht zur Java-Laufzeit.
- 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 geringfügige 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 mit Java EE6 und höher abwärtskompatibel. 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 unter 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:

Ä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>

Benennen Sie die Anwendungs-Servlets und -Abhängigkeiten 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 {
    ......

Aktualisieren Sie je nach Jakarta-Namespace die verbleibenden Anwendungs-Drittanbieter-Abhängigkeiten auf neuere Java-Artefakte.
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. Fügen Sie das Attribut appengine.use.virtualthreads im Tag system-properties ein, um virtuelle Threads zu aktivieren. Beispiel: <property name="appengine.use.virtualthreads" value="true"/>