Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Usar Pub/Sub para activar una función de Cloud Functions

Este tutorial le muestra cómo usar Cloud Scheduler y Pub/Sub para activar una función de Cloud Functions. Poder programar la ejecución de una Cloud Function es un caso práctico común para Cloud Scheduler. Realizarás lo siguiente:

  • Cree una función de Cloud Functions que se suscriba a un tema Pub/Sub.
  • Cree un tema de Pub/Sub para activar esa función.
  • Crea un trabajo de Cloud Scheduler que invoque el activador de Pub/Sub.
  • Ejecutar el trabajo de Cloud Scheduler
  • Verificar el éxito

Antes de comenzar

Para este instructivo, suponemos que ya completaste la Guía de inicio rápido de Cloud Scheduler. Como resultado, tienes a disposición las siguientes herramientas y recursos:

  • Un proyecto de Google Cloud con facturación habilitada.

  • Una aplicación de App Engine en una de las ubicaciones admitidas

  • La API de Cloud Scheduler y la API de Pub/Sub están habilitadas en el proyecto. (la API de Cloud Functions se habilita durante el instructivo)

Costos

En este instructivo, se usan componentes facturables de Cloud Platform, entre los que se incluyen estos:

  • Google Cloud Functions
  • Google Cloud Pub/Sub
  • Google Cloud Scheduler

Usa la calculadora de precios para generar una estimación de los costos según el uso previsto.

Los usuarios nuevos de Cloud Platform podrían cumplir con los requisitos para obtener una prueba gratuita.

Crea una Cloud Function:

  1. Visita la página de Cloud Functions en la consola.

    Ir a la página Cloud Functions

  2. Haz clic en el botón Habilitar API.

  3. Haz clic en el botón Create function (Crear función).

    image

  4. Asigna un nombre a tu función. Acepta la asignación de memoria predeterminada.

  5. Selecciona Cloud Pub/Sub en el menú desplegable Trigger (Activador).

  6. Selecciona un tema existente del menú desplegable, o usa la ventana emergente Crear tema nuevo para crear uno nuevo. Ahora tu función está suscrita al tema. Anota el nombre del tema. Lo necesitarás más adelante.

  7. Para el resto acepta los valores predeterminados, incluido el index.js y el código package.json de muestra.

  8. Haga clic en Crear.

Crea un trabajo de Cloud Scheduler

  1. Visita la página de Cloud Scheduler en la consola.

    Ir a la página Cloud Scheduler

  2. Haz clic en el botón Crear trabajo.

  3. Si es necesario, selecciona una región para que se ejecute tu trabajo.

  4. Asigna un nombre a tu trabajo y, de forma opcional, agrega una descripción.

  5. Especifica la frecuencia de tu trabajo usando el formato unix-cron.

    * * * * *
    

    Consulta Cómo configurar programas de trabajos cron para obtener más información.

  6. Selecciona tu zona horaria.

  7. Selecciona Pub/Sub del menú desplegable Destino.

  8. Ingresa el nombre del Tema que seleccionaste anteriormente.

  9. Agrega una string breve de Carga útil para que se envíe a tu destino.

  10. Haga clic en Crear.

Ahora tiene un trabajo cron que envía un mensaje a su tema de Pub/Sub cada minuto. Tu Cloud Function está suscrita a ese tema.

Es hora de ejecutar el trabajo que acabas de crear.

Ejecuta tu trabajo

  1. Abre la página de la consola de Cloud Scheduler.

    Ir a la página Cloud Scheduler

  2. Haz clic en el botón Run now (Ejecutar ahora).

    El primer trabajo creado en un proyecto puede tardar unos minutos en ejecutarse cuando se invoca por primera vez debido a la configuración necesaria. Por lo tanto, es posible que debas esperar unos minutos.

  3. Observa la columna Result (Resultado).

    image

Felicitaciones Acabas de usar la consola para ver los resultados de la ejecución de un trabajo cron que envía un mensaje a Pub/Sub. A continuación, aprenderás cómo verificar que tu Cloud Function se haya ejecutado realmente.

Verifica los resultados en Cloud Functions:

Para verificar que tu trabajo cron haya activado correctamente tu Cloud Function, sigue estos pasos:

  1. Visita la página de Cloud Functions en la consola.

    Ir a la página Cloud Functions

  2. Haz clic en el nombre de la función.

    image

  3. Se abrirá la página Detalles de la función. Comprueba las invocaciones.

    image

    Felicitaciones Se ejecutó tu función.

  4. Haz clic en View Logs (Ver registros).

    image

  5. Consulta los detalles de la invocación.

    image

Limpia

Para evitar que se generen cargos en tu cuenta de Google Cloud por los recursos que se usaron en este instructivo, sigue estos pasos:

Borra el trabajo de Cloud Scheduler

  1. Ve a la página de Cloud Scheduler en Cloud Console.

    Ir a la página de Scheduler

  2. Haz clic en la casilla de verificación que se encuentra junto a tu trabajo.

  3. Haz clic en el botón Borrar en la parte superior de la página y confirma la eliminación.

Borra el tema de Pub/Sub

  1. Ve a la página de Cloud Pub/Sub en Cloud Console.

    Ir a la página de Pub/Sub

  2. Haz clic en la casilla de verificación que se encuentra junto a tu tema.

  3. Haz clic en Borrar en la parte superior de la página y confirma la eliminación.

Borra la función de Cloud Functions

  1. Vaya a la página Cloud Functions en Cloud Console.

    Ir a la página Cloud Functions

  2. Haz clic en la casilla de verificación que se encuentra junto a tu función.

  3. Haz clic en el botón Borrar en la parte superior de la página y confirma la eliminación.

Borra el proyecto

Si creaste un proyecto solo para este instructivo.

  1. En Cloud Console, ve a la página Administrar recursos.

    Ir a Administrar recursos

  2. En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
  3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.