Gestionar funciones

En esta guía se explica cómo gestionar y separar una función que se ha creado con el comando gcloud functions. Para saber cómo gestionar una función que se ha creado con el comando gcloud run, consulta Gestionar servicios de Cloud Run.

Las funciones creadas con la API Cloud Functions v2 (por ejemplo, con gcloud functions, la API REST o Terraform) se pueden gestionar con la API Admin de Cloud Run, así como con la API Cloud Functions v2. Por ejemplo, puedes actualizar una función que ya tengas con los comandos gcloud functions o 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

Desvincular

El comando gcloud functions detach te permite separar una función de Cloud Functions (versión 2) de su entorno de API. Después de separar una función, solo podrás gestionarla con la API de administrador de Cloud Run. Puede que quieras hacerlo si tus cargas de trabajo deben permanecer dentro del límite de la API de run.googleapis.com para Assured Workloads o para asegurarte de que tus cargas de trabajo usan la SKU de Cloud Run.

Preparar una función para desvincularla

Cuando te prepares para separar tu función, ten en cuenta lo siguiente:

  • La operación de desvinculación no se puede deshacer.
  • La operación de desvinculación no se puede aplicar a las funciones de Cloud Run (1.ª gen.).
  • Familiarízate con el proceso para desplegar funciones en Cloud Run con la Google Cloud consola, la CLI de Google Cloud y Terraform.
  • Las funciones HTTP conservarán las URLs que tengan asignadas.
  • Los activadores asociados a funciones basadas en eventos se conservarán.
  • Los activadores no se pueden gestionar directamente a través de la API run.googleapis.com. Familiarízate con las guías de gestión de activadores de Eventarc o Pub/Sub.
  • Inhabilitar Reintentar si falla no es una función compatible con Cloud Run.
    • Durante la operación de separación, Cloud Run Functions modifica los activadores asociados a las funciones configuradas con sin reintento en caso de fallo para asegurarse de que el tema de Pub/Sub subyacente haga un máximo de cinco intentos de entrega. Cuando se completa la operación de separación, un tema de cola de mensajes fallidos almacena los mensajes que no se han entregado, que puedes recuperar creando una suscripción a la cola de mensajes fallidos.
  • Cuando una función se separa correctamente, se crea una nueva revisión de Cloud Run. A partir de esa revisión, la función se facturará con el SKU de Cloud Run.

Desasociar tu función

Puedes separar tu función con el siguiente comando:

gcloud functions detach FUNCTION_NAME

Sustituye FUNCTION_NAME por el nombre de tu función.