Java 8 ha llegado al final del ciclo de asistencia y se dejará de usar el 31 de enero del 2026. Después de la retirada, no podrás implementar aplicaciones Java 8, aunque tu organización haya usado anteriormente una política de organización para volver a habilitar las implementaciones de los tiempos de ejecución antiguos. Tus aplicaciones Java 8 seguirán ejecutándose y recibiendo tráfico después de la fecha de retirada. Te recomendamos que migres a la versión más reciente compatible de Java.

Esta página se ha traducido con Cloud Translation API.

Referencia de cron.xml para las herramientas basadas en el SDK de App Engine

Usa el archivo cron.yaml para definir las tareas programadas de tu aplicación.

Para obtener más información sobre la programación de tareas, incluido cómo probar, implementar o eliminar tareas cron, consulta Programar tareas con Cron.

Ejemplo

A continuación, se muestra un ejemplo de archivo cron.yaml:

cron:
- description: "daily summary job"
  url: /tasks/summary
  schedule: every 24 hours
- description: "monday morning mailout"
  url: /mail/weekly
  schedule: every monday 09:00
  timezone: Australia/NSW
- description: "new daily summary job"
  url: /tasks/summary
  schedule: every 24 hours
  target: beta

Sintaxis

El archivo cron.yaml debe estar en el directorio raíz de tu aplicación junto con app.yaml: cron.yaml configura las tareas programadas de tu aplicación Java 8.

Definiciones de tareas cron

Elemento	Descripción
`description`	Opcional. La descripción se puede ver en la Google Cloud consola y en la interfaz de administración del servidor de desarrollo.
`retry_parameters`	Opcional. Si el controlador de solicitudes de una tarea cron devuelve un código de estado HTTP que no está en el intervalo 200-299 (inclusive), App Engine considera que la tarea ha fallado. De forma predeterminada, los trabajos fallidos no se vuelven a intentar. Puedes hacer que se vuelva a intentar ejecutar los trabajos fallidos incluyendo un bloque retry-parameters en tu archivo de configuración. Para obtener más información, consulta la sección Reintentos de cron.
`schedule`	Obligatorio. Define la programación de cuándo se ejecuta la tarea cron. Consulta la sintaxis más abajo.
`target`	La cadena `target` se añade al principio del nombre de host de tu aplicación. Suele ser el nombre de un servicio. La tarea cron se dirigirá a la versión del servicio con nombre que esté configurada para el tráfico. Advertencia: Ten cuidado si ejecutas un trabajo cron con división del tráfico habilitada. La solicitud del trabajo cron siempre se envía desde la misma dirección IP, por lo que, si has especificado la división de direcciones IP, la lógica dirigirá la solicitud a la misma versión cada vez. Si has especificado la división de cookies, la solicitud no se dividirá en absoluto, ya que no hay ninguna cookie que acompañe a la solicitud. Si no se encuentra el nombre del servicio especificado en `target`, la solicitud de Cron se dirige al servicio `default` o a la versión de tu aplicación que esté configurada para recibir tráfico.Para obtener más información sobre el enrutamiento, consulta Cómo se enrutan las solicitudes.
`timezone`	El `timezone` debe ser el nombre de una zona horaria zoneinfo estándar. Si no especifica una zona horaria, los trabajos se ejecutarán en UTC (también conocido como GMT).
`url`	Obligatorio. El campo `url` es solo una URL de tu aplicación. Si el elemento `url` contiene los caracteres especiales de XML `&`, `<`, `>`, `'` o `"`, debe usar el carácter de escape.

Definir la tarea cron `schedule`

Las tareas cron se programan en intervalos periódicos y se especifican con un formato sencillo similar al inglés. Puedes definir una programación para que las tareas se ejecuten varias veces al día, o en días y meses concretos.

Intervalos inferiores a un día

Usa un intervalo inferior a un día para ejecutar un trabajo varias veces al día según una programación repetitiva. Puedes definir un intervalo de tiempo de finalización o un intervalo de tiempo de inicio:

