Guía de inicio rápido: Programa y ejecuta un trabajo cron con Cloud Scheduler

Programar y ejecutar un trabajo cron con Cloud Scheduler

En esta guía de inicio rápido, se te explicará cómo realizar las siguientes operaciones básicas con Cloud Scheduler:

  • Crear un trabajo de Cloud Scheduler
  • Configurar un programa recurrente para un trabajo
  • Especifique un tema de Pub/Sub como destino del trabajo.
  • Ejecutar un trabajo
  • Verificar el éxito

Cloud Scheduler cuenta con un nivel gratuito, por lo que ejecutar esta guía de inicio práctico no generará ningún costo. Para obtener más información, consulta Precios.

Antes de comenzar

Utiliza las siguientes instrucciones como preparación para esta guía de inicio rápido. Es posible que ya hayas realizado algunos de estos pasos.

Instala y configura la CLI de gcloud:

  1. Instala e inicializa la CLI de gcloud

  2. Actualiza todos los componentes:

    gcloud components update
    

Crea un proyecto

También puedes usar un proyecto existente, si lo tienes.

  1. Abre una terminal en la máquina en la que instalaste la CLI de gcloud y crea un proyecto de Cloud:

    gcloud projects create PROJECT_ID
    

    En este comando, PROJECT_ID es el ID del proyecto que quieres crear. Los ID de proyecto deben comenzar con una letra minúscula y pueden tener letras ASCII en minúscula, dígitos o guiones. También deben tener entre 6 y 30 caracteres.

  2. Configura gcloud para usar el proyecto que elegiste:

    gcloud config set project PROJECT_ID
    

    En este comando, PROJECT_ID es el ID que configuraste anteriormente.

Usa Google Cloud Console para habilitar las funciones:

  1. Habilita la facturación para tu proyecto.

  2. Habilita la API de Cloud Scheduler.

  3. Habilita la API de Pub/Sub

Usa gcloud para configurar Pub/Sub:

  1. Configura un tema de Pub/Sub para usarlo como destino de tu trabajo cron:

    gcloud pubsub topics create cron-topic
    

    Este comando crea un tema llamado cron-topic. Anota el nombre, dado que lo necesitarás más adelante en la guía de inicio rápido.

  2. Crea una suscripción de Pub/Sub; necesita esto para ver los resultados de su trabajo.

    gcloud pubsub subscriptions create cron-sub --topic cron-topic
    

Crea un trabajo

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

    Cloud Scheduler

  2. Si no tienes trabajos actuales, haz clic en Programar un trabajo.

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

  4. Asigna un nombre a tu trabajo.

  5. Selecciona una región para el trabajo.

    Selecciona una región del campo de la región.

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

    * * * * *
    

    Para obtener más información, consulta Configura programas de trabajos cron. Los desarrolladores familiarizados con el formato cron de App Engine también pueden usar esa opción.

  7. Selecciona tu zona horaria.

  8. Haga clic en Continuar.

  9. En el campo Tipo de objetivo, selecciona Pub/Sub del menú desplegable.

  10. Selecciona el tema que creaste antes (cron-topic) en el menú desplegable del tema.

  11. Agrega una string que se enviará a tu destino de Pub/Sub en el cuadro de texto Cuerpo del mensaje.

  12. Haga clic en Crear.

Ahora tiene un trabajo que envía un mensaje a su tema de Pub/Sub cada minuto. Es hora de ejecutar el trabajo que acabas de crear.

Ejecuta tu trabajo

  1. En la página de la consola de Cloud Scheduler abierta con tu proyecto, 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.

  2. Observa los resultados debajo de la columna Result (Resultado).

    Los resultados de la ejecución de un trabajo en la columna Resultado.

¡Felicitaciones! Acabas de ver los resultados en la consola de la ejecución de un trabajo cron que envía un mensaje a Pub/Sub. A continuación, aprenderás a verificar que Pub/Sub realmente haya recibido el mensaje.

Verifica los resultados en Pub/Sub

Para verificar que su tema de Pub/Sub recibe mensajes de su trabajo:

  1. Invoca el comando siguiente:

    gcloud pubsub subscriptions pull cron-sub --limit 5
    
  2. Observa los resultados. Deberías ver un resultado similar al siguiente.

     +-------------+----------------+------------+-----------------------------+
     | DATA        | MESSAGE_ID     | ATTRIBUTES | ACK_ID                      |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56344662920621 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340561244339 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340388879975 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337745052761 |            | EkwnGERJUytDCypYEU4EISE...  |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337890896134 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
    

Realiza una limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron en esta página.

Borra el trabajo de Cloud Scheduler

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

    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 Google 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 el proyecto

Si creaste un proyecto solo para esta guía de inicio rápido.

  1. En la consola de Google Cloud, 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.

¿Qué sigue?