En este instructivo, se muestra cómo activar una función de Cloud Functions mediante Cloud Scheduler y Pub/Sub. Poder programar la ejecución de una Cloud Function es un caso de uso común para Cloud Scheduler. Realizarás lo siguiente:
- Cree una función de Cloud Functions que se suscriba a un tema Pub/Sub.
- Crear un trabajo de Cloud Scheduler que publique un mensaje en el tema de Pub/Sub
- Ejecutar el trabajo de Cloud Scheduler
- Verifica que el trabajo de Cloud Scheduler haya activado la Cloud Function.
Antes de comenzar
En este instructivo, se supone que ya revisaste la Guía de inicio rápido de Cloud Scheduler. Como resultado, dispones de las siguientes herramientas y recursos:Un proyecto de Google Cloud con facturación habilitada.
La API de Cloud Scheduler y la API de Pub/Sub están habilitadas en el proyecto. Debes habilitar la API de Cloud Functions durante el instructivo.
Costos
En este documento, usarás los siguientes componentes facturables de Google Cloud:
- Cloud Functions
- Pub/Sub
- Cloud Scheduler
Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.
Crea una Cloud Function con un activador
En la consola de Google Cloud, ve a la página Cloud Functions.
Haz clic en Habilitar API si se te solicita.
Haz clic en Crear función. Si aparece un mensaje que te solicita que habilites las APIs, haz clic en Habilitar para activarlas.
En la sección Aspectos básicos, selecciona el entorno de 2a gen., ingresa un nombre para la función y selecciona una región.
En la sección Activador, en Tipo de activador, selecciona Cloud Pub/Sub y, luego, haz clic en Más opciones. Se abrirá el panel Activador de Eventarc. Si se te solicita Habilitar las APIs obligatorias, haz clic en Habilitar.
En el panel Activador de Eventarc, asegúrate de que los primeros campos se completen de la siguiente manera o complétalos si es necesario:
- Tipo de activador: Fuentes de Google
- Proveedor del evento: Cloud Pub/Sub
- Evento:
google.cloud.pubsub.topic.v1.messagePublished
En el campo Selecciona un tema de Cloud Pub/Sub, selecciona un tema existente o haz clic en Crear un tema para crear uno nuevo. Tu función se suscribe a este tema. Anota el nombre del tema. Lo necesitarás más adelante.
- Si se te solicita, haz clic en Otorgar a fin de permitir que el servicio de Pub/Sub cree los tokens de identidad que necesita para invocar la función.
En el campo Cuenta de servicio, haz clic en Crear cuenta de servicio nueva.
Ingresa un nombre para la cuenta de servicio y haz clic en Crear. Eventarc usa esta cuenta de servicio para invocar la función con un token de identidad desde el servicio de Pub/Sub.
En la sección Otorga a esta cuenta de servicio acceso al proyecto, selecciona la función Invocador de Cloud Run. Esto le otorga a la cuenta de servicio la capacidad de invocar tu función de 2a generación.
Haz clic en Listo.
Deja la opción Volver a intentar en caso de error sin seleccionar. Haz clic en Guardar activador.
Expande la sección Configuración del entorno de ejecución, la compilación, las conexiones y la seguridad y selecciona la pestaña Entorno de ejecución.
En Cuenta de servicio del entorno de ejecución, en el campo Cuenta de servicio, haz clic en Crear. El flujo de creación de cuentas de servicio se abrirá en una pestaña nueva. Esta cuenta de servicio es la identidad que tiene la Cloud Function cuando se ejecuta.
- Ingresa un nombre para la cuenta de servicio.
- Haz clic en Crear y continuar.
- Haz clic en Listo.
Se te redireccionará a la página Cuentas de servicio de la consola de Google Cloud. Puedes cerrar esta pestaña.
Regresa al campo Cuenta de servicio en la página de creación de la función, haz clic en Actualizar y, luego, selecciona la cuenta de servicio que acabas de crear.
Haz clic en Siguiente. Si se te solicita habilitar las APIs necesarias, haz clic en Habilitar.
No modifiques el idioma predeterminado ni el código de muestra. El código no usa ningún servicio en la nube y no necesita permisos adicionales habilitados. Haz clic en Implementar.
Crea un trabajo de Cloud Scheduler
En la consola de Google Cloud, ve a la página Cloud Scheduler.
Haz clic en Create job.
Ingresa un nombre para el trabajo, selecciona una región en la que se ejecutará y, si lo deseas, agrega una descripción.
Especifica la frecuencia de tu trabajo usando el formato unix-cron.
30 16 * * 7Consulta Configura trabajo cron cron para obtener más información.
Selecciona tu zona horaria.
Haz clic en Continuar.
En la sección Configura la ejecución, selecciona Pub/Sub como el tipo de destino.
Selecciona tu tema de Pub/Sub.
Agrega una cadena breve de Message para que se envíe a tu destino.
Haz clic en Crear.
Ahora tienes un trabajo cron que envía un mensaje a tu tema de Pub/Sub a las 16:30 los domingos. Tu Cloud Function está suscrita a ese tema.
Ejecuta tu trabajo
Ahora puedes ejecutar el trabajo que creaste.
En la consola de Google Cloud, ve a la página de Cloud Scheduler.
Selecciona el trabajo que creaste.
Haz clic en Forzar ejecución.
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.
Observa la columna Estado de la última ejecución. Una vez ejecutado el trabajo, esta columna debería decir “Finalizado”.
¡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
Sigue estos pasos para verificar que tu trabajo cron active de forma correcta tu Cloud Function:
En la consola de Google Cloud, ve a la página Cloud Functions.
Haz clic en el nombre de la función.
Se abrirá la página Detalles de la función. En el gráfico Invocations/Second, se muestra tu primera invocación de la función. Para ver los detalles de la invocación, haz clic en Registros.
¡Felicitaciones! Se ejecutó tu función.
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron en este instructivo, sigue estos pasos:
Borra el trabajo de Cloud Scheduler
En la consola de Google Cloud, ve a la página Cloud Scheduler.
Selecciona la casilla de verificación que se encuentra junto a tu trabajo.
Haz clic en Borrar y confirma la eliminación.
Borra el tema de Pub/Sub
En la consola de Google Cloud, ve a la página Cloud Pub/Sub.
Selecciona la casilla de verificación junto a tu tema.
Haz clic en Borrar y confirma la eliminación.
Borra la función de Cloud Functions
En la consola de Google Cloud, ve a la página Cloud Functions.
Selecciona la casilla de verificación junto a tu función.
Haz clic en Borrar y confirma la eliminación.
Borra las cuentas de servicio
En la consola de Google Cloud, ve a la página Cuentas de servicio.
Selecciona la casilla de verificación junto a las cuentas de servicio que creaste.
Haz clic en Borrar y confirma la eliminación.
Inhabilita las APIs
Si habilitaste alguna API en el transcurso de este instructivo (como las API de Eventarc, Cloud Functions o Pub/Sub), inhabilítalas. Inhabilitar las APIs afecta el acceso a la API del proyecto, por lo que no debes inhabilitar las APIs si otros recursos de tu proyecto las usan.
En la consola de Google Cloud, ve a la página API y servicios.
Haz clic en la API que deseas inhabilitar. Aparecerá una página en la que se describe la API.
Haz clic en Inhabilitar API.
Borra el proyecto
Si creaste un proyecto solo para este instructivo, puedes borrarlo.
- En la consola de Google Cloud, ve a la página Administrar recursos.
- En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
- En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.