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.
Puedes usar Google Cloud Console, la CLI de Google Cloud o la API de REST de Cloud Scheduler para establecer tu programa.
Los campos de tiempo tienen el siguiente formato y 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 de ENE 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"primero y último". - Los rangos son dos números separados por un guion (
-), y el rango especificado es inclusivo. - Seguir un rango con
/NUMBERespecifica omisiones del valor del número a través del rango. Por ejemplo,0-23/2y*/2se pueden usar en el campoHourpara 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,6en el campoDay of the monthespecifica una ejecución el primer, segundo, quinto y sexto días del mes.
Zona horaria
Puedes seleccionar la zona horaria para evaluar la programación en Google Cloud Console (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.
En algunas zonas horarias, el horario de verano puede provocar que los trabajos se ejecuten o no 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 (por ejemplo, cuando los relojes retroceden) y tu trabajo está programado a esta hora, es posible que observes anomalías de ejecución.
Si tu trabajo requiere una cadencia muy específica, te recomendamos que elijas una zona horaria que no respete el horario de verano. En particular, se recomienda usar UTC para que Cloud Scheduler evite 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 09:00 (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 la semana (de lunes a viernes) a las 22:00 (10:00 p.m.) | 0 22 * * 1-5 |