Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este guia oferece uma visão geral introdutória de como outros serviços do Google Cloud estão envolvidos no processo de implantação do Cloud Run functions.
Quando você implanta o código-fonte da função do Cloud Run,
ele é armazenado em um bucket do Cloud Storage. Em seguida, o Cloud Build cria
automaticamente seu código em uma imagem de contêiner e a envia para um
registro de imagens do Artifact Registry.
As funções do Cloud Run acessam essa imagem quando precisam executar
o contêiner para executar a função.
No diagrama a seguir, a caixa de funções do Cloud Run representa uma função implantada no Cloud Run usando a API Cloud Run Admin ou a API Cloud Functions. Normalmente, as funções mais recentes são implantadas usando a API Cloud Run Admin, e as mais antigas são implantadas usando a API Cloud Functions.
Figura 1. Um usuário prepara o código-fonte das funções e
o implanta no Cloud Run.
Dependendo da API usada ao implantar uma função, o seguinte acontece:
Se você implantou sua função usando a API Cloud Run Admin, o seguinte vai acontecer:
O código-fonte é enviado para um bucket do Cloud Storage sem período de armazenamento.
Se você estiver usando a criptografia padrão, o nome do bucket será
gerado automaticamente e chamado de
run-sources-PROJECT_ID-REGION.
O código-fonte é enviado ao Cloud Build, em que
os buildpacks do Google Cloud e o Functions Framework criam uma imagem
de contêiner. A conta de serviço do Cloud Build cria a imagem do contêiner. Por padrão, o Cloud Run usa o
tipo de máquina e2-standard-2
fornecido pelo Cloud Build.
A imagem do contêiner é enviada para o Artifact Registry por um bucket criado automaticamente
chamado REGION-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy.
A imagem é implantada no Cloud Run como um serviço.
É possível acionar ou invocar a função com o Eventarc, o
Pub/Sub ou outros gatilhos HTTP.
Se você implantou sua função usando a API Cloud Functions (v2), o seguinte vai acontecer:
O código-fonte é enviado para um bucket do Cloud Storage sem período de armazenamento.
O nome do bucket é gerado automaticamente e segue este formato:
Se você estiver usando a criptografia padrão, esse bucket será chamado de gcf-v2-sources-PROJECT_NUMBER-REGION.
Se você estiver protegendo seus dados com a CMEK, o bucket será chamado de
gcf-sources-PROJECT_NUMBER-REGION-CMEK_KEY_HASH.
O código-fonte é enviado ao Cloud Build, em que
os buildpacks do Google Cloud e o Functions Framework criam uma imagem
de contêiner. A conta de serviço do Cloud Build cria a imagem do contêiner. Por padrão, o Cloud Run usa o
tipo de máquina e2-standard-2
fornecido pelo Cloud Build.
A imagem do contêiner é enviada para o Artifact Registry por um bucket criado automaticamente
chamado REGION-docker.pkg.dev/PROJECT_ID/gcf-artifacts.
A imagem é implantada no Cloud Run como um serviço.
É possível acionar ou invocar a função com o Eventarc, o
Pub/Sub ou outros gatilhos HTTP.
Se você já criou funções com a API Cloud Functions, consulte o
guia de comparação do Cloud Run functions
para saber mais sobre as diferenças entre as duas versões do
Cloud Run functions.
[[["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-04 UTC."],[],[],null,["# Cloud Run functions overview\n\nThis guide provides an introductory overview of how other Google Cloud services\nare involved in the Cloud Run functions deployment process.\n\nBefore you begin\n----------------\n\nFamiliarize yourself with Cloud Run functions and source deployment\nconcepts from the\n[Cloud Run deployment options and resource model](/run/docs/resource-model)\nguide.\n\nArchitecture overview\n---------------------\n\nWhen you deploy your function's source code to Cloud Run functions,\nthat source code is stored in a Cloud Storage bucket. Cloud Build then\nautomatically builds your code into a container image and pushes that image to\nan Artifact Registry [image registry](/run/docs/deploy-functions#image-repository).\nCloud Run functions accesses this image when it needs to run the\ncontainer to execute your function.\n\nIn the following diagram, the Cloud Run functions box represents\na function that is deployed in Cloud Run, using either the\nCloud Run Admin API or the Cloud Functions API. Typically, newer functions\nare deployed using the Cloud Run Admin API, and older functions are deployed\nusing the Cloud Functions API.\n**Figure 1.** A user prepares functions source code and deploys it to Cloud Run.\n\nDepending on which API is used when deploying a function, the following occurs:\n\n- If you deployed your function using use the *Cloud Run Admin API*, the\n following occurs:\n\n 1. Your source code is uploaded to a Cloud Storage bucket that has no\n retention period.\n\n 1. If you're using default encryption, the name of the bucket is autogenerated and named `run-sources-`\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`-`\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e.\n 2. If you're protecting your data with [Customer-managed encryption keys (CMEK)](/kms/docs/cmek), the bucket name is not autogenerated, and you must provide a bucket name.\n 2. The source code is submitted to Cloud Build, where\n Google Cloud's buildpacks and the Functions Framework create a container\n image. Note that the Cloud Build service account builds the container\n image. Cloud Run defaults to using the\n [`e2-standard-2` machine type](/build/pricing)\n provided by Cloud Build.\n\n 3. Your container image is then uploaded to Artifact Registry through an auto-created\n bucket called \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e`-docker.pkg.dev/`\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`/cloud-run-source-deploy`.\n\n 4. The image is deployed to Cloud Run as a service.\n\n 5. You can trigger or invoke the function with Eventarc,\n Pub/Sub, or other HTTP triggers.\n\n- If you deployed your function using use the *Cloud Functions API (v2)*, the\n following occurs:\n\n 1. Your source code is uploaded to a Cloud Storage bucket that has no\n retention period.\n\n The name of the bucket is autogenerated and follows this format:\n 1. If you're using default encryption, this bucket is named `gcf-v2-sources-`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`-`\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e.\n 2. If you're protecting your data with CMEK, the bucket is named `gcf-sources-`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`-`\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e`-`\u003cvar translate=\"no\"\u003eCMEK_KEY_HASH\u003c/var\u003e.\n 2. The source code is submitted to Cloud Build, where\n Google Cloud's buildpacks and the Functions Framework create a container\n image. Note that the Cloud Build service account builds the container\n image. Cloud Run defaults to using the\n [`e2-standard-2` machine type](/build/pricing)\n provided by Cloud Build.\n\n 3. Your container image is then uploaded to Artifact Registry through an auto-created\n bucket called \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e`-docker.pkg.dev/`\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`/gcf-artifacts`.\n\n 4. The image is deployed to Cloud Run as a service.\n\n 5. You can trigger or invoke the function with Eventarc,\n Pub/Sub, or other HTTP triggers.\n\nWhat's next\n-----------\n\n- Learn about the [different types of functions](/run/docs/write-functions) and your options for [triggering functions](/run/docs/function-triggers).\n- If you previously created functions with the Cloud Functions API, see the [Cloud Run functions comparison guide](/run/docs/functions/comparison) to learn about the differences between the two versions of Cloud Run functions."]]