크론
cron 표현식에서 Edge Function 호출을 예약합니다. 예약된 각 실행은 실패 시 재시도하지 않고 작업자 풀에서 사용되는 비동기 호출과 동일한 대기열에 작업을 넣습니다.
함수에 대한 또 하나의 트리거#
aura-functions 서비스는 동기 HTTP 호출 및 수동으로 대기 중인 비동기 작업 외에도 일정에 따라 Edge Function을 호출할 수 있습니다. /docs/functions을 참조하세요. 별도의 "cron" 기능은 없습니다. 배포된 모든 기능은 일정의 대상이 될 수 있습니다.
Cron은 데이터베이스 내 SQL 작업이 아닌 Edge Functions (aura-functions)를 예약합니다(pg_cron는 관리되는 Postgres 이미지에 설치되지 않음). 데이터베이스 유지 관리(구체화된 뷰, 주기적인 정리)의 경우 @aurabase/aurabase-js 또는 DATABASE_URL를 통해 데이터베이스에 연결하는 Edge Function을 예약하세요.
Cron이 작업을 대기열에 추가하지만 기능을 실행하지는 않습니다.#
cron 실행은 함수를 직접 시작하지 않습니다. cron 생성 시 페이로드가 고정된 대기열( POST /v1/functions/:projectId/jobs과 동일한 테이블 및 동일한 작업자 풀)에 작업을 생성합니다. 그러면 해당 작업은 다른 작업과 마찬가지로 작업자에 의해 소비됩니다.
TRIGGER ────▶ 진행 중인 스케줄러가 예약된 시간에 트리거됩니다.
ENQUEUE ────▶ 작업이 생성됩니다(function_name + cron 페이로드).
WORKER ────▶ 작업자 풀이 작업을 소비하고 함수를 호출합니다.
FAILURE ────▶ max_attempts=1 → 즉시 중단(DLQ), 재시도 없음
SUCCESS ────▶ last_run + next_run이 cron 라인에서 업데이트됨
서비스가 다시 시작되면 프로비저닝된 모든 프로젝트의 모든 활성 크론이 데이터베이스에서 다시 로드되고 일정이 변경됩니다. 작업 목록은 메모리에만 유지되지 않습니다.
스케줄러가 제공하는 것#
- 진행 중인 스케줄러. tokio-cron-scheduler + aura-functions의 cron 크레이트: 외부 서비스가 없으며 시작 시 메모리 내 일정이 다시 예약됩니다.
- 각 실행은 작업입니다. cron은 자체적으로 아무것도 실행하지 않습니다. 동일한 작업자 풀에서 사용되는 작업(비동기 모드의 function.invoke와 같은)을 대기열에 추가합니다.
- 재시도하지 않음. cron에 의해 생성된 작업에는 max_attempts=1이 있습니다. 기존 비동기 작업(기본적으로 3회 시도)과 달리 실패하면 DLQ(죽음)로 직접 전환됩니다.
- Last_run/next_run 추적. 각 트리거는 last_run을 타임스탬프화하고 listCronJobs()를 통해 표시되는 저장된 표현식에서 next_run을 미리 계산합니다.
생성, 나열, 삭제#
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가 없습니다.
크론이 (아직) 하지 않는 것#
함수 비밀(aura secrets)과 달리 현재는 aura functions cron 명령이 없습니다. 예약된 작업 관리는 CLI가 아닌 SDK 또는 REST API를 통해 이루어집니다.
cron의 작업은 첫 번째 시도에서 dead(DLQ)에서 직접 실패합니다. — max_attempts는 1의 가치가 있는데, 이는 클래식 비동기 작업의 기본 값이 3인 것과 비교됩니다. 따라서 cron 호출 함수는 기본 작업이 보장되는 경우 자체 재생을 처리해야 합니다. 그렇지 않으면 DLQ(GET /v1/functions/:projectId/jobs/dlq)를 모니터링하고 수동으로 재생해야 합니다.