Intervalo de tiempo de finalización: define el tiempo entre la "hora de finalización" de un trabajo y el momento en el que empieza el siguiente. La "hora de finalización" es el momento en el que se completa el trabajo o en el que se agota el tiempo de espera. El servicio Cron ejecuta tareas en este tipo de intervalo durante las 24 horas del día, empezando a las 00:00, y espera el periodo de tiempo especificado entre cada tarea.
Ejemplo: En la programación every 5 minutes, la tarea se ejecuta a diario con un intervalo de 5 minutos. Si una instancia de un trabajo que se está ejecutando según esta programación se completa a las 02:01, el siguiente trabajo espera 5 minutos y vuelve a iniciarse a las 02:06.
Intervalo de tiempo de inicio: define un intervalo de tiempo regular para que el servicio Cron inicie cada tarea. A diferencia del intervalo de tiempo de finalización, el intervalo de tiempo de inicio ejecuta cada trabajo independientemente de cuándo finalice o se agote el tiempo del trabajo anterior. Puedes definir un intervalo de tiempo en el que quieras que se ejecute el trabajo o ejecutar trabajos las 24 horas del día, a partir de las 00:00.
Como la hora de inicio de una tarea es estricta, si una instancia de una tarea se ejecuta durante más tiempo del intervalo definido, el servicio Cron puede omitir una tarea. Se puede omitir una hora de inicio individual en el intervalo si la tarea anterior no se ha completado o se ha agotado el tiempo .

Ejemplo: En la every 5 minutes from 10:00 to 14:00 programación, la primera tarea se empieza a ejecutar a las 10:00 y, después, cada 5 minutos. Si la primera tarea se ejecuta durante 7 minutos, se omitirá la tarea 10:05 y, por lo tanto, el servicio Cron no ejecutará otra instancia de esta tarea hasta 10:10.

Intervalo personalizado

Puedes usar un intervalo personalizado para definir una programación en la que tu tarea se pueda ejecutar una vez al día en uno o varios días seleccionados, y en uno o varios meses seleccionados. Las tareas que se ejecutan según una programación personalizada se ejecutan durante todo el año, solo a la hora específica de los días y meses seleccionados.

Ejemplo: En la 1,2,3 of month 07:00, el trabajo se ejecuta una vez a las 07:00 los tres primeros días de cada mes.

Cuestiones importantes sobre schedule:

Debes decidir si quieres usar un intervalo inferior a un día o un intervalo personalizado. No puedes mezclar ni usar elementos de los distintos tipos de intervalo. A continuación, se muestra un ejemplo de una definición de programación no válida: <schedule>every 6 hours mon,wed,fri</schedule>.
Solo se debe ejecutar una instancia de un trabajo en cualquier momento. El servicio Cron se ha diseñado para ofrecer una entrega "al menos una vez"; es decir, si se programa una tarea, App Engine envía la solicitud de la tarea al menos una vez. En algunas circunstancias poco frecuentes, es posible que se soliciten varias instancias del mismo trabajo. Por lo tanto, tu controlador de solicitudes debe ser idempotente y tu código debe asegurarse de que no haya efectos secundarios perjudiciales si esto ocurre.

Formatear el `schedule`

Para especificar cuándo se ejecuta el trabajo, debes definir el elemento schedule con la siguiente sintaxis:

<schedule>[TYPE] [INTERVAL_VALUE] [INTERVAL_SCOPE]</schedule>

Elige un tipo de intervalo para definir el elemento schedule:

Intervalo de hora de finalización

[TYPE]: Los intervalos diarios deben incluir el prefijo every.
Ejemplo: <schedule>every 12 hours</schedule>
[INTERVAL_VALUE]: un valor entero y la unidad de tiempo correspondiente. Valores válidos para la unidad de tiempo:
- minutes o mins
- hours
[INTERVAL_SCOPE]: no aplicable. Para definir una hora de inicio específica o un intervalo en el que quieras que se ejecuten tus trabajos, consulta la sintaxis del intervalo de hora de inicio o del intervalo personalizado.

