Volver a empaquetar un archivo WAR en un archivo JAR

Si vas a migrar a la versión de Java más reciente compatible y tu aplicación no usa servicios antiguos incluidos, debes volver a empaquetar tu aplicación web de Java 8 de App Engine en un archivo JAR ejecutable.

Tu aplicación debe tener una clase Main que inicie un servidor web que responda a las solicitudes HTTP en el puerto 8080, que puede especificarse mediante la variable de entorno PORT.

Por ejemplo:

import com.sun.net.httpserver.HttpServer;
import java.io.IOException;
import java.io.OutputStream;
import java.net.InetSocketAddress;

public class Main {

  public static void main(String[] args) throws IOException {
    // Create an instance of HttpServer bound to port defined by the 
    // PORT environment variable when present, otherwise on 8080.
    int port = Integer.parseInt(System.getenv().getOrDefault("PORT", "8080"));
    HttpServer server = HttpServer.create(new InetSocketAddress(port), 0);

    // Set root URI path.
    server.createContext("/", (var t) -> {
      byte[] response = "Hello World from Google App Engine Java 11.".getBytes();
      t.sendResponseHeaders(200, response.length);
      try (OutputStream os = t.getResponseBody()) {
        os.write(response);
      }
    });

    // Start the server.
    server.start();
  }
}

Ejemplo de migración de WAR (Java 11)

En las siguientes instrucciones se muestra cómo volver a empaquetar una aplicación hello-world de Java 8 de App Engine como un archivo JAR para ejecutarla en el entorno de ejecución de Java 11.

La migración usa el artefacto appengine-simple-jetty-main. Esto proporciona una clase Main con un servidor web Jetty sencillo que carga un archivo WAR y empaqueta tu aplicación en un archivo JAR ejecutable:

1. Clona el artefacto Embedded Jetty Server en tu máquina local:

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples
   

   También puedes descargar el ejemplo como un archivo ZIP y extraerlo.

2. Accede al directorio que contiene el código de muestra:

   cd java-docs-samples/appengine-java11/appengine-simple-jetty-main/
   

3. Instala la dependencia localmente:

   mvn install
   

4. Añade el siguiente código al archivo pom.xml de tu proyecto:

   • appengine-simple-jetty-main dependencia:
     <dependency>
       <groupId>com.example.appengine</groupId>
       <artifactId>simple-jetty-main</artifactId>
       <version>1</version>
       <scope>provided</scope>
     </dependency>

   • maven-dependency:
     <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-dependency-plugin</artifactId>
       <version>3.6.1</version>
       <executions>
         <execution>
           <id>copy</id>
           <phase>prepare-package</phase>
           <goals>
             <goal>copy-dependencies</goal>
           </goals>
           <configuration>
             <outputDirectory>
               ${project.build.directory}/appengine-staging
             </outputDirectory>
           </configuration>
         </execution>
       </executions>
     </plugin>

     App Engine despliega los archivos ubicados en el directorio ${build.directory}/appengine-staging. Si añades el complemento maven-dependency a tu compilación, App Engine instalará las dependencias que hayas especificado en la carpeta correcta.

5. Crea un elemento entrypoint en tu archivo app.yaml para llamar al objeto appengine-simple-jetty-main y transfiere tu archivo WAR como argumento. Por ejemplo, consulta el helloworld-servlet ejemplo app.yaml:

   runtime: java11
   entrypoint: 'java -cp "*" com.example.appengine.jetty.Main helloworld.war'

6. Para ejecutar tu aplicación de forma local, sigue estos pasos:

   1. Empaqueta tu aplicación:

      mvn clean package
      

   2. Inicia el servidor con tu archivo WAR como argumento.

      Por ejemplo, puedes iniciar el servidor en el ejemplo helloworld-servlet ejecutando el siguiente comando desde tu carpeta java-docs-samples/appengine-java11/appengine-simple-jetty-main/:

      mvn exec:java -Dexec.args="../helloworld-java8/target/helloworld.war"
      

   3. Introduce la siguiente dirección en el navegador web:

      http://localhost:8080

7. Para desplegar tu aplicación, sigue estos pasos:

   Herramientas de gcloud

   gcloud app deploy

   Plugin de Maven

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

   Sustituye PROJECT_ID por el ID de tu Google Cloud proyecto. Si tu archivo pom.xml ya especifica tu ID de proyecto, no es necesario que incluyas la propiedad -Dapp.deploy.projectId en el comando que ejecutes.