Administra funciones

En esta guía, se muestra cómo administrar y desvincular una función que se creó con el comando gcloud functions. Para obtener información sobre cómo administrar una función que se creó con el comando gcloud run, consulta Administra servicios de Cloud Run.

Las funciones que se crean con la API de Cloud Functions v2 (por ejemplo, con gcloud functions, la API de REST o Terraform) se pueden administrar con la API de Cloud Run Admin y la API de Cloud Functions v2. Por ejemplo, puedes actualizar una función existente con los comandos gcloud functions o gcloud run:

Funciones de gcloud 

  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

Detach (desvincular)

El comando gcloud functions detach separa una función de Cloud Functions v2 de su entorno de API existente. Después de desvincular una función, solo podrás administrarla con la API de Cloud Run Admin. Te recomendamos que lo hagas si tus cargas de trabajo deben permanecer dentro del límite de la API de run.googleapis.com para Assured Workloads o con el objetivo de asegurarte de que tus cargas de trabajo usen el SKU de Cloud Run.

Prepara la función para desvincularla

Cuando te prepares para desvincular la función, ten en cuenta los consideraciones siguientes:

  • La desvinculación no se puede revertir.
  • Tampoco se puede aplicar a una función de Cloud Run Functions (1ª gen.).
  • Familiarízate con la forma de implementar funciones en Cloud Run a través de la consola de Google Cloud , la Google Cloud CLI y Terraform.
  • Las funciones de HTTP conservarán sus URLs asignadas.
  • Los activadores vinculados a las funciones basadas en eventos se conservarán.
  • Los activadores no se pueden administrar directamente a través de la API de run.googleapis.com. Asegúrate de familiarizarte con las guías de administración de activadores de Eventarc o Pub/Sub.
  • Inhabilitar la opción Volver a intentar en caso de error no está permitido en Cloud Run.
    • Durante la desvinculación, Cloud Run Functions modifica los activadores vinculados a las funciones configuradas con No retry on failure para garantizar que el tema de Pub/Sub subyacente realice un máximo de cinco intentos de entrega. Una vez finalizada la desvinculación, un tema de fila de mensajes no entregados almacena los mensajes no entregados, que puedes recuperar creando una suscripción nueva a la fila de mensajes no entregados.
  • Cuando una función se desvincula con éxito, se crea una nueva revisión de Cloud Run. A partir de esa revisión, se facturará la función con el SKU de Cloud Run.

Desvincula la función

Puedes desvincular la función con el comando siguiente:

gcloud functions detach FUNCTION_NAME

Reemplaza FUNCTION_NAME por el nombre de la función.