Ejecuta y depura de manera local una aplicación estándar de App Engine

Antes de implementar tu aplicación estándar en App Engine, puedes ejecutarla y depurarla localmente. 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. Para ello, sigue 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 Engine Ejecuta en un servidor de desarrollo estándar de App Engine local.

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 Run > Edit Configurations.

  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 servidor de desarrollo de aplicaciones, 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 > Debug.

  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 con la ejecución de aplicaciones locales basadas en 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 Run > Edit Configurations.

    2. Haz clic en Más (+) para agregar una configuración nueva.

    3. Selecciona Maven.

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

    5. Haz clic en OK (Aceptar).

  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 Run > Edit Configurations.

    2. Haz clic en el Más (+) para agregar una configuración nueva.

    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 (Aceptar).

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

    1. Selecciona Run > Debug.

    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 Run > Edit Configurations.

    2. Haz clic en Más (+) para agregar una configuración nueva.

    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 (Aceptar).

  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 Run > Edit Configurations.

    2. Haz clic en el Más (+) para agregar una configuración nueva.

    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 > Debug.

    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.

¿Qué sigue?

Obtén asistencia

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

También puedes unirte al canal #cloud-code, que forma parte de la comunidad de Slack de Google Cloud.