Saltar al contenido
Logotipo de Aurabase
aurabase

cron

Programe la invocación de una función perimetral en una expresión cron. Cada ejecución programada coloca un trabajo en la misma cola que las invocaciones asincrónicas, consumidas por el grupo de trabajadores, sin volver a intentarlo en caso de falla.

Explicación5 min leerNivel intermedioRevisado el 15 ago 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

Un disparador más para tus funciones#

El servicio aura-functions puede invocar una función perimetral según una programación, además de invocaciones HTTP sincrónicas y trabajos asincrónicos en cola manualmente; consulte /docs/functions. No existe una función "cron" separada: cualquier función implementada puede ser objeto de una programación.

Información

Cron programa Edge Functions (aura-functions), no trabajos SQL en la base de datos (pg_cron no está instalado en la imagen administrada Postgres). Para el mantenimiento de la base de datos (vistas materializadas, limpiezas periódicas), programe una función perimetral que se conecte a su base de datos a través de @aurabase/aurabase-js o DATABASE_URL.

Cron pone en cola un trabajo, no ejecuta la función#

Una ejecución cron no inicia la función directamente: crea una trabajo en la cola (las mismas tablas y el mismo grupo de trabajadores que POST /v1/functions/:projectId/jobs), con una carga útil congelada en el momento de la creación del cron. Luego, el trabajo es consumido por un trabajador como cualquier otro trabajo.

ciclo de una ejecución programadatext
TRIGGER   ────▶  el programador en proceso se activa a la hora programada
ENQUEUE   ────▶  se crea un trabajo (nombre_función + carga útil cron)
WORKER    ────▶  el grupo de trabajadores consume el trabajo, invoca la función
FAILURE     ────▶  max_attempts=1 → muerto (DLQ) inmediatamente, no hay reintento
SUCCESS    ────▶  last_run + next_run actualizado en la línea cron
Consejo

Cuando se reinicia el servicio, todos los crons activos de todos los proyectos aprovisionados se recargan desde la base de datos y se reprograman; la lista de tareas no persiste únicamente en la memoria.

Lo que proporciona el planificador#

  • Programador en proceso. tokio-cron-scheduler + la caja cron en aura-functions: sin servicio externo, programación en memoria reprogramada al inicio.
  • Cada ejecución es un trabajo. El cron no ejecuta nada por sí mismo: pone en cola un trabajo (como funciones.invoke en modo asincrónico), consumido por el mismo grupo de trabajadores.
  • Sin reintento. Un trabajo creado por el cron tiene max_attempts=1: un fallo lo cambia directamente a DLQ (inactivo), a diferencia de los trabajos asincrónicos clásicos (3 intentos por defecto).
  • Seguimiento de última_ejecución/siguiente_ejecución. Cada disparador marca la hora de last_run y calcula previamente next_run a partir de la expresión almacenada, visible a través de listCronJobs().

Crear, enumerar, eliminar#

app/cron.tstypescript
import { createClient } from '@aurabase/aurabase-js'

const aura = createClient(url, serviceRoleKey)

// Expresión de 5 campos (min hora día mes dsem): los segundos son
// implícitamente 0. También se acepta una expresión de 6 campos (con segundos).
await aura.functions.createCronJob(
  'rollup-15min',      // nombre, único por proyecto
  '*/15 * * * *',      // planificación
  'rollup',             // función invocada en cada ejecución
  { payload: { minutes: 15 } },
)

const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
Consejo

El nombre de un cron es único por proyecto y sirve como identificador para la eliminación (DELETE /v1/functions/:projectId/cron/:nom): no hay ningún UUID que recordar en el lado del cliente.

Lo que cron no hace (todavía)#

Sin comando CLI dedicado

A diferencia de los secretos de función (aura secrets), hoy no existe el comando aura functions cron: la gestión de las tareas programadas se realiza a través del SDK o la API REST, no a través de la CLI.

Sin reintento automático

Un trabajo del cron falla directamente en dead (DLQ) en el primer intento: max_attempts vale 1, en comparación con 3 de forma predeterminada para un trabajo asincrónico clásico. Por lo tanto, una función invocada por cron debe manejar sus propias repeticiones si se quiere garantizar la operación subyacente, o debe monitorear el DLQ (GET /v1/functions/:projectId/jobs/dlq) y reproducir manualmente.

para ir más lejos#