Ejemplos de intervalos de tiempo de finalización

Consulta los siguientes ejemplos para saber cómo definir programaciones de trabajos que usen un intervalo de hora de finalización:

Empieza a ejecutarse todos los días a las 00:00 y espera 5 minutos entre cada trabajo. Después de que finalice cada tarea, el servicio Cron espera 5 minutos antes de ejecutar la siguiente:
```
<schedule>every 5 minutes</schedule>
```
Empieza a ejecutarse todos los días a las 00:00 y espera 30 minutos entre cada trabajo. Una vez que finaliza cada tarea, el servicio Cron espera 30 minutos antes de ejecutar la siguiente:
```
<schedule>every 30 mins</schedule>
```

Intervalo de tiempo de inicio

[TYPE]: Los intervalos diarios deben incluir el prefijo every.
Ejemplo: <schedule>every 12 hours</schedule>
[INTERVAL_VALUE]: un valor entero y la unidad de tiempo correspondiente. Valores válidos para la unidad de tiempo:
- minutes o mins
- hours
[INTERVAL_SCOPE] Especifica una cláusula que corresponde a [INTERVAL_VALUE]. Puedes definir un periodo personalizado o usar la opción 24 horas synchronized.
- Incluye la cláusula from [HH:MM] to [HH:MM] para definir una hora de inicio y un intervalo específicos en los que quieras ejecutar los trabajos.
  Debes especificar los valores de tiempo en el formato de 24 horas, HH:MM, donde:
  - HH son números enteros del 00 al 23.
  - MM son números enteros del 00 al 59.
- Use synchronized para especificar un intervalo de tiempo de 24 horas (from 00:00 to 23:59) que se divida de forma uniforme por el valor [INTERVAL_VALUE].
  Importante: [INTERVAL_VALUE] debe dividir 24 en un número entero. De lo contrario, se producirá un error. Los valores válidos de [INTERVAL_VALUE] son 1, 2, 3, 4, 6, 8, 12 o 24.

Ejemplos de intervalos de hora de inicio

Consulta los siguientes ejemplos para saber cómo definir programaciones de trabajos que usen un intervalo de hora de inicio:

Se ejecuta cada 5 minutos de 10:00 a 14:00 todos los días:

<schedule>every 5 minutes from 10:00 to 14:00</schedule>

Se ejecuta una vez cada hora de 08:00 a 16:00 todos los días:
```
<schedule>every 1 hours from 08:00 to 16:00</schedule>
```
Se ejecuta una vez cada dos horas, todos los días a partir de las 00:00:
```
<schedule>every 2 hours synchronized</schedule>
```

Intervalo personalizado

[TYPE]: Los intervalos personalizados pueden incluir el prefijo every para definir un intervalo repetitivo o puedes definir una lista específica de días de un mes:
- Para definir un intervalo repetitivo, puedes usar el prefijo every.
  Ejemplos:
```
<schedule>every day 00:00</schedule>
<schedule>every monday 09:00</schedule>
```
- Para definir días concretos, debes usar números ordinales. Los valores válidos van desde el primer día del mes hasta el número máximo de días de ese mes. Por ejemplo:
  - 1st o first
  - 2nd o second
  - 3rd o third
  - Hasta: 31st o thirtyfirst
  Ejemplo:
```
<schedule>1st,3rd tuesday</schedule>
<schedule>2nd,third wednesday of month 09:00</schedule>
```
[INTERVAL_VALUE]: los intervalos personalizados incluyen una lista de los días específicos en los que quieres que se ejecute la tarea. La lista debe definirse como una lista separada por comas y puede incluir cualquiera de los siguientes valores:
- Valor entero del día del mes, con un máximo de 31 días. Por ejemplo:
  - 1
  - 2
  - 3
  - Y hasta: 31
- El nombre del día en una combinación de cualquiera de los siguientes valores largos o abreviados:
  - monday o mon
  - tuesday o tue
  - wednesday o wed
  - thursday o thu
  - friday o fri
  - saturday o sat
  - sunday o sun
  - Usa day para especificar todos los días de la semana.
