Sviluppare un servizio localmente in Cloud Code for IntelliJ

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:

  1. Vai al selettore delle configurazioni di esecuzione/debug nella barra di navigazione e fai clic su Modifica configurazioni.
  2. In Cloud Code: Cloud Run, scegli Cloud Run: Run Locally (Cloud Run: esegui localmente).
  3. 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.
  4. Specifica l'opzione del builder e le relative impostazioni.

    Cloud Code supporta i tipi di artefatto Docker, Jib e Buildpacks.

  5. Fai clic su OK.

(Facoltativo) Personalizzare la configurazione

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:

  1. Scegli la destinazione di esecuzione Cloud Run: Run Locally dal selettore delle configurazioni di esecuzione/debug nella barra di navigazione.
  2. Fai clic su icona dell'azione di corsa Cloud Run: Run Locally (Cloud Run: esegui in locale).
  3. Visualizza i log del servizio in esecuzione, trasmessi in streaming direttamente alla finestra di output.
  4. 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.

    Log eventi con notifica di deployment riuscito e URL per visualizzare l'anteprima del servizio

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.