Faça a gestão de funções

Este guia mostra como gerir e desanexar uma função que foi criada com o comando gcloud functions. Para saber como gerir uma função criada com o comando gcloud run, consulte o artigo Gerir serviços do Cloud Run.

As funções criadas com a API Cloud Functions v2 (por exemplo, através da gcloud functions, da API REST ou do Terraform) podem ser geridas com a API Cloud Run Admin, bem como com a API Cloud Functions v2. Por exemplo, pode atualizar uma função existente através dos comandos gcloud functions ou gcloud run:

gcloud functions 

  gcloud functions deploy FUNCTION_NAME \
    --runtime=nodejs22 \
    --source= . \
    --entry-point=ENTRYPOINT
    --trigger-http

gcloud run 

gcloud run deploy FUNCTION_NAME \
  --source= . \
  --function=ENTRYPOINT
  --base-image=google-22-full/nodejs22

Desanexar

O comando gcloud functions detach permite desassociar uma função do Cloud Functions v2 do respetivo ambiente de API existente. Depois de desanexar uma função, só a pode gerir através da API Cloud Run Admin. Pode querer fazê-lo se as suas cargas de trabalho tiverem de permanecer no limite da API para Assured Workloads ou para garantir que as suas cargas de trabalho usam a SKU do Cloud Run.run.googleapis.com

Prepare a sua função para a desassociação

Quando se preparar para desanexar a função, considere o seguinte:

  • A operação de desassociação não é reversível.
  • Não é possível aplicar a operação de desassociação a funções do Cloud Run (1.ª geração).
  • Familiarize-se com a forma de implementar funções no Cloud Run através da Google Cloud consola, da CLI Google Cloud e do Terraform.
  • As funções HTTP mantêm os URLs atribuídos.
  • Os acionadores anexados a funções orientadas por eventos são mantidos.
  • Não é possível gerir acionadores diretamente através da API run.googleapis.com. Certifique-se de que se familiariza com os guias de gestão de acionadores para o Eventarc ou o Pub/Sub.
  • A desativação da opção Repetir em caso de falha não é uma funcionalidade suportada no Cloud Run.
    • Durante a operação de desassociação, as funções do Cloud Run modificam os acionadores anexados a funções configuradas com sem nova tentativa em caso de falha para garantir que o tópico do Pub/Sub subjacente faz um máximo de cinco tentativas de entrega. Quando a operação de desanexação estiver concluída, um tópico de fila de mensagens rejeitadas armazena as mensagens não entregues, que pode obter criando uma nova subscrição para a fila de mensagens rejeitadas.
  • Quando uma função é desanexada com êxito, é criada uma nova revisão do Cloud Run. A partir dessa revisão, a função é faturada através do SKU do Cloud Run.

Desassocie a sua função

Pode desassociar a sua função através do seguinte comando:

gcloud functions detach FUNCTION_NAME

Substitua FUNCTION_NAME pelo nome da sua função.