Programa y ejecuta un trabajo cron con gcloud CLI

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

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

  1. Crea un tema de Pub/Sub para configurarlo como Cloud Scheduler destino del trabajo.
  2. Crear un trabajo cron con Cloud Scheduler y configurar una una programación para el trabajo.
  3. Ejecuta tu trabajo.
  4. Verificar si el trabajo se ejecutó de forma correcta

Cloud Scheduler tiene un nivel gratuito y ejecutar esta guía de inicio rápido no debería incurrir en algún costo. Para obtener más información, consulta Precios.

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. Install the Google Cloud CLI.

  3. To initialize the gcloud CLI, run the following command: 

    gcloud init

  4. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

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

  6. Enable the Cloud Scheduler, Pub/Sub APIs: 

    gcloud services enable cloudscheduler.googleapis.com pubsub.googleapis.com
  7. Install the Google Cloud CLI.

  8. To initialize the gcloud CLI, run the following command: 

    gcloud init

  9. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

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

  11. Enable the Cloud Scheduler, Pub/Sub APIs: 

    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 usar como destino de tu trabajo cron:

    gcloud pubsub topics create cron-topic

    Esto crea un tema llamado cron-topic.

  2. Para recibir mensajes y ver los resultados del trabajo, crea un Suscripción a Pub/Sub:

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

Crea un trabajo cron con Cloud Scheduler

Usa la gcloud scheduler jobs create pubsub. para configurar una unidad de trabajo conocida como trabajo cron que se envía a un la segmentación de Pub/Sub de forma recurrente. Se especificó el programa con un formato basado en Unix-cron. Para obtener más información, consulta Formato y zona horaria del trabajo cron.

gcloud scheduler jobs create pubsub my-cron-job \
    --schedule="30 16 * * 7" \
    --topic=cron-topic \
    --location="us-central1" \
    --message-body="Hello world"

Creaste un trabajo que envía un mensaje de “Hello World” a tu archivo de Pub/Sub el domingo a las 4:30 p.m.

Ahora puedes ejecutar el trabajo.

Ejecuta tu trabajo

Además de ejecutarse de acuerdo con el programa especificado, puedes forzar trabajo para que se ejecute de inmediato:

gcloud scheduler jobs run my-cron-job --location="us-central1"

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

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

Verifica los resultados en Pub/Sub

Verifica que tu 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

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron en esta página, borra el proyecto de Cloud que tiene los recursos.

    Borra un proyecto de Google Cloud:

    gcloud projects delete PROJECT_ID

También puedes borrar los recursos que creaste para esta guía de inicio rápido:

  1. Borra el trabajo cron. En Cloud Shell o en la máquina donde lo instalaste en gcloud CLI, ejecuta el siguiente comando:

    gcloud scheduler jobs delete MY_JOB \
    --location="LOCATION"

    Reemplaza lo siguiente:

    • MY_JOB: Es el nombre del trabajo que se borrará.
    • LOCATION: Es la ubicación del trabajo. De forma predeterminada, se usa la ubicación de la aplicación de App Engine del proyecto actual si hay una app asociada.

  2. Borra el tema de Pub/Sub. En Cloud Shell o en el en la que instalaste gcloud CLI, ejecuta el comando:

    gcloud pubsub topics delete TOPIC_ID

    Reemplaza TOPIC_ID por el ID del El tema de Pub/Sub que se borrará.

  3. Borra la suscripción a Pub/Sub. En Cloud Shell o en en la máquina en la que instalaste gcloud CLI, ejecuta el siguiente comando:

    gcloud pubsub subscriptions delete SUBSCRIPTION_ID

    Reemplaza SUBSCRIPTION_ID por el ID de la suscripción de Pub/Sub que se borrará.

¿Qué sigue?