Sviluppare un servizio localmente in Cloud Code for IntelliJ
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Con Cloud Code puoi sviluppare i tuoi servizi Cloud Run
localmente in un ambiente simile a Cloud Run. Cloud Code monitora
le modifiche al codice sorgente e aggiorna rapidamente il servizio in esecuzione per
riflettere queste modifiche.
Definizione della configurazione di esecuzione
Prima di eseguire il servizio, devi creare la configurazione di esecuzione:
Vai al selettore delle configurazioni di esecuzione/debug nella barra di navigazione e
fai clic su Modifica configurazioni.
In Cloud Code: Cloud Run, scegli Cloud Run: Run Locally (Cloud Run: esegui localmente).
Se vuoi che Cloud Code esegua nuovamente il deployment dell'applicazione
automaticamente dopo il salvataggio delle modifiche, seleziona Al salvataggio del file in Modalità di osservazione - ricompila e
riesegui il deployment. Per impostazione predefinita, i nuovi servizi Cloud Run hanno selezionato l'opzione On demand. Per ulteriori informazioni sulle modalità dell'orologio, vedi
Modalità dell'orologio.
Specifica l'opzione del builder e le relative impostazioni.
Durante lo sviluppo in locale, puoi specificare impostazioni aggiuntive come un account di servizio, variabili di ambiente e connessioni SQL (quando utilizzi Cloud Run (completamente gestito)), utilizzando la sezione Impostazioni avanzate della revisione quando scegli Modifica configurazioni.
Variabili di ambiente
Le seguenti variabili di ambiente vengono aggiunte automaticamente ai container in esecuzione:
Nome
Descrizione
Esempio
PORT
La porta su cui deve rimanere in ascolto il server HTTP.
8080
K_SERVICE
Il nome del servizio Cloud Run in esecuzione.
hello-world
K_REVISION
Il nome della revisione Cloud Run in esecuzione.
hello-world.1
K_CONFIGURATION
Il nome della configurazione Cloud Run che ha creato la revisione.
hello-world
Archiviare i secret
Se il tuo codice include dati potenzialmente sensibili come chiavi API, password e certificati, ti consigliamo di archiviarli come secret. Con
Cloud Code, puoi archiviare in modo sicuro questi secret in Secret Manager
e recuperarli in modo programmatico quando ne hai bisogno. Per un'analisi dettagliata di come creare e gestire i secret con Cloud Code, consulta la guida di Secret Manager.
Esecuzione del servizio
Per eseguire il servizio, segui questi passaggi:
Scegli la destinazione di esecuzione Cloud Run: Run Locally dal selettore delle configurazioni di esecuzione/debug nella barra di navigazione.
Fai clic su Cloud Run: Run Locally (Cloud Run: esegui in locale).
Visualizza i log del servizio in esecuzione, trasmessi in streaming direttamente alla finestra di output.
Una volta completato il deployment, puoi visualizzare il servizio in esecuzione seguendo l'URL visualizzato nel riquadro Log eventi. Nell'esempio riportato di seguito, questo URL è
http://localhost:8080.
Assistenza
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 enables local development of Cloud Run services in a simulated environment, with real-time updates reflecting code changes.\u003c/p\u003e\n"],["\u003cp\u003eBefore running a service, users must define a run configuration in the "Edit Configurations" section, specifying options like the builder type and watch mode preference.\u003c/p\u003e\n"],["\u003cp\u003eDuring local development, users can customize configurations by adding settings such as service accounts, environment variables, and SQL connections.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code automatically adds environment variables like PORT, K_SERVICE, K_REVISION, and K_CONFIGURATION to running containers.\u003c/p\u003e\n"],["\u003cp\u003eSecrets, such as API keys and passwords, can be securely stored in Secret Manager and accessed programmatically using Cloud Code.\u003c/p\u003e\n"]]],[],null,["# Develop a service locally in Cloud Code for IntelliJ\n\nWith Cloud Code, you can develop your Cloud Run services\nlocally in a Cloud Run-like environment. Cloud Code watches\nfor changes in your source and quickly updates the running service to\nreflect these changes.\n\nDefining your run configuration\n-------------------------------\n\nBefore you run your service, you must create your run configuration:\n\n1. Navigate to Run/Debug configurations selector in the Navigation bar and click **Edit Configurations**.\n2. Under Cloud Code: Cloud Run, choose **Cloud Run: Run Locally**.\n3. If you want Cloud Code to redeploy your application automatically after your changes are saved, under **Watch mode - rebuild and\n redeploy** , select **On file save** . New Cloud Run services have **On demand** selected by default. For more information about watch modes, see [Watch modes](/code/docs/intellij/watch-modes).\n4. Specify your builder option and its relevant settings.\n\n Cloud Code supports Docker, Jib, and Buildpacks\n [artifact types](https://skaffold.dev/docs/builders/).\n5. Click **OK**.\n\n### Optional: Customizing your configuration\n\nWhen developing locally, you can specify additional settings like a service\naccount, environment variables, and SQL connections (when using\nCloud Run (fully managed)), using the Advanced revision settings section when\nyou choose **Edit Configurations**.\n\n#### Environment variables\n\nThe following environment variables are automatically added to the\nrunning containers:\n\nStoring secrets\n---------------\n\nIf your code includes potentially sensitive data like API keys, passwords, and\ncertificates, it is recommended you store them as secrets. With\nCloud Code, you can securely store these secrets in Secret Manager\nand programmatically fetch them when you need them. For a detailed look at\nhow you can create and manage secrets with Cloud Code, refer to\nthe [Secret Manager guide](/code/docs/intellij/secret-manager).\n\nRunning your service\n--------------------\n\nTo run your service, follow these steps:\n\n1. Choose the **Cloud Run: Run Locally** run target from the Run/Debug configurations selector in the Navigation bar.\n2. Click **Cloud Run: Run Locally**.\n3. View the logs from your running service, streamed directly to the **output window**.\n4. Once deployment is complete, you can view your running service by following the\n URL displayed in your Event Log panel. In the example below, this URL is\n http://localhost:8080.\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)."]]
Cloud Run: Run Locally (Cloud Run: esegui in locale).