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.
- Crear un tema de Pub/Sub para activar esa función
- Crear 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 tu disposición 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. (la API de Cloud Functions se habilita 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 Basics, selecciona el entorno de 2a gen., ingresa un nombre para tu función y selecciona una región.
En la sección Activador, selecciona Solicitar autenticación. Haz clic en Agregar activador y selecciona Activador de Pub/Sub. 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 de eventos: 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 tema nuevo 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 necesitará para activar la función. Recuerda que seleccionaste Solicitar autenticación para la función anteriormente. Pub/Sub usa los tokens de identidad para la autenticación requerida.
En el campo Cuenta de servicio, haz clic en Crear una 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 Reintentar en caso de error sin seleccionar. Haz clic en Guardar activador.
Expande la sección Entorno de ejecución, compilación, conexiones y configuración de seguridad y selecciona la pestaña Tiempo 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 alguna de las APIs requeridas, haz clic en Habilitar.
No modifiques el lenguaje predeterminado ni el código de muestra. El código no usa ningún servicio de 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.
Si es necesario, selecciona una región en la que se ejecutará tu trabajo.
Asigna un nombre a tu trabajo y, de forma opcional, 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.
Haga clic en Continue.
En la sección Configura la ejecución, selecciona Pub/Sub como el tipo de destino.
Selecciona el nombre de tu Tema.
Agrega una string breve de Mensaje 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 que se ejecute el trabajo, esta columna debería decir “Satisfactorio”.
¡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 esté activado de forma correcta tu Cloud Function, sigue estos pasos:
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. El gráfico Invocations/Seconds debería mostrar 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 APIs 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 inhabilitarlas 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 que describe la API.
Haz clic en Inhabilitar API.
Borra el proyecto
Si creaste un proyecto solo para este instructivo.
- 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.