Tareas y propiedades del complemento App Engine Gradle

Después de agregar el complemento de App Engine Gradle a tu proyecto, puedes usar las siguientes tareas de Gradle específicas de App Engine en la app de Java 8:

Tarea	Descripción
`tasks`	Muestra la información de ayuda en las tareas instaladas.
`appengineStage`	Genera un directorio de aplicaciones para la implementación.
`appengineDeploy`	Habilita por etapas e implementa una aplicación en App Engine.
`appengineDeployCron`	Implementa un archivo de configuración `cron.yaml` en App Engine.
`appengineDeployDispatch`	Implementa un archivo de configuración `dispatch.yaml` en App Engine.
`appengineDeployDos`	Implementa un archivo de configuración `dos.yaml` en App Engine.
`appengineDeployIndex`	Implementa un archivo de configuración `index.yaml` en App Engine.
`appengineDeployQueue`	Implementa un archivo de configuración `queue.yaml` en App Engine.
`jettyRun`	Ejecuta el servidor de desarrollo con la configuración predeterminada de Jetty. Para obtener más información sobre el complemento Gretty, consulta las páginas Gretty configuration (Configuración de Gretty) y Gretty tasks (Tareas de Gretty)

Para ver la lista completa de tareas, usa:

gradle tasks

Para obtener más información sobre cómo configurar y usar Gradle, consulta Usa App Engine para Gradle y el repositorio app-gradle-plugin en GitHub.

Propiedades de tareas

El contenido del archivo gradle.build es un conjunto de reglas para describir tu compilación. Está escrito en un lenguaje específico del dominio para describir compilaciones, basado en el lenguaje Groovy.

Cada tarea tiene propiedades asociadas que puedes usar. Las propiedades se detallan más adelante. Puedes especificar estas propiedades en el archivo gradle.build mediante un cierre de configuración, una tarea y propiedades.

En el siguiente ejemplo, se muestra cómo especificar las tareas de Gradle para Java 8. Para la versión 11 y posteriores de Java, consulta Entorno de ejecución de Java a fin de obtener más información sobre el uso de versiones más recientes.

En este ejemplo:

El cierre de configuración para el complemento es appengine.
La tarea es deploy.
Las propiedades, stopPreviousVersion y promote, se configuran como true.

appengine {
  deploy {   // deploy configuration
    stopPreviousVersion = true  // default - stop the current version
    promote = true              // default - & make this the current version
  }
}

Si solo tienes que especificar algunas propiedades, puedes establecerlas en una sola línea:

  appengine.deploy.stopPreviousVersion = true

Consulta las secciones siguientes si deseas ver una lista de las propiedades que están disponibles para cada tarea.

appengineStage

task(stage)

Genera un directorio de aplicaciones para la implementación. Lo usan las tareas appengineDeploy y jettyRun.

Puedes usar las siguientes propiedades:

Propiedad	Descripción
`artifact`	Artefacto compilado que posee todas las clases, los recursos y los manifiestos. El valor predeterminado es `build/libs/[YOUR_SERVLET].war`.
`appEngineDirectory`	Ubicación del archivo `app.yaml`. El valor predeterminado es `src/main/appengine`.
`dockerDirectory`	Ubicación de `Dockerfile`. El valor predeterminado es `src/main/docker`.
`stagingDirectory`	Obligatorio. El directorio en el que la aplicación se habilita a etapas. El valor predeterminado es `build/staged-app`.

appengineDeploy

task(deploy)

Divide en etapas y luego implementa una aplicación en App Engine.

En el siguiente ejemplo, se muestra lo siguiente:

El cierre de configuración para el complemento es appengine.
La tarea es run.
La propiedad, port, está configurada como 8080.

appengine {  // App Engine tasks configuration
  run {      // local (dev_appserver) configuration (standard environments only)
    port = 8080                 // default
  }

  deploy {   // deploy configuration
    stopPreviousVersion = true  // default - stop the current version
    promote = true              // default - & make this the current version
  }
}

Si solo tienes que especificar algunas propiedades, puedes establecerlas en una sola línea:

  appengine.run.port = 8888

Propiedad	Descripción
`appEngineDirectory`	Ubicación de los archivos de configuración `.yaml` (cron, índice, etc.) desde los que se realizarán las implementaciones específicas de la configuración (appengineDeployCron, etc.). En las aplicaciones flexibles, el valor predeterminado es `src/main/appengine`.
`bucket`	El bucket de Cloud Storage que se usa para almacenar en etapa intermedia los archivos asociados a la implementación. Si este argumento no se especifica, se utiliza el bucket predeterminado de la aplicación.
`deployables`	Los archivos YAML para los servicios o las opciones de configuración que deseas 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.
`imageUrl`	Implementa con una imagen específica de Docker. La URL de Docker debe ser uno de los nombres de host válidos de Artifact Registry.
`project`	El nombre del proyecto de Google Cloud Platform que se debe usar en esta invocación. El valor predeterminado es el proyecto actual que se selecciona cuando se inicializa la herramienta de gcloud. Para la verificación, usa `gcloud config list project`.
`promote`	Asciende la versión implementada para que reciba todo el tráfico. El valor predeterminado es True.
`server`	El servidor de App Engine para conectarse. En general, no es necesario cambiar este valor.
`stopPreviousVersion`	Cuando se implementa una versión nueva que recibe todo el tráfico, detiene la versión que se ejecutaba antes.
`version`	La versión de la app que esta implementación creará o reemplazará. Si no especificas una versión, se generará una automáticamente.

Propiedades globales

Propiedad	Descripción
`tools.cloudSdkHome`	Propiedad opcional para configurar la ubicación de Google Cloud CLI. Por lo general, el complemento la encuentra en la CLI de gcloud cuando se instala con `gcloud components install app-engine-java`.