Objetivos y parámetros del complemento de Maven de App Engine

Una vez que el complemento de Maven de App Engine se agrega a tu proyecto, los siguientes objetivos de Maven específicos de App Engine estarán disponibles:

Objetivo Descripción
appengine:deploy Habilita a etapas e implementa una aplicación en App Engine.
appengine:deployCron Implementa un archivo de configuración cron.yaml en App Engine.
appengine:deployDispatch Implementa un archivo de configuración dispatch.yaml en App Engine.
appengine:deployDos Implementa un archivo de configuración dos.yaml en App Engine.
appengine:deployIndex Implementa un archivo de configuración index.yaml en App Engine.
appengine:deployQueue Implementa un archivo de configuración queue.yaml en App Engine.
appengine:help Muestra la información de ayuda en el complemento de Maven de App Engine.
appengine:stage Genera un directorio de compilación de aplicaciones para la implementación.

Para obtener más información sobre cómo configurar y usar Maven, consulta Usa Maven.

Usa parámetros

Cada objetivo tiene parámetros asociados que puedes especificar en el archivo pom.xml. Por ejemplo:

<plugins>
   <plugin>
     <groupId>com.google.cloud.tools</groupId>
     <artifactId>appengine-maven-plugin</artifactId>
     <version>2.2.0</version>
     <configuration>
       <deploy.stopPreviousVersion>true</deploy.stopPreviousVersion>
       <cloudSdkPath>/usr/foo/path/to/cloudsdk</cloudSdkPath>
     </configuration>
  </plugin>
</plugins>

También puedes definir parámetros de configuración en la línea de comandos. Si lo haces, debes seguir el patrón -D[USER_PROPERTY]=[PARAMETER_VALUE].

Por ejemplo, para especificar un directorio en el que deseas habilitar la aplicación a etapas, usa lo siguiente:

mvn appengine:stage -Dapp.stage.stagingDirectory=[YOUR_STAGING_DIRECTORY]

Consulta las siguientes secciones si deseas obtener una lista de los parámetros que están disponibles para cada objetivo.

appengine:deploy

Habilita a etapas e implementa una aplicación en App Engine.

Puedes usar los siguientes parámetros, algunos de los cuales corresponden a las marcas de línea de comandos gcloud app deploy o marcas de línea de comandos gcloud app services:

Parámetro Descripción Propiedad del usuario
appEngineDirectory El directorio que contiene app.yaml y otros archivos de configuración de App Engine compatibles. El valor predeterminado es ${basedir}/src/main/appengine. app.stage.appEngineDirectory
artifact La ubicación del archivo JAR o WAR que se implementará. El valor predeterminado es ${project.build.directory}/${project.build.finalName}.${project.packaging}. app.stage.artifact
bucket El depósito de Cloud Storage que se usa para habilitar a etapas los archivos asociados a la implementación. Si este argumento no se especifica, se usa el depósito predeterminado de la aplicación. app.deploy.bucket
cloudSdkPath Parámetro opcional para configurar la ubicación del SDK de Cloud. Según la configuración predeterminada, se descubre de forma automática a partir de la ruta de acceso o la ubicación de instalación estándar. cloudSdkPath
deployables Los archivos YAML para los servicios o las opciones de configuración que desea implementar. El valor predeterminado es el archivo app.yaml en el directorio de etapa de pruebas. Si no se encuentra, se intentan generar de manera automática los archivos de configuración necesarios (como app.yaml) en el directorio de etapa de pruebas. app.deploy.deployables
dockerDirectory El directorio que contiene el Dockerfile y otros recursos de Docker. El valor predeterminado es ${basedir}/src/main/docker/. app.stage.dockerDirectory
imageUrl Implementa con una imagen específica de Docker. ImageUrl debe ser un nombre válido de Container Registry, por ejemplo gcr.io/foo, en el que foo es el nombre de la imagen. app.deploy.imageUrl
projectId El nombre del proyecto de Google Cloud que se usará en esta invocación. El valor predeterminado es el proyecto actual que se selecciona cuando se inicializa gcloud. app.deploy.projectId
promote Asciende la versión implementada para que reciba todo el tráfico. El valor predeterminado es True. app.deploy.promote
server El servidor de App Engine con el que se debe establecer una conexión. En general, no es necesario cambiar este valor. app.deploy.server
stagingDirectory Obligatorio. El directorio en el que la aplicación se habilita a etapas. El valor predeterminado es ${project.build.directory}/appengine-staging. app.stage.stagingDirectory
stopPreviousVersion Cuando se implementa una versión nueva que recibe todo el tráfico, detiene la versión que se ejecutaba antes. app.deploy.stopPreviousVersion
version La versión de la aplicación que se creará o reemplazará por esta implementación. Si no especificas una versión, se generará una para ti. app.deploy.version

appengine:help

Muestra la información de ayuda en el complemento App Engine Maven. Para mostrar los detalles del parámetro, llama a:

mvn appengine:help -Ddetail=true -Dgoal=[GOAL_NAME]

Puedes usar los siguientes parámetros:

Parámetro Descripción Propiedad del usuario
detail Si es verdadero, muestra todas las propiedades configurables para cada objetivo. El valor predeterminado es False. detail
goal El nombre del objetivo para el cual se muestra el contenido de ayuda. Si no se especifica, se muestran todos los objetivos. goal
indentSize La cantidad de espacios por nivel de sangría. Debe ser un número positivo. La ruta predeterminada es 2. indentSize
lineLength La longitud máxima de una línea de visualización. Debe ser un número positivo. El valor predeterminado es 80. lineLength

appengine:stage

Genera un directorio de compilación de aplicaciones para la implementación.

Puedes usar los siguientes parámetros:

Parámetro Descripción Propiedad del usuario
appEngineDirectory El directorio que contiene app.yaml y otros archivos de configuración de App Engine compatibles. El valor predeterminado es ${basedir}/src/main/appengine. app.stage.appEngineDirectory
artifact La ubicación del archivo JAR o WAR que se implementará. El valor predeterminado es ${project.build.directory}/${project.build.finalName}.${project.packaging}. app.stage.artifact
cloudSdkPath Un parámetro opcional para configurar la ubicación del SDK de Cloud. cloudSdkPath
dockerDirectory El directorio que contiene el Dockerfile y otros recursos de Docker. El valor predeterminado es ${basedir}/src/main/docker/${basedir}/src/main/docker/. app.stage.dockerDirectory
stagingDirectory Obligatorio. El directorio en el que la aplicación se habilita a etapas. El valor predeterminado es ${project.build.directory}/appengine-staging. app.stage.stagingDirectory