Desenvolver um serviço localmente no Cloud Code para IntelliJ
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com o Cloud Code, é possível desenvolver seus serviços
do Cloud Run localmente em um ambiente semelhante ao Cloud Run. O Cloud Code monitora as alterações na origem e atualiza rapidamente o serviço em execução para refletir essas alterações.
Como definir a configuração de execução
Antes de executar o serviço, é preciso criar a configuração de execução:
Navegue até o seletor de configurações de execução/depuração na barra de navegação e
clique em Edit Configurations.
No Cloud Code: Cloud Run, escolha Cloud Run: Run Locally.
Se você quiser que o Cloud Code reimplante o aplicativo automaticamente
após as alterações serem salvas, em Watch mode - rebuild and
redeploy, selecione On file save. Os novos serviços do Cloud Run têm a opção Sob demanda selecionada por padrão. Para mais informações sobre os modos de exibição, consulte
Modos de observação.
Especifique a opção do criador e as configurações relevantes.
O Cloud Code é compatível com tipos de artefato
do Docker, Jib e Buildpacks.
Clique em OK.
Opcional: como personalizar sua configuração
Ao desenvolver localmente, é possível especificar outras configurações, como uma conta de
serviço, variáveis de ambiente e conexões SQL ao usar
o Cloud Run (totalmente gerenciado), na seção Configurações de revisão avançadas ao
escolher Editar configurações.
Variáveis de ambiente
As variáveis de ambiente a seguir são adicionadas automaticamente aos
contêineres em execução:
Nome
Descrição
Exemplo
PORTA
A porta que o servidor HTTP deve 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
Como armazenar chaves secretas
Se o código inclui dados possivelmente confidenciais, como chaves de API, senhas e
certificados, é recomendável armazená-los como secrets. O
Cloud Code permite armazenar esses secrets com segurança no Gerenciador de secrets
e buscá-los de maneira programática quando precisar deles. Para uma visão detalhada de
como criar e gerenciar secrets com o Cloud Code, consulte o
guia do Gerenciador de secrets.
Como executar o serviço
Para executar o serviço, siga estas etapas:
Escolha o destino de execução Cloud Run: Executar localmente no seletor de configurações de
execução/depuração, na barra de navegação.
Clique em Cloud Run: executar localmente.
Visualize os registros do serviço em execução, transmitidos diretamente para a janela de saída.
Após a conclusão da implantação, será possível ver o serviço em execução seguindo o
URL exibido no painel "Log de eventos". No exemplo abaixo, esse URL é
http://localhost:8080.
Receber suporte
Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse
Tools > Cloud Code > Help / About > Envie
feedback ou informe um problema para informar um problema no GitHub.
[[["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-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: executar localmente.