Gerenciar funções

Neste guia, mostramos como gerenciar e desconectar uma função criada com o comando gcloud functions. Para saber como gerenciar uma função criada com o comando gcloud run, consulte Gerenciar serviços do Cloud Run.

As funções criadas usando a API Cloud Functions v2 (por exemplo, usando gcloud functions, a API REST ou o Terraform) podem ser gerenciadas com a API Cloud Run Admin e a API Cloud Functions v2. Por exemplo, é possível atualizar uma função usando os comandos gcloud functions ou gcloud run:

gcloud functions

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

gcloud run

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

Remover

O comando gcloud functions detach permite separar uma função do Cloud Functions v2 do ambiente de API atual. Depois de separar uma função, só é possível gerenciá-la usando a API Cloud Run Admin. Isso pode ser útil se as cargas de trabalho precisarem permanecer dentro do limite da API run.googleapis.com para Assured Workloads ou para garantir que as cargas de trabalho usem a SKU do Cloud Run.

Preparar a função para remoção

Ao se preparar para separar a função, considere o seguinte:

A operação de remoção não é reversível.
A operação de remoção não pode ser aplicada ao Cloud Run functions (1ª geração).
Saiba como implantar funções no Cloud Run usando o console Google Cloud , a Google Cloud CLI e o Terraform.
As funções HTTP vão manter os URLs atribuídos.
Os acionadores anexados a funções orientadas a eventos serão mantidos.
Não é possível gerenciar os gatilhos diretamente pela API run.googleapis.com. Conheça os guias de gerenciamento de gatilhos do Eventarc ou do Pub/Sub.
Desativar a opção repetir em caso de falha não é um recurso compatível com o Cloud Run.
- Durante a operação de remoção, o Cloud Run functions modifica os gatilhos anexados a funções configuradas com nenhuma nova tentativa em caso de falha, para garantir que o tópico do Pub/Sub subjacente faça um máximo de cinco tentativas de entrega. Quando a operação de remoção for concluída, um tópico de fila de mensagens inativas vai armazenar as mensagens não entregues, que podem ser recuperadas criando uma nova assinatura para a fila. Se você quiser usar uma chave de criptografia gerenciada pelo cliente para o tópico da DLQ, atualize a CMEK do tópico após a separação.
Quando uma função é desvinculada, uma nova revisão do Cloud Run é criada. A partir dessa revisão, a função será faturada usando a SKU do Cloud Run.

Desvincular a função

É possível separar a função usando o seguinte comando:

gcloud functions detach FUNCTION_NAME

Substitua FUNCTION_NAME pelo nome da sua função.