Se você não tiver um arquivo .vscode/launch.json definido, a caixa de diálogo
Run/Debug on Cloud Run Emulator vai permitir que você configure a inicialização e
salve as configurações em .vscode/launch.json. Se você tiver um arquivo
.vscode/launch.json configurado, poderá editá-lo diretamente.
Para executar o serviço localmente, especifique a configuração:
Abra a paleta de comandos (pressione Ctrl/Cmd+Shift+P ou clique em Visualizar >
Paleta de comandos) e execute o comando Run on Cloud Run Emulator.
Na caixa de diálogo "Run/Debug no Cloud Run Emulator", defina as
especificações para sua configuração:
Somente ferramentas de build instaladas localmente estão disponíveis para o emulador do Cloud Run.
Escolha Docker ou Buildpacks como seu builder e especifique a
fonte.
(Opcional) Para especificar variáveis de ambiente a serem transmitidas aos contêineres
em execução, expanda Configurações avançadas de build e clique para especificar
pares de chave-valor.
Nome
Descrição
Exemplo
PORT
A porta que o servidor HTTP vai detectar.
8080
K_SERVICE
O nome do serviço do Cloud Run em execução.
hello-world
K_REVISION
O nome da revisão do Cloud Run em execução.
hello-world.1
K_CONFIGURATION
O nome da configuração do Cloud Run que criou
a revisão.
hello-world
(Opcional) Para especificar conexões do Cloud SQL, expanda
Configurações avançadas do serviço, clique em Conexões e especifique uma
conexão do Cloud SQL por linha.
(Opcional) Marque a opção
Fazer o serviço acessível em outros dispositivos na rede local.
(Opcional) Se você quiser recriar e executar o serviço manualmente, em vez de automaticamente quando fizer uma alteração, desmarque a opção Recriar e executar automaticamente nas alterações.
Como executar o serviço localmente
Depois de definir as configurações preferenciais, execute o serviço clicando em Run.
Monitore o status da sua implantação na janela de saída.
Após a conclusão da implantação, veja o serviço em execução abrindo
o URL exibido na janela de saída.
Para ver registros detalhados, alterne para a visualização detalhada do Cloud Run na janela de saída.
Depois que a sessão for concluída, clique com o botão direito do mouse para usar os seguintes comandos:
Acessar registros:abra os registros do aplicativo de uma implantação específica com o
explorador de registros do Cloud Code.
Open URL:abra o URL do serviço do aplicativo de um serviço
específico em um navegador da Web.
Se você desativou o modo de exibição na configuração de inicialização e quer
fazer alterações no aplicativo e recriá-lo e reimplantá-lo,
clique na barra de status do Cloud Code e em
Ativar o modo de exibição.
Para interromper a implantação, clique no botão Parar na barra de ações da implantação atual.
Como armazenar chaves secretas
Se o código inclui dados possivelmente confidenciais, como chaves de API, senhas e
certificados, armazená-los como secrets pode ajudar a protegê-los. A
integração do Cloud Code com o Secret Manager permite armazenar esses secrets com segurança
e buscá-los de maneira programática. Para uma visão detalhada de
como criar e gerenciar secrets com o Cloud Code, consulte o
guia do Secret Manager.
Como personalizar uma configuração launch.json
O plug-in do Cloud Code atualiza o arquivo de configuração launch.json
automaticamente quando você escolhe uma ação de execução. Para personalizar ainda mais a execução do
serviço, especifique os seguintes campos no arquivo
.vscode/launch.json:
watch: detecta alterações no espaço de trabalho e executa novamente
o serviço. "True" por padrão.
O exemplo a seguir mostra o relógio definido como true:
"watch":true,
build: especifique o construtor
(Docker,
jibMaven, jibGradle ou
buildpacks)
para criar as imagens.
O exemplo a seguir mostra um builder do Docker:
"build":{"docker":{"path":"Dockerfile"}},
O exemplo a seguir mostra um builder de buildpack:
debug: especifica as configurações de depuração, como o mapeamento de caminho remoto, para mapear um caminho local
para um caminho no contêiner remoto.
O exemplo a seguir mostra uma seção de depuração que indica o local dos arquivos de origem:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-11 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)."]]
