克朗
安排在 cron 表达式上调用 Edge 函数。每个计划的运行都会将一个作业放入与异步调用相同的队列中,由工作线程池使用 - 在失败时无需重试。
您的功能又多了一个触发器#
除了同步 HTTP 调用和手动排队异步作业之外,aura-functions 服务还可以按计划调用边缘函数 — 请参阅 /docs/functions。没有单独的“cron”功能:任何已部署的功能都可以作为时间表的目标。
Cron 计划 Edge Functions (aura-functions),而不是数据库内 SQL 作业(pg_cron 未安装在托管 Postgres 映像中)。对于数据库维护(物化视图、定期清理),请安排一个通过 @aurabase/aurabase-js 或 DATABASE_URL连接到数据库的边缘函数。
Cron 将作业排入队列,但不运行该函数#
cron 运行不会直接启动该函数:它会在队列中创建一个 作业 (与 POST /v1/functions/:projectId/jobs相同的表和相同的工作池),并在 cron 创建时冻结有效负载。然后,该工作将像其他工作一样被工人消耗掉。
TRIGGER ────▶ 进程内调度程序在预定时间触发
ENQUEUE ────▶ 创建一个作业(function_name + cron 负载)
WORKER ────▶ 工作池消耗作业,调用函数
FAILURE ────▶ max_attempts=1 → 立即死亡(DLQ),不重试
SUCCESS ────▶ Last_run + next_run 在 cron 线上更新
当服务重新启动时,所有配置项目的所有活动 cron 都会从数据库中重新加载并重新安排 - 任务列表不会单独保留在内存中。
调度程序提供什么#
- 进程内调度程序。 tokio-cron-scheduler + aura-functions 中的 cron 箱:无外部服务,内存中调度在启动时重新安排。
- 每次运行都是一个作业。 cron 本身不执行任何操作:它会将作业排入队列(如异步模式下的functions.invoke),由同一工作池使用。
- 无需重试。 由 cron 创建的作业的 max_attempts=1:失败时会将其直接切换到 DLQ(死亡),这与经典的异步作业(默认情况下尝试 3 次)不同。
- Last_run/next_run 跟踪。 每个触发器都会对last_run 加上时间戳,并根据存储的表达式预先计算next_run - 通过listCronJobs() 可见。
创建、列出、删除#
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(url, serviceRoleKey)
// 5 字段表达式(分钟、小时、日期、月份 dsem)— 秒为
// 隐式为 0。还接受 6 字段表达式(带秒)。
await aura.functions.createCronJob(
'rollup-15min', // 名称,每个项目唯一
'*/15 * * * *', // 规划
'rollup', // 每次运行时调用的函数
{ payload: { minutes: 15 } },
)
const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
每个项目的 cron 名称都是唯一的,并用作删除的标识符 (DELETE /v1/functions/:projectId/cron/:nom) — 客户端无需记住 UUID。
cron 还没有做什么#
与函数秘密 (aura secrets) 不同,现在没有 aura functions cron 命令:计划任务的管理通过 SDK 或 REST API,而不是通过 CLI。
来自 cron 的作业在第一次尝试时直接在 dead (DLQ) 中失败 — max_attempts 值得 1,而经典异步作业的默认值是 3。因此,如果要保证底层操作,则 cron 调用的函数必须处理自己的重播,否则您必须监视 DLQ (GET /v1/functions/:projectId/jobs/dlq) 并手动重播。