Inicio rápido de 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 haya realizado algunos de estos pasos.

Instale y configure la herramienta de línea de comandos de gcloud:

  1. Instala e inicializa el SDK de Cloud

  2. Actualiza todos los componentes:

     gcloud components update
    

Crea un proyecto con una aplicación de App Engine.

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

  1. Abra una terminal en la máquina donde instaló el SDK de Cloud y cree 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 minúsculas ASCII, números o guiones. También deben tener entre 6 y 30 caracteres.

  2. Configure gcloud para usar el proyecto que ha elegido:

     gcloud config set project [PROJECT-ID]
    

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

  3. Ahora crea la app:

     gcloud app create [--region=REGION]
    

    En este comando, [REGION] es la ubicación en la que se ejecuta la app. Tenga en cuenta que dos ubicaciones, llamadas europe-west y us-central en los comandos de App Engine, se llaman, respectivamente, europe-west1 y us-central1 en los comandos de Cloud Scheduler.

    Puedes verificar la región de una app existente con el siguiente comando:

     gcloud app describe
    

    La región está enumerada por locationId. Su ubicación, por ejemplo, puede mostrarse como locationId: us-central.

    No es posible modificar la zona de una aplicación de App Engine después de configurarla.

Use Google Cloud Console para habilitar funciones:

  1. Habilita la facturación para tu proyecto.

  2. Habilita la API de Cloud Scheduler.

  3. Habilita la API de Pub/Sub

Use gcloud para configurar Pub/Sub:

  1. Configure un tema Pub/Sub para usar como objetivo para su trabajo cron:

    gcloud pubsub topics create cron-topic
    

    Este comando crea un tema denominado "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. Haz clic en el botón Create Job (Crear trabajo).

  3. Asigna un nombre a tu trabajo y, de forma opcional, agrega una descripción.

    image

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

    * * * * *
    

    Consulta Cómo configurar programas de trabajos cron para obtener más información. Los desarrolladores familiarizados con el formato cron de App Engine también pueden usar esa opción.

  5. Selecciona tu zona horaria.

  6. En el campo Destino, seleccione Tema de Pub/Sub del menú desplegable e ingrese el tema que creó anteriormente (cron-topic).

  7. Agregue una string Carga útil para enviar a su destino de Pub/Sub.

    image

  8. 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).

    image

Felicitaciones Acaba de ver los resultados en la consola de ejecutar un trabajo cron que envía un mensaje a Pub/Sub. A continuación, aprenderá a verificar que Pub/Sub realmente recibió el mensaje.

Verifique 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-... |
     +-------------+----------------+------------+-----------------------------+
    

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido.

Borra el trabajo de Cloud Scheduler

  1. Vaya a la página Cloud Scheduler en Cloud Console.

    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. Vaya a la página Cloud Pub/Sub en 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 Cloud Console, ve a la página Administrar recursos.

    Ir a la página Administrar recursos

  2. En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar .
  3. En el cuadro de diálogo, escribe el ID del proyecto y haz clic en Cerrar para borrar el proyecto.

Qué sigue