Esegui e esegui il debug di un'app App Engine Standard localmente in Cloud Code for IntelliJ
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Prima di eseguire il deployment dell'applicazione su
App Engine, puoi eseguire ed eseguire il debug
della tua applicazione standard App Engine localmente. Questo documento descrive
come configurare l'IDE per l'esecuzione e il debug locali da IntelliJ IDEA.
Prima di iniziare
Assicurati che la tua applicazione sia un progetto standard di App Engine che
contenga un file appengine-web.xml
Se utilizzi IntelliJ IDEA Ultimate Edition, puoi eseguire un'applicazione App Engine in locale seguendo queste istruzioni:
Seleziona File > Apri per aprire il progetto che vuoi eseguire.
Vai alla directory contenente il progetto.
Seleziona Strumenti > Cloud Code > App EngineEsegui su un server di sviluppo
App Engine Standard locale.
La creazione del progetto richiede un attimo.
Modifica della configurazione di esecuzione
Configurare il server
Puoi modificare la configurazione di esecuzione per il server locale:
Seleziona Esegui > Modifica configurazioni.
Nella finestra di dialogo Configurazioni di esecuzione/debug, aggiorna le impostazioni di configurazione
in base alle esigenze. Alcune impostazioni comuni includono:
Artefatto di cui eseguire il deployment.
Host App Engine.
Porta App Engine.
Aggiungere variabili di ambiente
Se necessario, aggiungi variabili di ambiente alla configurazione.
Seleziona la scheda Avvio/Connessione.
Seleziona Esegui.
Seleziona la casella di controllo Passa variabili di ambiente.
Aggiungi le variabili necessarie.
Seleziona Debug.
Seleziona la casella di controllo Passa variabili di ambiente.
Aggiungi le variabili necessarie.
Al termine, fai clic su Ok.
Arresto del server
Per arrestare il server di sviluppo dell'app, scegli Esegui >
Arresta "Google App Engine Standard Local Server".
Debug dell'applicazione
Puoi utilizzare la configurazione di esecuzione creata in precedenza per eseguire l'applicazione
in modalità di debug nel seguente modo:
Seleziona Esegui > Debug.
Nella finestra di dialogo, fai clic su Google App Engine Standard Local Server.
Dopo la creazione del progetto, puoi impostare punti di interruzione per eseguire il debug dell'app.
Esecuzione del debug dell'applicazione in locale su Community Edition
IntelliJ Community Edition non fornisce supporto integrato per l'esecuzione di applicazioni locali
basate su servlet Java. Per eseguire il debug dell'applicazione in locale utilizzando IntelliJ Community Edition, configura il progetto in modo che utilizzi il plug-in Maven o Gradle.
Maven
Configurazione del progetto utilizzando il plug-in Maven
Crea una configurazione di esecuzione/debug per Maven.
Seleziona Esegui > Modifica configurazioni.
Fai clic su + Aggiungi nuova configurazione.
Seleziona Maven.
Nel campo Riga di comando, inserisci appengine:run.
Fai clic su OK.
Crea una configurazione di debug remoto.
Seleziona Esegui > Modifica configurazioni.
Fai clic su + Aggiungi nuova configurazione.
Seleziona Telecomando.
Assicurati che il numero di porta sia lo stesso di quello configurato nella configurazione del plug-in Maven App Engine. La porta 5005 è
il valore predefinito.
Nella sezione Prima del lancio, fai clic su + Aggiungi.
Seleziona Esegui un'altra configurazione.
Seleziona la configurazione di esecuzione per il progetto Maven.
Fai clic su OK.
Per eseguire il debug dell'applicazione in locale:
Seleziona Esegui > Debug.
Seleziona la configurazione di debug remoto.
Ora puoi eseguire il debug della tua applicazione in locale.
Gradle
Configurazione del progetto utilizzando il plug-in Gradle
Crea una configurazione di esecuzione/debug per Gradle.
Seleziona Esegui > Modifica configurazioni.
Fai clic su + Aggiungi nuova configurazione.
Seleziona Gradle.
Nel campo Progetto Gradle, seleziona il modulo in cui hai configurato il plug-in appengine-gradle-plugin.
Nel campo Tasks (Attività), inserisci appengineRun.
Fai clic su OK.
Crea una configurazione di debug remoto.
Seleziona Esegui > Modifica configurazioni.
Fai clic su + Aggiungi nuova configurazione.
Seleziona Telecomando.
Assicurati che il numero di porta sia lo stesso di quello configurato nella configurazione del plug-in Gradle App Engine. La porta 5005 è quella
predefinita.
Nella sezione Prima del lancio, fai clic su + Aggiungi.
Seleziona Esegui un'altra configurazione.
Seleziona la configurazione di esecuzione per il progetto Gradle.
Fai clic su OK.
Per eseguire il debug dell'applicazione in locale:
Seleziona Esegui > Debug.
Seleziona la configurazione di debug remoto.
Ora puoi eseguire il debug della tua applicazione in locale.
Se nel log della console viene visualizzato il link Collega debugger, fai clic sul
link.
Per inviare un feedback o segnalare un problema nel tuo IDE IntelliJ, vai a
Strumenti > Cloud Code > Guida / Informazioni > Invia
feedback o segnala un problema per segnalare un problema su GitHub.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
