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.

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.

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.

    Captura de pantalla en la que se muestra el cuadro de diálogo Configuración de ejecución y depuración, en el que se pueden ver las variables de entorno para el servidor local

  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.

    Captura de pantalla en la que se muestra el cuadro de diálogo Configuración de ejecución y depuración

    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.

    Captura de pantalla en la que se muestra el cuadro de diálogo Configuración de ejecución y depuración

    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.

      Captura de pantalla en la que se muestra el cuadro de diálogo Configuración de ejecución y depuración

      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.

    Captura de pantalla en la que se muestra el cuadro de diálogo Configuración de ejecución y depuración

    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.

    Captura de pantalla en la que se muestra el cuadro de diálogo Configuración de depuración

    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.

      Captura de pantalla en la que se muestra el cuadro de diálogo Configuración de depuración

      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.

¿Qué sigue?

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.