Programar y ejecutar una tarea cron con la Google Cloud consola

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

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

  1. Crea un tema de Pub/Sub para configurarlo como destino de tu trabajo de Cloud Scheduler.
  2. Crea una tarea cron con Cloud Scheduler y configura una programación periódica para la tarea.
  3. Ejecuta el trabajo.
  4. Comprueba que el trabajo se haya ejecutado correctamente.

Cloud Scheduler tiene un nivel gratuito y, por lo tanto, no deberías incurrir en ningún coste al completar esta guía de inicio rápido. Para obtener más información, consulta los precios.

Para seguir las instrucciones paso a paso de esta tarea directamente en la Google Cloud consola, haga clic en Ayúdame:

Guíame

Antes de empezar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Scheduler, Pub/Sub APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  5. Make sure that you have the following role or roles on the project: Cloud Scheduler Admin, Pub/Sub Editor

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Ir a IAM
    2. Selecciona el proyecto.
    3. Haz clic en Conceder acceso.

    4. En el campo Nuevos principales, introduce tu identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.

    5. En la lista Selecciona un rol, elige un rol.
    6. Para conceder más roles, haz clic en Añadir otro rol y añade cada rol adicional.
    7. Haz clic en Guardar.

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. Verify that billing is enabled for your Google Cloud project.

  8. Enable the Cloud Scheduler, Pub/Sub APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  9. Make sure that you have the following role or roles on the project: Cloud Scheduler Admin, Pub/Sub Editor

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Ir a IAM
    2. Selecciona el proyecto.
    3. Haz clic en Conceder acceso.

    4. En el campo Nuevos principales, introduce tu identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.

    5. En la lista Selecciona un rol, elige un rol.
    6. Para conceder más roles, haz clic en Añadir otro rol y añade cada rol adicional.
    7. Haz clic en Guardar.

    10. Crear un tema y una suscripción de Pub/Sub

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

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

      Ir a Pub/Sub

    2. Haz clic en Crear tema.

    3. En el campo Topic ID (ID de tema), introduce cron-topic como ID del tema.

    4. Mantén los valores predeterminados, incluida la opción Añadir una suscripción predeterminada.

    5. No selecciones ninguna otra opción.

    6. Haz clic en Crear.

    De esta forma, se crea un tema de Pub/Sub llamado cron-topic y una suscripción a ese tema llamada cron-topic-sub.

    Crear una tarea cron con Cloud Scheduler

    Configura una unidad de trabajo programada, conocida como tarea cron, que se envía a un destino de forma periódica.

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

      Ir a Cloud Scheduler

    2. Haz clic en Crear trabajo.

    3. Asigna un nombre al trabajo.

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

    5. Especifica una frecuencia para tu trabajo con un formato basado en cron de Unix. Por ejemplo:

      30 16 * * 7

      Para obtener más información, consulta Configurar programaciones de tareas cron.

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

      En algunas zonas horarias, el cambio de horario puede provocar que las tareas 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 has creado antes: cron-topic.

    10. En el campo Cuerpo del mensaje, introduce una cadena que se enviará al tema de destino de Pub/Sub. Por ejemplo: "Hello world!"

    11. Haz clic en Crear.

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

    Ejecutar una tarea

    Además de ejecutarse según la programación especificada, puedes forzar que tu trabajo se ejecute inmediatamente.

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

      Ir a Cloud Scheduler

      Tu trabajo debería aparecer en la lista.

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

      Ten en cuenta que, debido a la configuración inicial, la primera tarea creada en un proyecto puede tardar unos minutos en ejecutarse.

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

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

    Verificar los resultados en Pub/Sub

    Comprueba que tu tema de Pub/Sub esté recibiendo mensajes de tu trabajo extrayendo mensajes de Pub/Sub de la suscripción.

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

      Ir a Pub/Sub

    2. Haz clic en la suscripción del tema de Pub/Sub.

    3. Haz clic en la pestaña Mensajes.

    4. Haz clic en Extraer.

    Debería aparecer el mensaje que has publicado, con el cuerpo del mensaje, Hello world y la hora en que se publicó.

    Limpieza

    Para evitar que se apliquen cargos en tu cuenta de Google Cloud por los recursos utilizados en esta página, sigue estos pasos.

    1. Elimina el trabajo cron que has creado:

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

        Ir a Cloud Scheduler

      2. Selecciona la casilla de tu trabajo.

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

    2. Elimina el tema de Pub/Sub:

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

        Ir a Pub/Sub

      2. Marca la casilla del tema.

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

    3. Elimina la suscripción de Pub/Sub:

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

        Ir a Pub/Sub

      2. Marca la casilla de tu suscripción.

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

    4. Si has creado un proyecto para aprender a usar Cloud Scheduler y ya no lo necesitas, puedes eliminarlo:

      1. In the Google Cloud console, go to the Manage resources page.

        Go to Manage resources

      2. In the project list, select the project that you want to delete, and then click Delete.
      3. In the dialog, type the project ID, and then click Shut down to delete the project.

    Siguientes pasos