Cron
Agende a invocação de uma função Edge em uma expressão cron. Cada execução agendada coloca um trabalho na mesma fila que as invocações assíncronas, consumidas pelo conjunto de trabalhadores — sem tentar novamente em caso de falha.
Mais um gatilho para suas funções#
O serviço aura-functions pode invocar uma Edge Function de acordo com um agendamento, além de invocações HTTP síncronas e trabalhos assíncronos enfileirados manualmente — consulte /docs/functions. Não existe uma função “cron” separada: qualquer função implantada pode ser alvo de um agendamento.
Cron agenda Edge Functions (aura-functions), não trabalhos SQL no banco de dados (pg_cron não está instalado na imagem Postgres gerenciada). Para manutenção do banco de dados (visualizações materializadas, limpezas periódicas), agende uma Edge Function que se conecte ao seu banco de dados via @aurabase/aurabase-js ou DATABASE_URL.
Cron enfileira um trabalho, ele não executa a função#
Uma execução do cron não inicia a função diretamente: ela cria um trabalho na fila (as mesmas tabelas e o mesmo pool de trabalhadores que POST /v1/functions/:projectId/jobs), com uma carga congelada no momento da criação do cron. O trabalho é então consumido por um trabalhador como qualquer outro trabalho.
TRIGGER ────▶ o agendador em processo é acionado no horário agendado
ENQUEUE ────▶ um trabalho é criado (nome_da_função + carga útil do cron)
WORKER ────▶ o pool de trabalhadores consome o trabalho, invoca a função
FAILURE ────▶ max_attempts=1 → morto (DLQ) imediatamente, sem nova tentativa
SUCCESS ────▶ last_run + next_run atualizado na linha cron
Quando o serviço é reiniciado, todos os crons ativos de todos os projetos provisionados são recarregados do banco de dados e reprogramados — a lista de tarefas não persiste apenas na memória.
O que o agendador fornece#
- Agendador em processo. tokio-cron-scheduler + a caixa cron em aura-functions: nenhum serviço externo, agendamento na memória reprogramado na inicialização.
- Cada execução é um trabalho. O cron não executa nada sozinho: ele enfileira um trabalho (como funções.invoke no modo assíncrono), consumido pelo mesmo conjunto de trabalhadores.
- Sem tentar novamente. Um trabalho criado pelo cron tem max_attempts=1: uma falha o alterna diretamente para DLQ (morto), ao contrário dos trabalhos assíncronos clássicos (3 tentativas por padrão).
- Rastreamento da última/próxima execução. Cada gatilho registra a data e hora de last_run e pré-calcula next_run a partir da expressão armazenada - visível via listCronJobs().
Criar, listar, excluir#
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(url, serviceRoleKey)
// Expressão de 5 campos (min hora dia mês dsem) — os segundos são
// implicitamente 0. Uma expressão de 6 campos (com segundos) também é aceita.
await aura.functions.createCronJob(
'rollup-15min', // nome, exclusivo por projeto
'*/15 * * * *', // planejamento
'rollup', // função invocada em cada execução
{ payload: { minutes: 15 } },
)
const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
O nome de um cron é exclusivo por projeto e serve como identificador para exclusão (DELETE /v1/functions/:projectId/cron/:nom) — não há UUID para lembrar no lado do cliente.
O que o cron não faz (ainda)#
Ao contrário dos segredos de função (aura secrets), não existe nenhum comando aura functions cron hoje: o gerenciamento de tarefas agendadas passa pelo SDK ou pela API REST, não pela CLI.
Um trabalho do cron falha diretamente em dead (DLQ) na primeira tentativa — max_attempts vale 1, comparado a 3 por padrão para um trabalho assíncrono clássico. Uma função invocada pelo cron deve, portanto, manipular seus próprios replays se a operação subjacente for garantida, ou você deverá monitorar o DLQ (GET /v1/functions/:projectId/jobs/dlq) e reproduzir manualmente.
Para ir mais longe#
- Edge Functions
Tempos de execução, invocação, trabalhos, DLQ, segredos — o serviço que o cron aciona.
- Cofre
Criptografia de segredos injetados na função invocada pelo cron.
- Banco de dados
Postgres 18 extensões permitidas, RLS e migrações.
- SDK JavaScript
createCronJob, listCronJobs, deleteCronJob — a superfície exata do cliente.