Ejecuta y depura una app estándar de App Engine de manera local en Cloud Code para IntelliJ
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
Si usas IntelliJ IDEA Ultimate Edition, puedes ejecutar una aplicación de App Engine de forma local si sigues estas instrucciones:
Selecciona Archivo > Abrir para abrir el proyecto que deseas ejecutar.
Navega hasta el directorio que contiene tu proyecto.
Selecciona Herramientas > Cloud Code > App EngineEjecutar 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:
Selecciona Ejecutar > Editar configuración.
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.
Selecciona la pestaña Startup/Connection (Inicio/Conexiones).
Selecciona Run (Ejecutar).
Selecciona la casilla de verificación Pass environment variables (Pasar variables del entorno).
Agrega las variables necesarias.
Selecciona Debug (Depurar).
Selecciona la casilla de verificación Pass environment variables (Pasar variables del entorno).
Agrega las variables necesarias.
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:
Selecciona Run (Ejecutar) > Debug (Depuración).
En el cuadro de diálogo, haz clic en Servidor local estándar de Google App Engine.
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.
Crea la Configuración de ejecución y depuración para Maven.
Selecciona Ejecutar > Editar configuración.
Haz clic en + Add New Configuration.
Selecciona Maven.
En el campo Línea de comandos, ingresa appengine:run.
Haz clic en OK.
Crea una configuración de depuración remota.
Selecciona Ejecutar > Editar configuración.
Haz clic en + Add New Configuration.
Selecciona Remote (Remota).
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.
En la sección Before launch (Antes del lanzamiento), haz clic en + Más.
Selecciona Run Another Configuration (Ejecutar otra configuración).
Selecciona la configuración de ejecución para tu proyecto de Maven.
Haz clic en OK.
Para depurar tu aplicación de manera local:
Selecciona Run (Ejecutar) > Debug (Depuración).
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
Crea la Configuración de ejecución y depuración para Gradle.
Selecciona Ejecutar > Editar configuración.
Haz clic en + Add New Configuration.
Selecciona Gradle.
En el campo Gradle project (Proyecto de Gradle), selecciona el módulo en el que configuraste el complemento appengine-gradle-plugin.
En el campo Tasks (Tareas), ingresa appengineRun.
Haz clic en OK.
Crea una configuración de depuración remota.
Selecciona Ejecutar > Editar configuración.
Haz clic en + Add New Configuration.
Selecciona Remote (Remota).
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.
En la sección Before launch (Antes del lanzamiento), haz clic en + Más.
Selecciona Run Another Configuration (Ejecutar otra configuración).
Selecciona la configuración de ejecución para tu proyecto de Gradle.
Haz clic en OK.
Para depurar tu aplicación de manera local:
Selecciona Run (Ejecutar) > Debug (Depuración).
Selecciona la configuración de depuración remota.
Ya puedes depurar de manera local la aplicación.
Si el vínculo Attach Debugger aparece en el registro de la consola, haz clic en él.
Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve a Tools > Cloud Code > Help / About > Submit feedback or report an issue para informar un problema en GitHub.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (UTC)"],[[["\u003cp\u003eCloud Code supports running and debugging App Engine standard applications locally within IntelliJ IDEA, but Java 8 is the only supported runtime.\u003c/p\u003e\n"],["\u003cp\u003eApp Engine support in Cloud Code is being deprecated, with Java 8 support having ended in January 2024 and full deprecation scheduled for January 2026, so it's not recommended to create new App Engine projects.\u003c/p\u003e\n"],["\u003cp\u003eIntelliJ IDEA Ultimate Edition allows for direct local running and debugging through built-in configurations, while Community Edition requires using Maven or Gradle plugins.\u003c/p\u003e\n"],["\u003cp\u003eWhen debugging, you can set breakpoints and configure environment variables in the run configuration, and stopping the server is done through the Run menu.\u003c/p\u003e\n"],["\u003cp\u003eMaven or Gradle projects require the respective plugins to be added and run/debug configurations to be made for the plugin and remote debugging, for local debugging in the Community Edition of IntelliJ.\u003c/p\u003e\n"]]],[],null,["# Run and debug an App Engine Standard app locally in Cloud Code for IntelliJ\n\n| **Caution:** As of January 31, 2024, Java 8 support for App Engine has ended, and will be deprecated on January 31, 2026. As a result, Cloud Code disables App Engine by default. To enable App Engine in your IDE, navigate to **Settings** \\\u003e **Google\n| Cloud Code** \\\u003e **App Engine** . Due to the upcoming deprecation of App Engine, we don't recommend creating new App Engine projects. For more information about App Engine deprecations, see [Feature deprecations](/appengine/docs/standard/deprecations). For more information about the runtime support schedule for App Engine, see [Runtime support schedule](/appengine/docs/standard/lifecycle/support-schedule).\n\nPrior to deploying your application to\n[App Engine](/appengine/docs/standard/java), you can run and debug\nyour App Engine standard application locally. This document describes\nhow to configure the IDE for local run and debug from within IntelliJ IDEA.\n| **Note:** The following IDEs support this feature:\n|\n| - IntelliJ IDEA - Ultimate\n| - IntelliJ IDEA - Community\n| **Note:** For the App Engine standard environment, only Java applications using [Java 8 runtime](/appengine/docs/standard/java/runtime) are supported on Cloud Code.\n\nBefore you begin\n----------------\n\n- Ensure your application is an App Engine standard project that\n contains an `appengine-web.xml` file\n\n- To access the Cloud Client Libraries locally, complete the\n [Adding Cloud Client Libraries to Your Maven\n Projects](/code/docs/intellij/client-libraries) procedures.\n\n| **Note:** Run configurations for local run and debug are only available in IntelliJ Ultimate Edition. If you are using Community Edition, you can follow the [debugging your application locally on Community Edition](#community) instructions to use the Maven or Gradle plugins for your local run.\n\nRunning your application locally\n--------------------------------\n\nIf you're using IntelliJ IDEA Ultimate Edition, you can run an\nApp Engine application locally by following these instructions:\n\n1. Select **File** \\\u003e **Open** to open the project you want to run.\n\n2. Browse to the directory containing your project.\n\n3. Select **Tools** \\\u003e **Cloud Code** \\\u003e **App Engine** **Run on a local\n App Engine Standard dev server**.\n\nThe project takes a moment to build.\n\nEditing the run configuration\n-----------------------------\n\n### Configure the server\n\nYou can edit the run configuration for your local server:\n\n1. Select **Run** \\\u003e **Edit Configurations**.\n\n2. From the **Run/Debug Configurations** dialog, update configuration settings\n as needed. Some common settings include:\n\n - Artifact to deploy.\n - App Engine Host.\n - App Engine Port.\n\n### Add environment variables\n\nIf needed, add environment variables to your configuration.\n\n1. Select the **Startup/Connection** tab.\n\n2. Select **Run**.\n\n3. Select the **Pass environment variables** checkbox.\n\n4. Add the necessary variables.\n\n5. Select **Debug**.\n\n6. Select the **Pass environment variables** checkbox.\n\n7. Add the necessary variables.\n\n8. When finished, click **OK**.\n\nStopping the server\n-------------------\n\nTo stop the Dev App Server, choose **Run** \\\u003e\n**Stop 'Google App Engine Standard Local Server'**.\n\nDebugging the application\n-------------------------\n\nYou can use the run configuration you previously created to run your application\nin debug mode as follows:\n\n1. Select **Run** \\\u003e **Debug**.\n\n2. In the dialog, click **Google App Engine Standard Local Server**.\n\n3. After the project builds, you can set breakpoints to debug your app.\n\nDebugging your application locally on Community Edition\n-------------------------------------------------------\n\nIntelliJ Community Edition does not provide built-in support for running local\nJava servlet-based applications. To debug your application locally using IntelliJ\nCommunity Edition, configure your project to use the\n[Maven](/appengine/docs/standard/java/using-maven) or\n[Gradle](/appengine/docs/standard/java/using-gradle) plugin. \n\n### Maven\n\nConfiguring your project using the Maven plugin\n\n1. [Add the App Engine Maven\n plugin](/appengine/docs/standard/java/using-maven#adding_the_app_engine_maven_plugin_to_an_existing_project)\n to your project's `pom.xml` file.\n\n2. [Configure debugging on a development\n server](/appengine/docs/standard/java/using-maven#testing_your_application_with_the_development_server).\n\n3. Create Run/Debug configuration for Maven.\n\n 1. Select **Run** \\\u003e **Edit Configurations**.\n\n 2. Click **+ Add New Configuration**.\n\n 3. Select **Maven**.\n\n 4. In the **Command line** field, enter `appengine:run`.\n\n 5. Click **OK**.\n\n4. Create a remote debug configuration.\n\n 1. Select **Run** \\\u003e **Edit Configurations**.\n\n 2. Click **+ Add New Configuration**.\n\n 3. Select **Remote**.\n\n 4. Ensure that the port number is the same as the port you configured in\n your Maven App Engine plugin configuration. Port **5005** is\n the default.\n\n 5. In the **Before launch** section, click **+ Add**.\n\n 6. Select **Run Another Configuration**.\n\n 7. Select the run configuration for your Maven project.\n\n 8. Click **OK**.\n\n5. To debug your application locally:\n\n 1. Select **Run** \\\u003e **Debug**.\n\n 2. Select your remote debug configuration.\n\n You can now debug your application locally.\n\n### Gradle\n\nConfiguring your project using the Gradle plugin\n\n1. [Create a new Gradle\n project](/appengine/docs/standard/java/using-gradle#creating_a_new_project).\n\n2. [Configure debugging on a development\n server](/appengine/docs/standard/java/using-gradle#testing_gradle_app).\n\n3. Create Run/Debug configuration for Gradle.\n\n 1. Select **Run** \\\u003e **Edit Configurations**.\n\n 2. Click **+ Add New Configuration**.\n\n 3. Select **Gradle**.\n\n 4. In the **Gradle project** field, select the module where you\n configured the `appengine-gradle-plugin` plugin.\n\n 5. In the **Tasks** field, enter `appengineRun`.\n\n 6. Click **OK**.\n\n4. Create a remote debug configuration.\n\n 1. Select **Run** \\\u003e **Edit Configurations**.\n\n 2. Click **+ Add New Configuration**.\n\n 3. Select **Remote**.\n\n 4. Ensure that the port number is the same as the port you configured in\n your Gradle App Engine plugin configuration. Port **5005** is the\n default.\n\n 5. In the **Before launch** section, click **+ Add**.\n\n 6. Select **Run Another Configuration**.\n\n 7. Select the run configuration for your Gradle project.\n\n 8. Click **OK**.\n\n5. To debug your application locally:\n\n 1. Select **Run** \\\u003e **Debug**.\n\n 2. Select your remote debug configuration.\n\n You can now debug your application locally.\n 3. If the **Attach Debugger** link appears in the console log, click the\n link.\n\n | **Note:** If the port you've chosen is blocked, configure a different port number (for example, **5009**) in your Gradle App Engine plugin configuration and update the port number in the remote configuration to the same port number.\n\nWhat's next\n-----------\n\n- Next, you can deploy your app to the [App Engine standard\n environment](/code/docs/intellij/deploy-std).\n\nGet support\n-----------\n\nTo submit feedback or report an issue in your IntelliJ IDE, go to **Tools** \\\u003e **Cloud Code** \\\u003e **Help / About** \\\u003e **Submit\nfeedback or report an issue** to report an issue on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-intellij/issues)."]]
