Usa Apache Maven y el complemento de App Engine

Apache Maven es una herramienta de compilación automática para Java.

App Engine proporciona un complemento de Maven que puedes usar para compilar y, luego, implementar tu aplicación en App Engine. El complemento no es compatible con los proyectos del Archivo de aplicaciones empresariales (EAR).

Antes de comenzar

  1. Determina si Maven está instalado y qué versión tienes mediante la ejecución del siguiente comando:

    mvn -v
    

    Si Maven está instalado, se mostrará una string larga de información que comienza con Apache Maven y seguida de un número de versión como 3.5.

  2. Si no tienes instalado Maven 3.5 o una versión más reciente, haz lo siguiente:

    1. Descarga Maven 3.5 o posterior.
    2. Instala Maven 3.5 o una versión más reciente.
  3. Si aún no lo hiciste, sigue los pasos de la Guía de inicio rápido para descargar el SDK de Cloud, crear tu proyecto de Cloud y, luego, inicializar tu aplicación de App Engine.

  4. Instala el componente app-engine-java del SDK de Cloud:

    gcloud components install app-engine-java
    

Agrega el complemento de Maven de App Engine

Para usar el complemento de App Engine Maven, agrega las siguientes líneas a la sección plugins en el archivo pom.xml de tu proyecto:

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

Compila e implementa tu aplicación

Después de agregar el complemento de Maven de App Engine al archivo pom.xml de tu proyecto, puedes usar el comando siguiente para compilar la app:

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

Reemplaza PROJECT_ID por el ID de tu proyecto de Cloud. Si tu archivo pom.xml ya especifica tu ID del proyecto, no necesitas incluir la propiedad -Dapp.deploy.projectId en el comando que ejecutas.

El objetivo package compila y empaqueta tu app, y el objetivo appengine:deploy hace lo siguiente:

  1. Genera un ID de versión único para la nueva versión de tu app.

  2. Implementa la nueva versión en App Engine.

  3. Enruta todo el tráfico a la nueva versión.

Cambia los valores predeterminados de la implementación

Puedes cambiar el comportamiento de implementación predeterminada si pasas parámetros en el comando appengine:deploy. Por ejemplo, el siguiente comando implementa el servicio definido en tu archivo pom.xml en un proyecto específico de Google Cloud, asigna un ID de versión personalizado al servicio y desactiva el enrutamiento de tráfico automático para la versión nueva:

mvn appengine:deploy -Dapp.deploy.projectId=PROJECT_ID -Dapp.deploy.version=VERSION_ID -Dapp.deploy.promote=False

También puedes usar el comando appengine:deploy para implementar archivos de configuración, como cron.yaml, dispatch.yaml y index.yaml.

Para obtener más información, consulta la referencia appengine:deploy.

Qué sigue