Ejecuta y depura una app para el entorno estándar de App Engine localmente en Cloud Code para IntelliJ

Antes de implementar la aplicación estándar en App Engine, puedes ejecutarla y depurarla de forma local. En este documento, se describe cómo configurar el IDE para realizar ejecuciones y depuraciones locales desde IntelliJ IDEA.

Nota: Esta función es compatible con los siguientes IDE:

• IntelliJ IDEA: Ultimate
• IntelliJ IDEA: Community

Nota: Para el entorno estándar de App Engine, solo las aplicaciones de Java que usan el entorno de ejecución de Java 8 son compatibles con Cloud Code.

Antes de comenzar

• Asegúrate de que la aplicación sea un proyecto en el entorno estándar de App Engine que contenga un archivo appengine-web.xml.

• Para acceder de manera local a las bibliotecas cliente de Cloud, sigue los procedimientos que se indican en Agrega bibliotecas cliente de Cloud a los proyectos de Maven.

Nota: Los parámetros de configuración para la ejecución y la depuración locales solo están disponibles en IntelliJ Ultimate Edition. Si usas Community Edition, puedes seguir las instrucciones que se indican en Depura la aplicación de forma local en Community Edition para usar los complementos de Maven o Gradle en la ejecución local.

Ejecuta la aplicación de manera local

Si usas IntelliJ IDEA Ultimate Edition, puedes ejecutar una aplicación de App Engine de forma local si sigues estas instrucciones:

1. Selecciona Archivo > Abrir para abrir el proyecto que deseas ejecutar.

2. Navega hasta el directorio que contiene tu proyecto.

3. Selecciona Herramientas > Cloud Code > App EngineEjecutar en un servidor de desarrollo entorno estándar de App Engine.

El proyecto tarda un momento en compilarse.

Edita la configuración de ejecución

Configura el servidor

Puedes editar la configuración de ejecución desde tu servidor local:

1. Selecciona Ejecutar > Editar configuración.

2. En el cuadro de diálogo Configuración de ejecución y depuración, actualiza los parámetros de configuración según sea necesario. Estos son algunos parámetros de configuración comunes:

   • Artefacto que se implementará
   • Host de App Engine.
   • Puerto de App Engine.

Agrega variables del entorno

Si es necesario, agrega variables del entorno a tu configuración.

1. Selecciona la pestaña Startup/Connection (Inicio/Conexiones).

2. Selecciona Run (Ejecutar).

3. Selecciona la casilla de verificación Pass environment variables (Pasar variables del entorno).

4. Agrega las variables necesarias.

5. Selecciona Debug (Depurar).

6. Selecciona la casilla de verificación Pass environment variables (Pasar variables del entorno).

7. Agrega las variables necesarias.

   

8. Cuando termines, haz clic en OK (Aceptar).

Detén el servidor

Para detener el Dev App Server, (servidor de apps de desarrollo) selecciona Ejecutar > Detener "servidor local estándar de Google App Engine".

Depura la aplicación

Puedes usar la configuración que creaste anteriormente para ejecutar tu aplicación en modo depuración. Para ello, sigue estos pasos:

1. Selecciona Run (Ejecutar) > Debug (Depuración).

2. En el cuadro de diálogo, haz clic en Servidor local estándar de Google App Engine.

3. Cuando el proyecto se compile, puedes establecer interrupciones para depurar tu aplicación.

Depura la aplicación de manera local en Community Edition

IntelliJ Community Edition no proporciona compatibilidad integrada para ejecutar aplicaciones locales basadas en el Servlet de Java. Para depurar de manera local la aplicación con IntelliJ Community Edition, configura el proyecto a fin de que use el complemento de Maven o Gradle.

Maven

Configura tu proyecto con el complemento de Maven

1. Agrega el complemento de Maven para App Engine al archivo pom.xml del proyecto.

2. Configura la depuración en un servidor de desarrollo.

3. Crea la Configuración de ejecución y depuración para Maven.

   

   1. Selecciona Ejecutar > Editar configuración.

   2. Haz clic en + Add New Configuration.

   3. Selecciona Maven.

   4. En el campo Línea de comandos, ingresa appengine:run.

   5. Haz clic en OK.

4. Crea una configuración de depuración remota.

   

   1. Selecciona Ejecutar > Editar configuración.

   2. Haz clic en + Add New Configuration.

   3. Selecciona Remote (Remota).

   4. Asegúrate de que el número de puerto sea el mismo que tiene el puerto que configuraste en la configuración del complemento Maven App Engine. El puerto predeterminado es el 5005.

   5. En la sección Before launch (Antes del lanzamiento), haz clic en + Más.

   6. Selecciona Run Another Configuration (Ejecutar otra configuración).

   7. Selecciona la configuración de ejecución para tu proyecto de Maven.

   8. Haz clic en OK.

5. Para depurar tu aplicación de manera local:

   1. Selecciona Run (Ejecutar) > Debug (Depuración).

   2. Selecciona la configuración de depuración remota.

      

      Ya puedes depurar de manera local la aplicación.

Gradle

Configurar tu proyecto con el complemento de Gradle

1. Crea un proyecto nuevo de Gradle.

2. Configura la depuración en un servidor de desarrollo.

3. Crea la Configuración de ejecución y depuración para Gradle.

   

   1. Selecciona Ejecutar > Editar configuración.

   2. Haz clic en + Add New Configuration.

   3. Selecciona Gradle.

   4. En el campo Gradle project (Proyecto de Gradle), selecciona el módulo en el que configuraste el complemento appengine-gradle-plugin.

   5. En el campo Tasks (Tareas), ingresa appengineRun.

   6. Haz clic en OK.

4. Crea una configuración de depuración remota.

   

   1. Selecciona Ejecutar > Editar configuración.

   2. Haz clic en + Add New Configuration.

   3. Selecciona Remote (Remota).

   4. Asegúrate de que el número de puerto sea el mismo que tiene el puerto que configuraste en la configuración de Gradle App Engine Plugin. El puerto predeterminado es el 5005.

   5. En la sección Before launch (Antes del lanzamiento), haz clic en + Más.

   6. Selecciona Run Another Configuration (Ejecutar otra configuración).

   7. Selecciona la configuración de ejecución para tu proyecto de Gradle.

   8. Haz clic en OK.

5. Para depurar tu aplicación de manera local:

   1. Selecciona Run (Ejecutar) > Debug (Depuración).

   2. Selecciona la configuración de depuración remota.

      

      Ya puedes depurar de manera local la aplicación.

   3. Si el vínculo Attach Debugger aparece en el registro de la consola, haz clic en el vínculo.

      Nota: Si el puerto que elegiste está bloqueado, configura un número de puerto diferente (por ejemplo, 5009) en la configuración de Gradle App Engine plugin y actualiza el número de puerto en la configuración remota al mismo número de puerto.

¿Qué sigue?

• Luego, puedes implementar tu app en el entorno estándar de App Engine.

Obtener asistencia

Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve aTools >Cloud Code >Help / About >Envía comentarios o informa un problema para informar un problema en GitHub o hacer una pregunta en Stack Overflow.