Documentação do Cloud Run
O Cloud Run é uma plataforma de aplicativos totalmente gerenciada que permite executar
contêineres que podem ser invocados por meio de solicitações ou eventos.
O Cloud Run não tem servidor. Ele abstrai todo o
gerenciamento da infraestrutura para que você se concentre no que mais importa: criar
aplicativos incríveis. Saiba mais.
Comece sua prova de conceito com US $300 em crédito sem custos financeiros
-
Acessar o Gemini 2.0 Flash Thinking
-
Uso mensal gratuito de produtos conhecidos, incluindo APIs de IA e BigQuery
-
Sem cobranças automáticas, sem compromisso
Continue explorando com mais de 20 produtos sempre gratuitos
Acesse mais de 20 produtos gratuitos para casos de uso comuns, incluindo APIs de IA, VMs, data warehouses e
muito mais.
Treinamento
Treinamento e tutoriais
Pub/Sub com o Cloud Run
Saiba como gravar, implantar e chamar um serviço do Cloud Run com base em uma assinatura de push do Pub/Sub.
Treinamento
Treinamento e tutoriais
Tutorial: como processar imagens do Cloud Storage
Use o Cloud Run, a API Cloud Vision e o ImageMagick para detectar e desfocar imagens ofensivas enviadas para um bucket do Cloud Storage.
Treinamento
Treinamento e tutoriais
Tutorial: como proteger serviços do Cloud Run
Crie um aplicativo seguro de dois serviços para execução no Cloud Run. Esse aplicativo é um editor Markdown que inclui um serviço "front-end" público que qualquer pessoa pode usar para escrever texto de remarcação e um serviço de "back-end" particular que renderiza o texto do Markdown em HTML.
Treinamento
Treinamento e tutoriais
Solução de problemas locais de um serviço do Cloud Run
Resolva problemas de um serviço do Cloud Run com falha usando as ferramentas do Google Cloud Observability para descoberta e um fluxo de trabalho de desenvolvimento local para investigação. Neste tutorial, usamos um projeto de amostra que resulta em erros de ambiente de execução quando implantado para você encontrar e corrigir o problema.
Treinamento
Treinamento e tutoriais
Executar inferência de LLM em GPUs do Cloud Run com o Gemma 3 e o Ollama
Saiba como implantar o Gemma 3 do Google em um serviço do Cloud Run ativado para GPU.
Treinamento
Treinamento e tutoriais
Olá, Cloud Run
O objetivo deste laboratório é criar uma imagem de contêiner e implantá-la no Cloud Run. Neste laboratório, você aprenderá a dar os primeiros passos com o Cloud Run por meio da implantação e da execução de um contêiner sem estado.
star
star
star
star
star_half
45 minutos
introdução
5 créditos
Treinamento
Treinamento e tutoriais
Crie um sistema resiliente e assíncrono com o Cloud Run e o Pub/Sub
Nos laboratórios da Quest para o Google Cloud Run sem servidor, você lerá um cenário de negócios fictício em cada laboratório e ajudará na implementação de uma solução sem servidor.
star
star
star
star
star_half
1 hora
introdução
7 créditos
Caso de uso
Casos de uso
Serviços da Web: back-end de APIs REST
Aplicativos modernos para dispositivos móveis geralmente contam com APIs RESTful de back-end para fornecer informações atuais sobre o aplicativo e separar as equipes de desenvolvimento de front-end e back-end. Os serviços de API executados no Cloud Run permitem que os desenvolvedores mantenham os dados em segurança em bancos de dados gerenciados, como Cloud SQL ou Firestore (NoSQL). Faça login no Cloud Run e conceda acesso aos usuários a dados de recursos de apps armazenados nos bancos de dados do Cloud.
Serviços da Web
API
Cloud SQL
Firestore
back-end
Caso de uso
Casos de uso
Serviços da Web: administração de back‐office
A administração de back‐office com frequência exige documentos, planilhas e outras integrações personalizadas, além da execução de um aplicativo da Web de um fornecedor. Hospedar um aplicativo da Web interno em contêineres no Cloud Run significa que ele sempre estará pronto, e você será cobrado apenas quando ele for usado.
Serviços da Web
back office
administração
Caso de uso
Casos de uso
Crie aplicativos de processamento de dados no Cloud Run que transformam dados leves quando eles chegam e armazene-os como dados estruturados. As transformações podem ser acionadas em origens do Google Cloud. Quando um arquivo .csv for criado, um evento será enviado e entregue a um serviço do Cloud Run. Em seguida, os dados são extraídos, estruturados e armazenados em uma tabela do BigQuery.
Serviços da Web
processamento de dados
dados estruturados
transformações
Caso de uso
Casos de uso
Automação: geração programada de documentos
Programe um job mensal com o Cloud Scheduler para gerar faturas usando um serviço do Cloud Run. Como os contêineres com binários personalizados podem ser implantados no Cloud Run, é possível executá-lo em uma ferramenta de geração de PDF, como o LibreOffice, sem servidor. Assim, você só paga quando gerar faturas.
Automação
Programação de jobs
Caso de uso
Casos de uso
Automação: fluxo de trabalho com webhooks
Conecte suas operações com uma abordagem voltada para eventos. O Cloud Run escalona sob demanda e, ao mesmo tempo, implementa um destino de webhook, enviando eventos na forma de solicitações e cobrando apenas quando você receber e processar o evento. Reaja a eventos do GitHub ou do Slack ou envie webhooks quando uma compra for feita, um trabalho estiver pronto ou um alerta for disparado com um serviço que consegue reagir em tempo hábil para acionar um microsserviço na sua infraestrutura.
Automação
fluxo de trabalho comercial
webhooks
eventos.
Caso de uso
Casos de uso
Como migrar apps Node.js do Heroku para o Cloud Run
Saiba como migrar apps da Web Node.js em execução no Heroku para o Cloud Run no Google Cloud. Este tutorial é destinado a arquitetos e proprietários de produtos que querem migrar apps do Heroku para serviços gerenciados no Google Cloud.
Node.js
Migração
Caso de uso
Casos de uso
Caminho de modernização para aplicativos .NET no Google Cloud
Neste documento, analisamos as limitações comuns dos aplicativos monolíticos e descrevemos um processo gradual, mas estruturado, para modernizá-los. Ele é destinado a arquitetos de nuvem, administradores de sistema e CTOs familiarizados com o ecossistema Windows e .NET e que querem saber mais sobre a modernização.
.NET
Modernização
Migração
Exemplo de código
Exemplos de código
Como iniciar um projeto do Cloud Run com base em um modelo
Inicie um app com base em um modelo do Intellij, incluindo modelos Flask, Django, Node.js, Java e Go.
Exemplo de código
Exemplos de código
Exemplos Node.js
Inclui exemplos HelloWorld, do Pub/Sub, do Cloud SQL, de processamento de imagens e muitos outros.
Exemplo de código
Exemplos de código
Amostras em Python
Inclui exemplos do HelloWorld, do Pub/Sub e do Cloud SQL
Exemplo de código
Exemplos de código
Amostras em Go
Inclui exemplos HelloWorld, do Pub/Sub, do Cloud SQL, de processamento de imagens e muitos outros.
Exemplo de código
Exemplos de código
Exemplos em Java
Inclui exemplos HelloWorld, do Pub/Sub, do Cloud SQL, de processamento de imagens e muitos outros.
Exemplo de código
Exemplos de código
.Net HelloWorld
Amostra do .NET para o Cloud Run
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-21 UTC.
[[["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,["# Cloud Run documentation\n=======================\n\n[Read product documentation](/run/docs/overview/what-is-cloud-run)\nCloud Run is a fully managed application platform that lets you run\ncontainers that are invocable via requests or events.\nCloud Run is serverless: it abstracts away all\ninfrastructure management, so you can focus on what matters most---building\ngreat applications. [Learn more](/run/docs/overview/what-is-cloud-run).\n[Get started for free](https://console.cloud.google.com/freetrial) \n\n#### Start your proof of concept with $300 in free credit\n\n- Get access to Gemini 2.0 Flash Thinking\n- Free monthly usage of popular products, including AI APIs and BigQuery\n- No automatic charges, no commitment \n[View free product offers](/free/docs/free-cloud-features#free-tier) \n\n#### Keep exploring with 20+ always-free products\n\n\nAccess 20+ free products for common use cases, including AI APIs, VMs, data warehouses,\nand more.\n\nDocumentation resources\n-----------------------\n\nFind quickstarts and guides, review key references, and get help with common issues. \nformat_list_numbered\n\n### Guides\n\n-\n\n\n Quickstarts:\n [Service](/run/docs/quickstarts/deploy-container),\n\n [Job](/run/docs/quickstarts/jobs/create-execute),\n or\n [Function](/run/docs/quickstarts/functions/deploy-functions-console)\n\n\n-\n\n [Learn about the Cloud Run container runtime contract](/run/docs/container-contract)\n\n-\n\n [Deploy container images](/run/docs/deploying)\n\n-\n\n [Continuous deployment from Git](/run/docs/continuous-deployment-with-cloud-build)\n\n-\n\n [Deploy a function](/run/docs/deploy-functions)\n\n-\n\n [Map custom domains](/run/docs/mapping-custom-domains)\n\n-\n\n [Add authentication to Cloud Run apps](/run/docs/securing/identity-aware-proxy-cloud-run)\n\nfind_in_page\n\n### Reference\n\n-\n\n [gcloud commands](/sdk/gcloud/reference/run)\n\n-\n\n [Container runtime contract](/run/docs/reference/container-contract)\n\n-\n\n [IAM Roles](/run/docs/reference/iam/roles)\n\n-\n\n [Configuration options for Cloud Run services](/run/docs/configuring)\n\ninfo\n\n### Resources\n\n-\n\n [Pricing](/run/pricing)\n\n-\n\n [Release notes](/run/docs/release-notes)\n\n-\n\n [Locations](/run/docs/locations)\n\n-\n\n [Support](/run/docs/support)\n\nRelated resources\n-----------------\n\nTraining and tutorials \nUse cases \nCode samples \nExplore self-paced training, use cases, reference architectures, and code samples with examples of how to use and connect Google Cloud services. Training \nTraining and tutorials\n\n### Pub/Sub with Cloud Run\n\n\nLearn how to write, deploy, and call a Cloud Run service from a Pub/Sub push subscription.\n\n\n[Learn more](/run/docs/tutorials/pubsub) \nTraining \nTraining and tutorials\n\n### Processing images from Cloud Storage tutorial\n\n\nUse Cloud Run, Cloud Vision API, and ImageMagick to detect and blur offensive images uploaded to a Cloud Storage bucket.\n\n\n[Learn more](/run/docs/tutorials/image-processing) \nTraining \nTraining and tutorials\n\n### Securing Cloud Run services tutorial\n\n\nCreate a secure two-service application running on Cloud Run. This application is a Markdown editor which includes a public \"frontend\" service which anyone can use to compose markdown text, and a private \"backend\" service which renders Markdown text to HTML.\n\n\n[Learn more](/run/docs/tutorials/secure-services) \nTraining \nTraining and tutorials\n\n### Local troubleshooting of a Cloud Run service\n\n\nTroubleshoot a broken Cloud Run service using Google Cloud Observability tools for discovery and a local development workflow for investigation. This tutorial uses a sample project that results in runtime errors when deployed, which you troubleshoot to find and fix the problem.\n\n\n[Learn more](/run/docs/tutorials/local-troubleshooting) \nTraining \nTraining and tutorials\n\n### Run LLM inference on Cloud Run GPUs with Gemma 3 and Ollama\n\n\nLearn how to deploy Google's Gemma 3 on a GPU-enabled Cloud Run service.\n\n\n[Learn more](/run/docs/tutorials/gpu-gemma-with-ollama) \nTraining \nTraining and tutorials\n\n### Hello Cloud Run\n\n\nThe goal of this lab is for you to build a container image and deploying it to Cloud Run. In this lab, you'll learn how to get started with Cloud Run by deploying and running a stateless container.\n\n\nstar star star star star_half\n45 minutes introductory 5 credits\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://www.cloudskillsboost.google/focuses/5162?parent=catalog) \nTraining \nTraining and tutorials\n\n### Build a Resilient, Asynchronous System with Cloud Run and Pub/Sub\n\n\nFor the labs in the Google Cloud Run Serverless Quest, you will read through a fictitious business scenario in each lab and assist the characters in implementing a serverless solution.\n\n\nstar star star star star_half\n1 hour introductory 7 credits\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://www.cloudskillsboost.google/focuses/8389?parent=catalog) \nUse case \nUse cases\n\n### Web services: REST APIs backend\n\n\nModern mobile apps commonly rely on RESTful backend APIs to provide current views of application data and separation for frontend and backend development teams. API services running on Cloud Run allow developers to persist data reliably on managed databases such as Cloud SQL or Firestore (NoSQL). Logging in to Cloud Run grants users access to app‐resource data stored in Cloud Databases.\n\nWeb services API Cloud SQL Firestore backend\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/triggering/https-request) \nUse case \nUse cases\n\n### Web services: Back‐office administration\n\n\nBack‐office administration often requires documents, spreadsheets, and other custom integrations, and running a vendor‐supplied web application. Hosting the containerized internal web application on Cloud Run means it is always ready and you are only billed when it is used.\n\nWeb services back office administration\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/tutorials/identity-platform) \nUse case \nUse cases\n\n### Data processing: Lightweight data transformation\n\n\nBuild Cloud Run data processing applications that transform lightweight data as it arrives and store it as structured data. Transformations can be triggered from Google Cloud sources. When a .csv file is created, an event is fired and delivered to a Cloud Run service. Data is then extracted, structured, and stored in a BigQuery table.\n\nWeb services data processing structured data transformations\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/tutorials/image-processing) \nUse case \nUse cases\n\n### Automation: Scheduled document generation\n\n\nSchedule a monthly job with Cloud Scheduler to generate invoices using a Cloud Run service. Because containers containing custom binaries can be deployed to Cloud Run, it is able to run in a PDF generation tool like LibreOffice in a serverless way, which means only paying when you are generating invoices.\n\nAutomation job scheduling\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/triggering/using-scheduler) \nUse case \nUse cases\n\n### Automation: Business workflow with webhooks\n\n\nConnect your operations together with an event‐driven approach. Cloud Run scales on demand while implementing a webhook target, pushing events in the form of requests and only charging you when you receive and process the event. React to events from GitHub or Slack, or send webhooks when a purchase is made, a job is ready, or an alert is fired with a service that can react on a just‐in‐time basis to trigger a microservice in your infrastructure.\n\nAutomation business workflow webhooks events\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/triggering/webhooks) \nUse case \nUse cases\n\n### Migrating Node.js apps from Heroku to Cloud Run\n\n\nLearn how to migrate Node.js web apps that are running on Heroku to Cloud Run on Google Cloud. This tutorial is intended for architects and product owners who want to migrate their apps from Heroku to managed services on Google Cloud.\n\nNode.js Migration\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/migrate/migrating-nodejs-apps-from-heroku-to-cloud-run) \nUse case \nUse cases\n\n### Modernization path for .NET applications on Google Cloud\n\n\nThis document looks at the common limitations of monolithic applications and describes a gradual yet structured process for modernizing them. This document is intended for cloud architects, system administrators, and CTOs who are familiar with Windows and the .NET ecosystem and want to learn more about what modernization involves.\n\n.NET Modernization Migration\n\n\u003cbr /\u003e\n\n[Learn more](/solutions/modernization-path-dotnet-applications-google-cloud) \nCode sample \nCode Samples\n\n### Starting a Cloud Run project from a template\n\n\nStart your app from a template within Intellij, including Flask, Django, Node.js, Java, and Go templates.\n\n\n[Get started](/code/docs/intellij/creating-a-cloud-run-app) \nCode sample \nCode Samples\n\n### Node.js samples\n\n\nIncludes HelloWorld, Pub/Sub, Cloud SQL examples, image processing, and many others.\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/run/helloworld/) \nCode sample \nCode Samples\n\n### Python samples\n\n\nIncludes HelloWorld, Pub/Sub, and Cloud SQL examples\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/python-docs-samples/blob/master/run/) \nCode sample \nCode Samples\n\n### Go samples\n\n\nIncludes HelloWorld, Pub/Sub, Cloud SQL examples, image processing, and many others.\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/golang-samples/tree/master/run/) \nCode sample \nCode Samples\n\n### Java samples\n\n\nIncludes HelloWorld, Pub/Sub, Cloud SQL examples, image processing, and many others.\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/java-docs-samples/tree/master/run/) \nCode sample \nCode Samples\n\n### .Net HelloWorld\n\n\n.Net sample for Cloud Run\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/dotnet-docs-samples/tree/main/run/helloworld)\n\nRelated videos\n--------------"]]
