Los trabajos cron se programan en intervalos recurrentes, que se especifican 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, aún se admite la programación de un trabajo mediante la creación de un archivo cron.yaml para los trabajos existentes).
Cloud Scheduler también admite la programación de trabajos con un formato más legible por humanos. Para obtener más información, consulta Formato de trabajo alternativo en este documento.
Formato de trabajo cron
Puedes usar la consola de Google Cloud , la Google Cloud CLI o la API de REST de Cloud Scheduler para establecer tu programa.
Un programa se define con el formato de cadena unix-cron (* * * * *), que es un
conjunto de cinco campos en una línea que indica cuándo se debe ejecutar el trabajo.
Los campos de hora tienen el siguiente formato y los valores posibles, y deben seguir este orden:
|------------------------------- Minute (0-59) | |------------------------- Hour (0-23) | | |------------------- Day of the month (1-31) | | | |------------- Month (1-12; or JAN to DEC) | | | | |------- Day of the week (0-6; or SUN to SAT; or 7 for Sunday) | | | | | | | | | | * * * * *
| Campo | Formato de valores válidos |
|---|---|
| Minuta | 0-59 |
| Hora | 0-23 |
| día del mes | 1-31 |
| Mes | Del 1 al 12 (o de ENE a DIC) |
| Día de la semana | 0-6 (o de DOM a SÁB; o 7 para el domingo) |
Minuto: Indica cuánto tiempo después de la hora en punto se ejecuta el trabajo, en minutos. Por ejemplo, si el minuto se establece en
0, el trabajo se ejecuta al comienzo de la hora (porque son 0 minutos después de la hora). Por lo tanto, si la hora es las 8:00 a.m., el trabajo se ejecuta a las 8:00 a.m.Hora: Indica cuántas horas después de la medianoche se ejecuta tu trabajo (se redondea hacia abajo a la hora más cercana, ya que los minutos restantes se indican en el campo
minute). La medianoche es0y el mediodía es12. Por ejemplo, si la hora se establece en0, el trabajo se ejecuta a la medianoche (porque es 0 horas después de la medianoche).Día del mes: Indica la fecha del calendario del mes. Por ejemplo,
1para el primer día del mes. Cloud Scheduler no admiteLpara indicar el último día del mes.Mes: Indica el mes. Especifica el número del mes o las primeras tres letras del nombre del mes en mayúsculas. Por ejemplo,
1para enero o, de manera equivalente,JAN.Día de la semana: Indica el día de la semana. Por ejemplo, el lunes es
1y el martes es2. Tanto0como7pueden indicar el domingo. Especifica el día de la semana con un número o con las primeras tres letras del nombre del día en mayúsculas (por ejemplo,SUNpara domingo).- Este campo se evalúa como un
ORinclusivo con el campoday of the month, a menos que uno de estos campos esté marcado como sin restricciones por el asterisco (*). Por ejemplo, si el día del mes se establece en1y el día de la semana se establece enSAT, el trabajo se ejecuta el primer día del mes y todos los sábados del mes, incluso si el primer día del mes no es un sábado. Si el día de la semana no tiene restricciones (se establece en*), el trabajo se ejecuta solo el primer día del mes.
- Este campo se evalúa como un
Coincide con todos los valores
Para que coincidan todos los valores de un campo, usa el asterisco: *. Cuando un campo se establece en
el asterisco, el campo coincide con todos los valores válidos para ese campo siempre que se
cumplan las demás condiciones del campo. A veces, configurar un campo con el asterisco se denomina dejar el campo sin restricciones, porque no está restringido a un valor específico.
Aquí hay dos ejemplos en los que el campo de minutos se deja sin restricciones:
* 0 1 1 1: El trabajo se ejecuta cada minuto de la hora de medianoche el 1 de enero y los lunes.* * * * *: El trabajo se ejecuta cada minuto (de cada hora, de cada día del mes, de cada mes, cada día de la semana, porque cada uno de estos campos tampoco tiene restricciones).
El asterisco equivale a un caso especial de un rango, en el que el
rango comienza en el primer valor válido para el campo y termina en el último valor válido
para el campo (por ejemplo, 0-59 para el campo de minutos).
Coincidencia con un rango
Para que coincida con un rango de valores, especifica los valores de inicio y detención, separados por un
guion (-). No incluyas espacios en el rango. Los rangos son inclusivos. El
primer número debe ser menor que el segundo. Si usas nombres abreviados
para el mes o el día de la semana (por ejemplo, JAN en lugar de 1 para el primer
mes del año), el primer valor debe aparecer antes en el mes o la semana que
el segundo valor.
Los siguientes ejemplos equivalentes se ejecutan a la medianoche de los lunes, martes, miércoles, jueves y viernes (todos los meses):
0 0 * * 1-50 0 * * MON-FRI
Cómo hacer coincidir una lista
Las listas pueden contener cualquier valor válido para el campo, incluidos los rangos.
Especifica tus valores separados por una coma (,). No incluyas espacios en la
lista.
Ejemplos:
0 0,12 * * *: El trabajo se ejecuta a la medianoche y al mediodía.0-5,30-35 * * * *: El trabajo se ejecuta en cada uno de los primeros cinco minutos de cada media hora (al comienzo de la hora y a la media hora).
Cómo omitir valores en un rango
Puedes omitir valores en un rango especificando una tasa para recorrer el rango. A veces, esto se denomina usar una función escalonada (o un valor o una expresión de tasa escalonados). Para ello, especifica el rango, seguido de la
barra diagonal (/) y la frecuencia con la que deseas omitir el rango.
Puedes usar el asterisco (*) para indicar el rango de todos los valores del campo.
Cuando usas el asterisco, el primer valor del rango es 0 para los campos de minuto,
hora y día de la semana (domingo), y 1 para los campos de día del mes y
mes.
El valor del paso no puede ser mayor que el valor más alto posible para el campo.
El paso predeterminado es 1, por lo que la función de paso /1 es igual que no usar una función de paso.
Ejemplos de rangos que usan funciones escalonadas:
*/2: Esta es una función escalonada válida para cualquier campo. Para el campo de minutos, coincide con 0, 2, 4, …, 58. Para la hora, coincide con 0, 2, 4, …, 22. Para el día del mes, coincide con 1, 3, 5, …, 31 (para un mes con 31 días). Para el mes, coincide con 1, 3, 5, ... , 11. Para el día de la semana, coincide con 0, 2, 4, 6.0-12/2: Esta es una función de paso válida para los campos de minutos y horas. Coincide con 0, 2, 4, ... , 12.
Ejemplos de programas que usan funciones escalonadas:
*/2 * * * *: El trabajo se ejecuta cada dos minutos.0 0-12/2 * * *: El trabajo se ejecuta cada dos horas, en punto. La primera ejecución es a la medianoche. La última ejecución es al mediodía.
Programas de muestra
En la siguiente tabla, se muestran algunos ejemplos de programas de trabajo cron y sus descripciones:
| Programa | Formato de trabajo cron | Explicación |
|---|---|---|
| Cada minuto | * * * * * |
Se ejecuta cada minuto. Por ejemplo, 9:00 a.m., 9:01 a.m., 9:02 a.m., etcétera. |
| Cada 1 hora | 0 * * * * |
Se ejecuta cada hora. Por ejemplo, 9:00 a.m., 10:00 a.m., 11:00 a.m., etcétera. |
| Todos los días | 0 0 * * * |
Se ejecuta todos los días a las 12:00 a.m. (00:00 en formato de 24 horas). |
| Todos los días de semana (lun-vie) |
Las siguientes opciones son equivalentes:
|
Se ejecuta a las 12:00 a.m. (00:00 en formato de 24 horas) los lunes, martes, miércoles, jueves y viernes. |
| Todas las semanas | Las siguientes opciones son equivalentes:
|
Se ejecuta los domingos a las 12:00 a.m. (00:00 en formato de 24 horas). |
| Todos los meses | 0 0 1 * * |
Se ejecuta a las 12:00 a.m. (00:00 en formato de 24 horas) el primer día del mes. |
| Todos los trimestres | Las siguientes opciones son equivalentes:
|
Se ejecuta a las 12:00 a.m. (00:00 en formato de 24 horas) el primer día del trimestre, para un programa trimestral estándar: 1 de enero, 1 de abril, 1 de julio y 1 de octubre. |
| Todos los años | Las siguientes opciones son equivalentes:
|
Se ejecuta a las 12:00 a.m. (00:00 en formato de 24 horas) el primer día del primer mes del año (1 de enero). |
Zona horaria
Puedes seleccionar la zona horaria para evaluar el programa en la
Google Cloud consola (en la página Crear un trabajo, selecciona una Zona horaria de
la lista) o con la marca gcloud
--time-zone cuando
creas el trabajo.
El valor de este campo debe ser la abreviatura de la zona horaria que se usa en la
base de datos tz.
La zona horaria predeterminada es UTC.
En algunas zonas horarias, el horario de verano puede hacer que los trabajos se ejecuten o no de forma inesperada. Esto se debe a que Cloud Scheduler se ejecuta en tiempo real. En los casos en que una hora puede ocurrir dos veces (como cuando los relojes se atrasan) y tu trabajo está programado para esta hora, es posible que el trabajo programado observe anomalías en la ejecución.
Si tu trabajo requiere una cadencia muy específica, te recomendamos que elijas una zona horaria que no tenga horario de verano. En particular, se recomienda la UTC para Cloud Scheduler para evitar el problema por completo.
Formato de trabajo alternativo
Puedes usar un formato de especificación de hora más legible por humanos conocido como groc, que proporciona una alternativa a las expresiones cron. Por ejemplo, algunos eventos recurrentes pueden ser difíciles de especificar con cron, como "el tercer martes de cada mes" o "cada dos semanas" (cada 336 horas). En esos casos, puedes usar construcciones como las de los siguientes ejemplos:
03 of month 12:34
1,3,4,7,11,18,29 of jan,jul 12:34
1st friday of quarter 9:00
1st,third monday of month 04:00
2nd,3rd tue,wed,thu of feb,aug 13:50
every 336 hours
every 48 hours
every 5 minutes
every 60 minutes on mon,wed
every day 09:00
every minute
every sun,tue,thu 9:00
every wed of december 00:00
first sunday of month 12:00
second,4th tue,thursday of 3rd month of quarter 18:30
Cuando especifiques un programa de trabajos con groc, debes usar la gcloud CLI o realizar una solicitud directa a la API de Cloud Scheduler.
Para obtener más información sobre la sintaxis, consulta Define la programación del trabajo cron.
¿Qué sigue?
- Anula la duplicación de solicitudes de trabajo
- Cambia la región o zona predeterminadas
- Visualiza las regiones y zonas disponibles