Se non hai definito un file .vscode/launch.json, la finestra di dialogo Esegui/Esegui il debug nell'emulatore di Cloud Run ti consente di configurare il lancio e poi salva le impostazioni in .vscode/launch.json. Se hai configurato un file.vscode/launch.json, puoi modificarlo direttamente.
Per eseguire il servizio localmente, specifica la configurazione:
Apri la tavolozza dei comandi (premi Ctrl/Cmd+Shift+P o fai clic su Visualizza >
Tavolozza comandi) e poi esegui il comando Esegui nell'emulatore Cloud Run.
Nella finestra di dialogo Esegui/Esegui il debug nell'emulatore Cloud Run, imposta le specifiche per la configurazione:
Per l'emulatore Cloud Run sono disponibili solo gli strumenti di compilazione installati in locale
Scegli Docker o Buildpack come builder e poi specifica la fonte
(Facoltativo) Per specificare eventuali variabili di ambiente da passare ai contenitori in esecuzione, espandi Impostazioni di compilazione avanzate e fai clic per specificare le coppie chiave-valore.
Nome
Descrizione
Esempio
PORT
La porta su cui il server HTTP deve rimanere in ascolto.
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
(Facoltativo) Per specificare le connessioni Cloud SQL, espandi Impostazioni avanzate del servizio, fai clic su Connessioni e poi specifica una connessione Cloud SQL per riga.
(Facoltativo) Seleziona l'opzione
Rendi il servizio accessibile da altri dispositivi sulla rete locale.
(Facoltativo) Se vuoi ricostruire ed eseguire il servizio solo manualmente,
invece che automaticamente quando apporti una modifica, deseleziona l'opzione
Ricompila e riavvia automaticamente in caso di modifiche.
Eseguire il servizio in locale
Dopo aver definito le impostazioni che preferisci, esegui il servizio facendo clic su
Esegui.
Monitora lo stato del deployment nella finestra di output.
Al termine del deployment, puoi visualizzare il servizio in esecuzione aprendo
l'URL visualizzato nella finestra di output.
Per visualizzare i log dettagliati, passa alla visualizzazione dettagliata di Cloud Run nella finestra di output.
Al termine della sessione, fai clic con il tasto destro del mouse per utilizzare i seguenti comandi:
Visualizza log:apri i log dell'applicazione di un deployment specifico con Esplora log di Cloud Code.
Apri URL:apri l'URL del servizio di applicazione di un servizio specifico in un browser web.
Se hai disattivato la modalità di visualizzazione nella configurazione di lancio e vuoi apportare modifiche all'applicazione, ricrearla ed eseguire nuovamente il deployment, fai clic sulla barra di stato di Cloud Code e poi su Attiva la modalità di visualizzazione.
Per interrompere il deployment, puoi fare clic sul pulsante Interrompi nella barra delle azioni per il deployment corrente.
Archiviare i secret
Se il codice include dati potenzialmente sensibili come chiavi API, password e certificati, archiviarli come secret può contribuire a proteggerli. L'integrazione di Secret Manager con Cloud Code ti consente di archiviare in modo sicuro questi secret e recuperarli in modo programmatico. Per un'analisi dettagliata di come
puoi creare e gestire i secret con Cloud Code, consulta
la guida di Secret Manager.
Personalizzazione di una configurazione launch.json esistente
Il plug-in Cloud Code aggiorna automaticamente il file di configurazione launch.json quando scegli un'azione di esecuzione. Per personalizzare ulteriormente l'esecuzione del servizio, puoi specificare i seguenti campi nel file .vscode/launch.json:
watch: rileva le modifiche nell'area di lavoro e esegue nuovamente il servizio. True per impostazione predefinita.
L'esempio seguente mostra l'orologio impostato su true:
"watch":true,
build: specifica il compilatore
(Docker,
jibMaven, jibGradle o
buildpacks)
con cui creare le immagini.
L'esempio seguente mostra un builder Docker:
"build":{"docker":{"path":"Dockerfile"}},
L'esempio seguente mostra un generatore di buildpack:
debug: specifica le impostazioni di debug, ad esempio la mappatura dei percorsi remoti, per mappare un percorso locale a un percorso nel contenitore remoto.
L'esempio seguente mostra una sezione di debug che indica la posizione dei file di origine:
[[["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\u003eYou can develop services locally using a Cloud Run emulator before deploying them to Cloud Run, with configuration settings being stored in a \u003ccode\u003e.vscode/launch.json\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eThe Run/Debug on Cloud Run Emulator dialog or the command palette can be used to configure your service, allowing you to choose between Docker or Buildpacks, specify environment variables, and set Cloud SQL connections.\u003c/p\u003e\n"],["\u003cp\u003eOnce configured, you can run your service locally, monitor its deployment status in the output window, and view logs or access the service URL.\u003c/p\u003e\n"],["\u003cp\u003eSecrets like API keys can be securely managed using the Cloud Code Secret Manager integration, with details available in the Secret Manager guide.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize your service's launch settings further by editing the \u003ccode\u003e.vscode/launch.json\u003c/code\u003e file, which allows for configuring options such as watching for changes, specifying the builder, setting the image and service, and defining debug settings.\u003c/p\u003e\n"]]],[],null,["# Develop a Cloud Run service locally in Cloud Code for VS Code\n\nBefore you\n[deploy a service to Cloud Run](/code/docs/vscode/deploy-service),\nyou can develop it locally using a Cloud Run emulator.\n\nConfiguring your service for development\n----------------------------------------\n\nIf you don't have a `.vscode/launch.json` file defined, the\n**Run/Debug on Cloud Run Emulator** dialog lets you configure your launch and\nthen saves your settings to `.vscode/launch.json`. If you have a\n`.vscode/launch.json` file configured, you can edit the file directly.\n\nTo run your service locally, specify your configuration:\n\n1. Open the command palette (press `Ctrl`/`Cmd`+`Shift`+`P` or click **View** \\\u003e **Command Palette** ) and then run the **Run on Cloud Run Emulator** command.\n2. In the Run/Debug on Cloud Run Emulator dialog, set the\n specifications for your configuration:\n\n - Only locally-installed build tools are available for Cloud Run Emulator\n - Choose **Docker** or **Buildpacks** as your builder and then specify the source\n - (Optional) To specify any environment variables to pass to the running containers, expand **Advanced Build Settings** and then click to specify key-value pairs.\n\n - (Optional) To specify Cloud SQL connections, expand **Advanced Service Settings** , click **Connections**, and then specify one Cloud SQL connection per line.\n - (Optional) Check the **Make the service accessible from other devices on the local network** option.\n - (Optional) If you only want to rebuild and run your service manually, instead of automatically when you make a change, clear the **Automatically re-build and re-run on changes** option.\n\nRunning your service locally\n----------------------------\n\n1. After you define your preferred settings, run your service by clicking\n **Run**.\n\n2. If prompted, [authenticate your credentials to run and debug an\n application locally](/code/docs/vscode/install#authenticate_credentials_for_debugging_applications_locally).\n\n3. Monitor the status of your deployment in the **output window**.\n\n After deployment is complete, you can view your running service by opening\n the URL displayed in the output window.\n4. To view verbose logs, switch to the detailed Cloud Run view\n in the output window.\n\n5. After your session completes, right-click to use the following commands:\n\n - **View Logs:** Open the application logs of a specific deployment with the Cloud Code logs explorer.\n - **Open URL:** Open the application service URL of a specific service in a web browser.\n6. If you've turned off watch mode in your launch configuration and you want to\n make changes to your application and rebuild and redeploy the application,\n click the Cloud Code status bar and then click\n **Turn on watch mode**.\n\n7. To stop your deployment, you can click the **Stop** button in the action bar\n for your current deployment.\n\nStoring secrets\n---------------\n\nIf your code includes potentially sensitive data like API keys, passwords, and\ncertificates, storing them as secrets can help secure them. The\nCloud Code Secret Manager integration lets you securely\nstore these secrets and fetch them programmatically. For a detailed look at how\nyou can create and manage secrets with Cloud Code, see\n\nthe [Secret Manager guide](/code/docs/vscode/secret-manager).\n\n\nCustomizing an existing launch.json configuration\n-------------------------------------------------\n\nThe Cloud Code plugin updates the `launch.json` configuration file\nautomatically when you choose a run action. To further customize how your\nservice is run, you can specify the following fields in your\n`.vscode/launch.json` file:\n\n- **watch**: Watches for changes in the workspace and reruns\n the service. True by default.\n\n The following sample shows watch set to `true`: \n\n \"watch\": true,\n\n- **build** : Specify the builder\n ([Docker](https://skaffold.dev/docs/pipeline-stages/builders/docker/),\n jibMaven, jibGradle, or\n [buildpacks](https://skaffold.dev/docs/pipeline-stages/builders/buildpacks/))\n to build your images with.\n\n The following sample shows a Docker builder: \n\n \"build\": {\n \"docker\": {\n \"path\": \"Dockerfile\"\n }\n },\n\n The following sample shows a buildpack builder: \n\n \"build\": {\n \"buildpacks\": {\n \"path\": \"src/requirements.txt\",\n \"builder\": \"gcr.io/buildpacks/builder:v1\"\n }\n },\n\n- **image**: Specify the name of the image to use.\n\n The following sample shows how to specify an image name: \n\n \"image\": \"hello-world\",\n\n- **service**: Specify the Cloud Run service to use.\n\n The following sample shows how to specify a service name, port, and resource\n limits: \n\n \"service\": {\n \"name\": \"hello-world\",\n \"containerPort\": 8080,\n \"resources\": {\n \"limits\": {\n \"memory\": \"256Mi\"\n }\n }\n },\n\n- **debug**: Specify debug settings such as remote path mapping to map a local\n path to a path on the remote container.\n\n The following sample shows a debug section that indicates the source files'\n location: \n\n \"debug\": {\n \"sourceFileMap\": {\n \"${workspaceFolder}\": \"/app\"\n }\n }\n\nGet Support\n-----------\n\nTo send feedback, report issues on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-vscode/issues), or ask a question on [Stack Overflow](https://stackoverflow.com/questions/ask?tags=cloud-code-vscode)."]]