Ejemplos:
```
<schedule>2nd monday,thu</schedule>
<schedule>1,8,15,22 of month 09:00</schedule>
<schedule>1st mon,wednesday,thu of sep,oct,nov 17:00</schedule>
```
[INTERVAL_SCOPE]: especifica una cláusula que corresponde al [INTERVAL_VALUE] especificado. Los intervalos personalizados pueden incluir la cláusula of [MONTH], que especifica un solo mes de un año, o una lista de varios meses separados por comas. También debes definir una hora específica para la ejecución de la tarea. Por ejemplo: of [MONTH] [HH:MM].
De forma predeterminada, si se excluye la cláusula of, el intervalo personalizado se ejecuta cada mes.
- [MONTH]: debes especificar los meses en una lista separada por comas y puedes incluir una combinación de los siguientes valores largos o abreviados:
  - january o jan
  - february o feb
  - march o mar
  - april o apr
  - may
  - june o jun
  - july o jul
  - august o aug
  - september o sep
  - october o oct
  - november o nov
  - december o dec
  - Usa month para especificar todos los meses del año.
- [HH:MM]: debes especificar los valores de tiempo en formato de 24 horas, HH:MM, donde:
  - HH son números enteros del 00 al 23.
  - MM son números enteros del 00 al 59.

Ejemplos de intervalos personalizados

Consulta los siguientes ejemplos para saber cómo definir programaciones de trabajos que usen un intervalo personalizado:

Se ejecuta todos los días a las 00:00:
```
<schedule>every day 00:00</schedule>
```
Se ejecuta todos los lunes a las 09:00:
```
<schedule>every monday 09:00</schedule>
```
Se ejecuta una vez el segundo miércoles de marzo a las 17:00:
```
<schedule>2nd wednesday of march 17:00</schedule>
```
Se ejecuta seis veces en mayo. Durante las dos primeras semanas, se ejecuta una vez los lunes, los miércoles y los viernes a las 10:00:
```
<schedule>1st,second mon,wed,fri of may 10:00</schedule>
```
Se ejecuta una vez a la semana. Cada siete días a partir del primer día de cada mes, se ejecuta una vez a las 09:00:
```
<schedule>1,8,15,22 of month 09:00</schedule>
```
Se ejecuta cada dos semanas. El primer y el tercer lunes de cada mes, se ejecuta una vez a las 04:00:
```
<schedule>1st,third monday of month 04:00</schedule>
```
Se ejecuta tres veces al año. El primer lunes de septiembre, octubre y noviembre, se ejecuta una vez a las 09:00:
```
<schedule>1st monday of sep,oct,nov 09:00</schedule>
```
Se ejecuta una vez cada trimestre. El primer día de enero, abril, julio y octubre, se ejecuta una vez a las 00:00:
```
<schedule>1 of jan,april,july,oct 00:00</schedule>
```

Reintentos de cron

Si el controlador de solicitudes de un trabajo cron devuelve un código de estado que no está en el intervalo 200-299 (inclusive), App Engine considera que el trabajo ha fallado. De forma predeterminada, los trabajos fallidos no se vuelven a intentar. Para que se vuelva a intentar ejecutar las tareas fallidas, puedes incluir un bloque retry_parameters en el archivo de configuración.

Aquí tienes un archivo cron.xml de ejemplo que contiene una sola tarea cron configurada para reintentarse hasta cinco veces (el valor predeterminado) con un tiempo de espera inicial de 2,5 segundos que se duplica cada vez.

<cronentries>
  <cron>
    <url>/retry</url>
    <description>Retry on jsdk</description>
    <schedule>every 10 minutes</schedule>
    <retry-parameters>
      <min-backoff-seconds>2.5</min-backoff-seconds>
      <max-doublings>5</max-doublings>
    </retry-parameters>
  </cron>
</cronentries>

Sintaxis de reintentos de cron

