Gerenciar funções

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

Observação: Se você criou uma função do Cloud Run usando gcloud run comandos ou a API Cloud Run Admin, não será possível gerenciar essa função com gcloud functions comandos ou a API Cloud Functions v2.

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 atual usando 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 gcloud functions detach comando permite desanexar uma função do Cloud Functions v2 do ambiente de API atual. Depois de desanexar 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 desanexação

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

• A operação de desanexação não é reversível.
• A operação de desanexação não pode ser aplicada a funções do Cloud Run (1ª geração).
• Saiba como implantar funções no Cloud Run usando o Google Cloud console, 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.
• Os acionadores não podem ser gerenciados diretamente pela API run.googleapis.com. Conheça os guias de gerenciamento de acionadores do Eventarc ou do Pub/Sub.
• Desativar a repetição em caso de falha não é um recurso compatível com o Cloud Run.
  • Durante a operação de desanexação, o Cloud Run functions modifica os acionadores anexados a funções configuradas com sem repetição 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 desanexação é concluída, um tópico de fila de mensagens inativas armazena as mensagens não entregues, que podem ser recuperadas criando uma nova assinatura na fila de mensagens inativas. Se você quiser usar uma chave de criptografia gerenciada pelo cliente para o tópico da DLQ, você pode atualizar a CMEK para o tópico após a desanexação.
• Quando uma função é desanexada, uma nova revisão do Cloud Run é criada. A partir dessa revisão, a função será faturada usando a SKU do Cloud Run.

Desanexar a função

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

gcloud functions detach FUNCTION_NAME

Substitua FUNCTION_NAME pelo nome da sua função.