Programa y ejecuta un trabajo cron

En esta guía de inicio rápido, se muestra cómo realizar algunas operaciones básicas con Cloud Scheduler.

En esta guía de inicio rápido, podrás hacer lo siguiente:

  1. Crear un trabajo cron con Cloud Scheduler
  2. Configurar un programa recurrente para un trabajo
  3. Especificar un tema de Pub/Sub como destino del trabajo
  4. Ejecutar un trabajo
  5. Verificar si el trabajo se ejecutó de forma correcta

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

Para seguir la guía paso a paso sobre esta tarea de forma directa en la consola de Google Cloud, haz clic en Guiarme:

Guiarme

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. Instala Google Cloud CLI.

  5. Para inicializar la CLI de gcloud, ejecuta el siguiente comando: 

    gcloud init
    6.

  6. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  7. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  8. Instala Google Cloud CLI.

  9. Para inicializar la CLI de gcloud, ejecuta el siguiente comando: 

    gcloud init
    10.
  10. Si no usas Cloud Shell, actualiza los componentes de Google Cloud CLI: 
    gcloud components update
  11. Accede con tu cuenta: 
    gcloud auth login

  12. Habilita las APIs de Cloud Scheduler y Pub/Sub:

    gcloud services enable cloudscheduler.googleapis.com pubsub.googleapis.com

Crea un tema y una suscripción a Pub/Sub

Un tema de Pub/Sub es un recurso al que los publicadores pueden enviar mensajes. Para recibir mensajes publicados en un tema, debes crear una suscripción a ese tema.

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

    gcloud pubsub topics create cron-topic

    Esto crea un tema llamado cron-topic.

  2. Para ver los resultados de tu trabajo, crea una suscripción a Pub/Sub:

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

Crear un trabajo cron con Cloud Scheduler

Configura una unidad de trabajo programada, conocida como trabajo cron, que se envía a un destino de forma recurrente.

  1. En la consola de Google Cloud, ve a la página Cloud Scheduler.

    Ir a Cloud Scheduler

  2. Haz clic en Create job.

  3. Asigna un nombre a tu trabajo.

  4. En la lista Región, selecciona una región para tu trabajo.

  5. Especifica una Frecuencia para tu trabajo en un formato basado en unix-cron. Por ejemplo:

    30 16 * * 7

    Para obtener más información, consulta Configuratrabajo crons cron.

  6. En la lista Zona horaria, selecciona una zona horaria.

    En algunas zonas horarias, el horario de verano puede hacer que los trabajos se ejecuten o no se ejecuten de forma inesperada. Para obtener más información, consulta Zona horaria.

  7. Haz clic en Continuar.

  8. En la lista Tipo de destino, selecciona Pub/Sub.

  9. Selecciona el tema que creaste anteriormente: cron-topic.

  10. En el campo Cuerpo del mensaje, ingresa una string para que se envíe al tema de destino de Pub/Sub. Por ejemplo: “¡Hola, mundo!”

  11. Haz clic en Crear.

Creaste un trabajo que envía un mensaje a un tema de Pub/Sub a las 16:30 los domingos. Ahora puedes ejecutar el trabajo.

Ejecuta tu trabajo

Además de ejecutar según su programa especificado, puedes forzar la ejecución de inmediato de tu trabajo.

  1. En la consola de Google Cloud, ve a la página Cloud Scheduler.

    Ir a Cloud Scheduler

    Tu trabajo debería aparecer en la lista.

  2. En la fila de tu trabajo, haz clic en Acciones > Forzar una ejecución de trabajo.

    Ten en cuenta que, debido a la configuración inicial, el primer trabajo creado en un proyecto puede tardar unos minutos en ejecutarse.

  3. En la columna Estado de la última ejecución, el estado Success indica que ejecutaste correctamente tu trabajo cron.

A continuación, puedes verificar que Pub/Sub haya recibido el mensaje.

Verifica los resultados en Pub/Sub

Verifica que el tema de Pub/Sub reciba mensajes de tu trabajo.

  1. Extraer mensajes de Pub/Sub de una suscripción:

    gcloud pubsub subscriptions pull cron-sub --limit 5

    Si no se muestran mensajes inicialmente, vuelve a ejecutar el comando.

  2. Consulta los resultados de la ejecución de tu trabajo. El resultado debería ser similar al siguiente:

    DATA: Hello world!
MESSAGE_ID: 5028933846601543
ORDERING_KEY:
ATTRIBUTES:
DELIVERY_ATTEMPT:
ACK_ID: RFAGFixdRkhRNxkIaFEOT14jPzUgKEUQAgVPAihdeTFXLkFacGhRDRlyfWB9[...]

Limpia

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.

  1. Borra el trabajo cron que creaste:

    1. En la consola de Google Cloud, ve a la página Cloud Scheduler.

      Ir a Cloud Scheduler

    2. Selecciona la casilla de verificación de tu trabajo.

    3. Haz clic en Borrar y confirma la eliminación.

  2. Borra el tema de Pub/Sub:

    1. En la consola de Google Cloud, ve a la página Pub/Sub.

      Ir a Pub/Sub

    2. Selecciona la casilla de verificación de tu tema.

    3. Haz clic en Borrar y confirma la eliminación.

  3. Borra el proyecto:

    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?