En esta página, se muestra cómo usar Cloud Scheduler para ejecutar un flujo de trabajo según una programación en particular, por ejemplo, todos los lunes a las 9 a.m. o cada 15 minutos. Puedes configurar el programa en la consola de Google Cloud o con Google Cloud CLI.
Antes de comenzar
- Si aún no tienes un flujo de trabajo que desees programar, crea y, luego, implementa uno.
-
Habilita la API de Cloud Scheduler.
O bien, en una terminal, ingresa el siguiente comando:
gcloud services enable cloudscheduler.googleapis.com
Programa un flujo de trabajo
Crea una cuenta de servicio para que Cloud Scheduler pueda realizar solicitudes a la API de Workflows:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
Reemplaza
SERVICE_ACCOUNT_NAME
por un nombre que tenga entre 6 y 30 caracteres. Puede contener guiones y caracteres alfanuméricos en minúscula. Después de crear una cuenta de servicio, no puedes cambiar su nombre.Para permitir que la principal que ejecutará tus comandos de Cloud Scheduler pueda actuar como una cuenta de servicio de Identity and Access Management (IAM), otorga un rol que permita a la principal actuar en nombre de la cuenta de servicio.
Otorga a tu cuenta de servicio nueva el función workflows.invoker a fin de que la cuenta tenga permiso para activar tu flujo de trabajo:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --role roles/workflows.invoker
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto de Google Cloud.SERVICE_ACCOUNT_NAME
: Es el nombre de la cuenta de servicio que creaste antes.
Crear un trabajo de Cloud Scheduler que active tu flujo de trabajo con la cuenta de servicio que creaste antes para autenticarte
Ten en cuenta que si aplicas el registro de llamadas, debes configurarlo a través de la página Workflows en la consola de Google Cloud. Para obtener más información, consulta los siguientes pasos.
Console
Para programar un flujo de trabajo, ve a la página Flujos de trabajo en la consola de Google Cloud:
En la página Workflows, selecciona un flujo de trabajo para ir a su página de detalles.
En la página Detalles del flujo de trabajo, haz clic en edit Editar.
En la página Editar flujo de trabajo, selecciona Agregar activador nuevo > Cloud Scheduler.
Se abrirá el panel Crear un trabajo de Scheduler.
Define el programa:
En el campo Nombre, ingresa un nombre para tu trabajo de Cloud Scheduler. Debe ser único en todos los trabajos de la misma región.
En la lista Región, selecciona una región adecuada, por ejemplo, us-central1.
En el campo Frecuencia, especifica el intervalo de tiempo que defines en formato unix-cron. Por ejemplo, para programar tu flujo de trabajo para que se ejecute cada 5 minutos, escribe
*/5 * * * *
.En la lista Zona horaria, selecciona la zona horaria que Cloud Scheduler debe usar para interpretar la programación que proporcionas. Puedes buscar por país.
Haz clic en Continuar.
Configura la ejecución:
En el campo Argumento del flujo de trabajo, especifica los argumentos del entorno de ejecución para pasar al flujo de trabajo antes de la ejecución. Los argumentos deben estar en formato JSON. Por ejemplo:
. Si el flujo de trabajo no usa argumentos del entorno de ejecución, acepta el valor predeterminado de{"firstName":"Sherlock", "lastName":"Holmes"}
{}
o deja el campo en blanco.En la lista Nivel de registro de llamadas del flujo de trabajo, selecciona el nivel de registro de llamadas que deseas aplicar durante la ejecución del flujo de trabajo:
- No especificado: No se especifica ningún nivel de registro. Esta es la opción predeterminada. Un nivel de registro de ejecución tiene prioridad sobre cualquier nivel de registro de flujo de trabajo, a menos que no se especifique el nivel de registro de ejecución (predeterminado). En ese caso, se aplica el nivel de registro del flujo de trabajo.
- Solo errores: Registra todas las excepciones detectadas, o cuando se detiene una llamada debido a una excepción.
- Todas las llamadas: Registra todas las llamadas a subflujos de trabajo o funciones de biblioteca y sus resultados.
- Sin registros: Sin registro de llamadas.
En la lista Cuenta de servicio, selecciona la cuenta de servicio que creaste antes.
Haz clic en Crear.
Ten en cuenta que, si actualizas un flujo de trabajo existente, no es necesario que vuelvas a implementarlo.
El trabajo de Cloud Scheduler ahora aparece en la pestaña Activadores de la página Detalles del flujo de trabajo.
Si deseas actualizar o borrar el trabajo, debes editar el flujo de trabajo:
- En la página Detalles del flujo de trabajo, haz clic en edit Editar.
- En la sección Activadores, busca el trabajo que deseas actualizar o borrar.
- Haz clic en edit Editar recurso o delete Borrar recurso.
gcloud
Abre una terminal y, luego, ingresa el siguiente comando:
gcloud scheduler jobs create http JOB_NAME \ --schedule="FREQUENCY" \ --uri="https://workflowexecutions.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_NAME/workflows/WORKFLOW_NAME/executions" \ --message-body="{\"argument\": \"DOUBLE_ESCAPED_JSON_STRING\"}" \ --time-zone="TIME_ZONE" \ --oauth-service-account-email="SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"
Reemplaza lo siguiente:
JOB_NAME
: Es el nombre que le asignas a tu trabajo de Cloud Scheduler.FREQUENCY
: Es un intervalo de tiempo que defines con el formato unix-cron. Por ejemplo, para programar tu flujo de trabajo para que se ejecute cada 5 minutos, escribe*/5 * * * *
.PROJECT_ID
: El ID del proyecto de Google Cloud.REGION_NAME
: Es la región en la que se encuentra tu flujo de trabajo, comous-central1
.WORKFLOW_NAME
: Es el nombre del flujo de trabajo para el que deseas programar la ejecución.DOUBLE_ESCAPED_JSON_STRING
: Es una codificación JSON de cualquier argumento que pases. Las comillas dobles dentro de la string entrecomillada se escapan mediante barras inversas (\). Por ejemplo:--message-body="{\"argument\": \"{\\\"foo\\\": \\\"bar\\\"}\"}"
TIME_ZONE
: Es la zona horaria que Cloud Scheduler debe usar para interpretar el programa que proporcionas. Por ejemplo:America/New_York
.SERVICE_ACCOUNT_NAME
: Es el nombre de la cuenta de servicio que creaste antes.
Para enumerar todos los trabajos en un proyecto, haz lo siguiente:
gcloud scheduler jobs list
Para borrar un trabajo, sigue estos pasos:
gcloud scheduler jobs delete JOB_NAME
Tu flujo de trabajo ahora se ejecuta según la frecuencia que hayas definido.
¿Qué sigue?
- Usa IAM para controlar el acceso
- Pasa argumentos del entorno de ejecución en una solicitud de ejecución
- Instructivo: Programa flujos de trabajo con Cloud Scheduler