Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, descrevemos alguns itens que você precisa conhecer para começar a desenvolver
um serviço para o Cloud Run.
Exigências de código
Atenda aos requisitos a seguir ao desenvolver um serviço:
O serviço precisa detectar solicitações.
É possível configurar a porta
em que as solicitações são enviadas.
Dentro das instâncias de contêiner do Cloud Run, o valor da variável de ambiente
PORT sempre reflete a porta para a qual as solicitações são enviadas.
O código precisa verificar a existência da variável de ambiente
PORT e, se ela estiver presente, detectá-la para maximizar a portabilidade.
O serviço precisa ser do tipo sem estado. Ele não pode depender de um estado local permanente.
Se o serviço executa atividades em segundo plano fora do escopo do processamento
de solicitações, ele precisa usar a configuração de
faturamento baseado em instâncias
para ter a CPU alocada fora do ciclo de solicitação padrão.
A implantação de origem do Cloud Run oferece suporte a vários ambientes de execução de linguagem, cada um deles disponível por imagens de base de contêiner fornecidas pelos buildpacks do Google Cloud. Você também pode usar outras linguagens de programação ou frameworks, desde que o código-fonte esteja em uma imagem compatível com OCI.
Use um servidor da Web para realizar detecções na porta necessária, bem como para processar e rotear solicitações recebidas. Por exemplo, os desenvolvedores do Node.js podem usar o
Express.js, os desenvolvedores do Python podem usar o
Flask, os desenvolvedores do Ruby podem usar o
Sinatra, e assim por diante.
Você pode receber ajuda com tecnologia de IA do chat do Gemini Cloud Assist para projetar aplicativos de maneira ideal. Com o Gemini Cloud Assist, você pode
descobrir as configurações e estratégias mais adequadas para implantar seus
aplicativos no Cloud Run, garantindo o uso eficiente dos recursos
e uma operação perfeita.
Para usar o Gemini Cloud Assist no Google Cloud console, faça o seguinte:
Na barra de ferramentas do console, selecione um projeto do Google Cloud . Use um projeto associado a um ID do projeto que você enviou depois de receber acesso ao Gemini Cloud Assist.
Clique em brilhoAbrir ou fechar o chat do Gemini AI.
O painel do Gemini será aberto.
Se necessário, clique em Aceitar se você concordar com os termos.
Se você tiver uma dúvida sobre um aplicativo específico, forneça contexto acessando a página que mostra seu recurso antes de fazer a pergunta. Ao
gerar uma resposta, o Gemini inclui informações sobre a
página atual do console e o projeto.
Insira um comando no painel do Gemini.
A tabela a seguir mostra alguns exemplos de comandos para usar o Gemini Cloud Assist com o Cloud Run.
Comando
Tipo de resposta
"Quero criar um app Node.js no Cloud Run. Qual é a abordagem recomendada e o que eu preciso saber?"
Resumo de como contêinerizar seu app, estruturar seu app Node.js e o processo de implantação.
"Quais permissões são necessárias para implantar um app do Cloud Run?"
Lista de permissões e papéis necessários.
"Quero implantar um aplicativo da Web de três camadas usando o Cloud Run"
Descrição geral das etapas para projetar um app da Web de três níveis.
"Como migro meu app do App Engine para o Cloud Run?"
Visão geral de alto nível das principais etapas para preparar seu ambiente de desenvolvimento do Cloud Run e algumas diferenças importantes entre os dois produtos. Links para um tutorial de exemplo que pode ser usado para personalizar a solução e atender às suas necessidades específicas.
"Qual é o comando da CLI gcloud para atualizar a configuração de instância mínima para 2 no meu serviço do Cloud Run 'example-service'?"
Comando sugerido da CLI gcloud para atualizar a configuração de número mínimo de instâncias.
"Como faço para atualizar minha conta de serviço do serviço do Cloud Run hello-world?"
Comando sugerido da CLI gcloud para atualizar a conta de serviço.
"Mostre um exemplo de como criar um app de IA generativa no Cloud Run com o LangChain"
Etapas para criar um app de exemplo usando o Cloud Run com o LangChain.
"Gere uma configuração do Terraform usando o recurso google_cloud_run_v2_service para um serviço do Cloud Run que define a configuração de faturamento como faturamento baseado em instâncias"
Configuração sugerida do Terraform para atualizar a configuração de faturamento.
[[["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-21 UTC."],[],[],null,["# Developing your service\n\nThis page describes a few things you need to know to get started in developing\na service for Cloud Run.\n\nCode requirements\n-----------------\n\nYou must meet the following requirements when you develop a service:\n\n- The service must listen for requests. You can [configure the port](/run/docs/configuring/services/containers#configure-port) on which requests are sent. Inside Cloud Run instances, the value of the `PORT` environment variable always reflects the port to which requests are sent. Your code should check for the existence of this `PORT` environment variable and if it is present, should listen on it to maximize portability.\n- The service must be *stateless* . It cannot rely on a persistent **local** state.\n- If the service performs background activities outside the scope of request handling it must use the [instance-based billing](/run/docs/configuring/billing-settings#choosing-background-execution) setting in order to have CPU allocated outside of the standard request cycle.\n- If your service uses NFS, it must use the [second generation execution environment](/run/docs/about-execution-environments).\n\nYou can find more details about these constraints in the [Container runtime contract](/run/docs/reference/container-contract).\n\nProgramming language support\n----------------------------\n\nCloud Run source deployment conveniently supports multiple\n[language runtimes](/run/docs/configuring/services/runtime-base-images), each of\nwhich is available through container base images provided by\nGoogle Cloud's buildpacks. You can also use other programming languages or\nframeworks, as long as the source code is in an OCI-compliant image.\n\nThe [build and deploy quickstarts](/run/docs/quickstarts#build-and-deploy-a-web-service)\nprovides samples in many popular languages.\n\nUsing a web server\n------------------\n\nYou can use a web server to listen on the required port, and to process and\nroute incoming requests. For example, Node.js developers can use\n[Express.js](https://expressjs.com/), Python developers can use\n[Flask](http://flask.pocoo.org/), Ruby developers can use\n[Sinatra](http://sinatrarb.com/), and so forth.\n\nContainerizing your code\n------------------------\n\nSee [Containerize your code](/run/docs/building/containerize-your-code) for\ndetails.\n\nDesign Cloud Run apps with Gemini assistance\n--------------------------------------------\n\n\u003cbr /\u003e\n\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nYou can get AI-powered help from\n[Gemini Cloud Assist](/gemini/docs/cloud-assist/overview) chat to\ndesign applications optimally. With Gemini Cloud Assist, you can\ndiscover the most suitable configurations and strategies for deploying your\napplications on Cloud Run, ensuring efficient resource\nutilization and seamless operation.\n\nTo use Gemini Cloud Assist from the Google Cloud console, do\nthe following:\n\n1. [Ensure that Gemini Cloud Assist is set up for your Google Cloud user account and project](/gemini/docs/cloud-assist/set-up-gemini).\n\n2. [Set up your Cloud Run development environment](/run/docs/setup)\n in your Google Cloud project and ensure you have the appropriate\n [deployment permissions](/run/docs/reference/iam/roles#additional-configuration).\n\n3. Go to the Cloud Run page in the Google Cloud console.\n\n [Go to Cloud Run](https://console.cloud.google.com/run)\n4. In the console toolbar, select a Google Cloud project. Use a project\n associated with a project ID you submitted after you were granted access to\n Gemini Cloud Assist.\n\n5. Click spark\n **Open or close Gemini AI chat**.\n\n The Gemini panel opens.\n6. If necessary, click **Accept** if you agree to the terms.\n\n7. If you have a question about a specific application, provide context by\n going to the page that shows your resource before asking your question. When\n generating a response, Gemini includes information about the\n current console page and project.\n\n8. Enter a prompt in the **Gemini** panel.\n\n The following table provide some example prompts for using\n Gemini Cloud Assist with Cloud Run.\n\nFor more details, see the following resources:\n\n- Learn how to [write better prompts](/gemini/docs/discover/write-prompts).\n- Learn how to use the [Gemini Cloud Assist panel](/gemini/docs/cloud-assist-panel).\n- Read [Use Gemini for AI assistance and development](/gemini/docs/overview).\n- Learn [how Gemini for Google Cloud uses your data](/gemini/docs/discover/data-governance).\n\nWhat's next\n-----------\n\n- Once you have your service code and Dockerfile, you should [build a container image](/run/docs/building/containers) then continue iterating in [local testing](/run/docs/testing/local).\n- If you are migrating an existing web application, see [Migrating Your Service to Cloud Run](/run/docs/migrating).\n- For best practices for designing, implementing, testing, and deploying a Cloud Run service, see the [Development tips](/run/docs/tips)."]]