Los parámetros de reintento se describen en la tabla de abajo.

Elemento	Descripción
`job_retry_limit`	El número máximo de reintentos de una tarea cron fallida no debe superar los 5. Si se especifica con `job_age_limit`, App Engine vuelve a intentar ejecutar la tarea cron hasta que se alcancen ambos límites. Si se omite en los parámetros, el límite se establece en 5 de forma predeterminada.
`job_age_limit`	El límite de tiempo para volver a intentar una tarea cron fallida, medido desde la primera vez que se ejecutó la tarea cron. El valor es un número seguido de una unidad de tiempo, donde la unidad es `s` para segundos, `m` para minutos, `h` para horas o `d` para días. Por ejemplo, el valor `5d` especifica un límite de cinco días después del primer intento de ejecución del trabajo cron. Si se especifica con `job_retry_limit`, App Engine vuelve a intentar ejecutar la tarea cron hasta que se alcancen ambos límites.
`min_backoff_seconds`	Número mínimo de segundos que se debe esperar antes de volver a intentar ejecutar una tarea cron después de que falle.
`max_backoff_seconds`	Número máximo de segundos que se debe esperar antes de volver a intentar ejecutar un trabajo cron después de que falle.
`max_doublings`	Número máximo de veces que se duplicará el intervalo entre reintentos de trabajos cron fallidos antes de que el aumento se convierta en constante. La constante es: 2*(`max_doublings` - 1) `min_backoff`.

Solicitudes cron

Encabezados de solicitud

Las solicitudes del servicio Cron contendrán una cabecera HTTP:

X-Appengine-Cron: true

App Engine define este y otros encabezados internamente. Si un cliente envía estos encabezados, se eliminan de la solicitud. La excepción son las solicitudes de administradores que hayan iniciado sesión en aplicaciones antiguas, que pueden definir el encabezado con fines de prueba.

Dirección IP de origen

App Engine envía solicitudes Cron desde la dirección IP 0.1.0.2. En el caso de las tareas cron creadas con versiones anteriores de gcloud (anteriores a la 326.0.0), las solicitudes cron procederán de 0.1.0.1.

Tiempo de espera de solicitud

El tiempo de espera de la solicitud cron depende del tipo de escalado configurado para tu aplicación:

Escalado automático: Tiempo de espera de la solicitud de 10 minutos.
Escalado básico y escalado manual: Tiempo de espera de la solicitud de 24 horas.

Para obtener más información, consulta Cómo se gestionan las instancias.

Límites

Las aplicaciones gratuitas pueden tener hasta 20 tareas programadas. Las aplicaciones de pago pueden tener hasta 250 tareas programadas.

Compatibilidad con cron en el servidor de desarrollo

El servidor de desarrollo no ejecuta automáticamente tus tareas cron. Puedes usar la interfaz de tareas cron o programadas de tu ordenador local para activar las URLs de tus trabajos con curl o una herramienta similar.

Desplegar tareas cron

Puedes usar la CLI de gcloud para desplegar tus tareas cron en App Engine.

Para implementar los trabajos cron especificados en el archivo de configuración cron.yaml, ejecuta el siguiente comando:

gcloud

    gcloud app deploy cron.yaml

Maven

    mvn appengine:deployCron cron.yaml

Gradle

    gradle appengineDeployCron cron.yaml

IDE

Si usas IntelliJ o Eclipse, puedes seleccionar los archivos de configuración individuales que quieras implementar mediante el formulario de implementación.

Eliminar todas las tareas cron

Para eliminar todos los cron jobs, sigue estos pasos:

Edita el contenido del archivo cron.yaml para que sea el siguiente:

cron:
Despliega el archivo cron.yaml en App Engine.

Compatibilidad con Cron en la consola Google Cloud

La página Colas de tareas de la Google Cloud consola Google Cloud tiene una pestaña que muestra las tareas que están ejecutando trabajos cron.

También puedes visitar la página Registros para ver cuándo se han añadido o eliminado los trabajos cron.