Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste guia, mostramos como preparar um serviço da Web para ser executado em um contêiner no Cloud Run. A migração de dados não é um tópico nesta página.
Essa é a mesma porta que você usaria ao invocar o serviço na máquina
local. Por exemplo, se for testar seu código, abra localhost:3000 e depois defina
a porta do contêiner como
3000 no Cloud Run.
O padrão do Cloud Run é enviar solicitações para 8080.
O valor da porta para onde as solicitações são enviadas está sempre disponível na
variável de ambiente PORT. É uma prática recomendada que seu código detecte
o valor definido pela variável de ambiente PORT, se possível.
Remover dependência do sistema de arquivos local para armazenamento permanente
Verifique se o código do aplicativo pode ser usado nos sistemas de arquivos locais e substitua-o
pelo armazenamento de arquivos no Cloud Storage ou em armazenamento de dados, como
Firestore ou Cloud SQL.
Adicionar um Dockerfile
Para inserir o serviço em um contêiner, use um Dockerfile para
definir o ambiente operacional. O guia de início rápido para criar e implantar mostra alguns Dockerfiles básicos que podem ser usados nos primeiros passos.
Certifique-se de que seu limite de memória seja alto o suficiente para que seu aplicativo seja executado, incluindo a capacidade de armazenamento temporário de arquivos que seu serviço exigir.
Enviar registros para stdout, stderr ou /var/log
O Cloud Run usa automaticamente o Google Cloud Observability para agregar e analisar seus registros, conforme descrito na página de geração de registros.
[[["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,["# Migrate an existing web service\n\nThis guide shows how to prepare a web service to run in a container on\nCloud Run. It does not cover data migration.\n\nIdentify the port your code is listening on\n-------------------------------------------\n\nYour service should listen for requests on a specific port. You must identify\nthis port and [configure Cloud Run to send requests to the same port](/run/docs/configuring/services/containers#command-line).\n\nThis is the same port you would use when invoking your service on your local\nmachine. For example, if to test your code you open `localhost:3000`, then [set\nthe container port](/run/docs/configuring/services/containers#command-line) to\n`3000` in Cloud Run.\n\nCloud Run defaults to sending requests to `8080`.\nThe value of the port to which requests are sent is always available in the\n`PORT` environment variable. It is a best practice for your code to listen on\nthe value defined by the `PORT` environment variable if possible.\n\nRemove reliance on local filesystem for persistent storage\n----------------------------------------------------------\n\nCheck your application code for reliance on local filesystems, and replace it\nwith file storage on [Cloud Storage](/storage) or data storage such as\n[Firestore](/firestore) or [Cloud SQL](/sql).\n\nAdd a `Dockerfile`\n------------------\n\nIn order to wrap your service in a container, you should use a Dockerfile to\ndefine the operating environment. The\n[build and deploy quickstart](/run/docs/quickstarts#build-and-deploy-a-web-service)\nshows some basic Dockerfiles you can use to get started.\n\nRead more about customizing your `Dockerfile` on the [Developing your service](/run/docs/developing#add-dockerfile)\npage.\n\nTune for concurrency and memory limits\n--------------------------------------\n\nLearn more about [how concurrency works](/run/docs/about-concurrency)\nthen optimize your service concurrency support in [development tips for tuning concurrency](/run/docs/tips#tuning-concurrency)\n\nMake sure your [memory limit](/run/docs/configuring/services/memory-limits) is high enough\nfor your application to run, including capacity for any temporary file storage\nyour service requires.\n\nSend logs to stdout, stderr, or /var/log\n----------------------------------------\n\nCloud Run automatically uses Google Cloud Observability to aggregate and\nreview your logs, as described in the [logging page](/run/docs/logging)."]]
