Configura programas de trabajos cron

Los trabajos cron se programan en intervalos recurrentes especificados con un formato basado en unix-cron. Puedes definir un programa para que tu trabajo se ejecute varias veces al día o en días y meses específicos. (Aunque ya no recomendamos su uso, la sintaxis cron de App Engine todavía es compatible con los trabajos existentes).

Formato del trabajo cron

Un programa se define con el formato de string cron de Unix (* * * * *), que es un conjunto de cinco campos en una línea que indica cuándo se debe ejecutar el trabajo.

Formato de string cron de Unix

Puedes usar Google Cloud Console, la CLI de Google Cloud o la API de REST de Cloud Scheduler para establecer el programa.

Los campos de tiempo tienen el siguiente formato y sus posibles valores, y deben seguir este orden:

Campo Formato de valores válidos
Minuta 0-59
Hora 0-23
día del mes 1-31
Mes 1-12 (o JAN a DEC)
Día de la semana 0-6 (o de domingo a sábado; o 7 para domingo)

Caracteres especiales

  • Un campo puede contener un asterisco (*), que siempre significa "primer-último".
  • Los rangos son dos números separados por un guion (-) y el rango especificado es inclusivo.
  • Seguir un rango con /NUMBER especifica omisiones del valor del número mediante el rango. Por ejemplo, 0-23/2 y */2 se pueden usar en el campo Hora para especificar la ejecución cada dos horas.
  • Una lista es un conjunto de números (o rangos) separados por comas (,). Por ejemplo, 1,2,5,6 en el campo Mes especifica una ejecución el primer, segundo, quinto y sexto día del mes.

Zona horaria

Puedes seleccionar la zona horaria para evaluar la programación, ya sea en la consola (en la página Crear un trabajo, selecciona una Zona horaria de la lista) o mediante la marca gcloud --time-zone cuando crees el trabajo. La zona horaria predeterminada es Etc/UTC.

Para algunas zonas horarias, el horario de verano puede hacer que los trabajos se ejecuten o que no se ejecuten de forma inesperada. Esto se debe a que Cloud Scheduler se ejecuta en un reloj de pared. En instancias en las que un horario puede ocurrir dos veces (como en los casos en los que los relojes retroceden) y en el momento en que se programa tu trabajo, es posible que el trabajo programado observe anomalías.

Si tu trabajo requiere una cadencia muy específica, es posible que desees elegir una zona horaria que no observe el horario de verano. En particular, se recomienda usar UTC para Cloud Scheduler a fin de evitar el problema por completo.

Programas de muestra

En la siguiente tabla, se muestran algunos programas de trabajos cron de muestra y su descripción:

Programa de muestra Formato del trabajo cron
Cada minuto * * * * *
Todos los sábados a las 23:45 (11:45 p.m.) 45 23 * * 6
Todos los lunes a las 9:00 a.m. (9:00 a.m.) 0 9 * * 1
Todos los domingos a las 04:05 (4:05 a.m.) 5 4 * * SUN
Todos los días de semana (de lunes a viernes) a las 22:00 (10:00 p.m.) 0 22 * * 1-5