새로운Publication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2변경 내역 보기 →

Edge Functions

데이터 옆에 있는 서버 코드.

Deno 함수를 작성하고, 입력된 오류 및 시간 초과와 함께 SDK에서 함수를 호출하고, 요청 시, 백그라운드에서 또는 일정에 따라 실행합니다.

Deno
런타임
3
실행 방법: 온디맨드, 작업, 크론
functions.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
const { data, error } = await aura.functions.invoke<{ ok: boolean }>(
'hello-world',
{ body: { name: 'Ada' } },
)
if (error) throw error

포함된 내용

코드를 실행하는 데 필요한 모든 것. 서버를 관리하지 않고.

런타임

데노 기능

Deno.serve 및 TypeScript를 사용하여 표준 요청 및 응답 핸들러를 작성합니다.

호출

SDK에서 호출

메소드, 경로, 헤더 및 본문을 사용하여 이름으로 함수를 호출합니다.

라우팅

함수 내부의 하위 경로

하나의 함수는 여러 경로와 메서드를 제공할 수 있습니다.

제어

시간 초과 및 취소

시간 초과를 설정하거나 AbortSignal을 전달합니다. 둘 다 동일한 시간 초과 오류를 보고합니다.

오류

입력된 오류

릴레이 실패로 인해 함수가 반환되었다는 오류를 알려줌으로써 재시도하기 전에 함수가 실행되었는지 알 수 있습니다.

응답

JSON, 텍스트, Blob 또는 ArrayBuffer

응답 본문이 디코딩되는 방법을 선택합니다.

배경

비동기 작업

상태별로 작업을 나열하고 해당 ID를 따릅니다.

일정

크론 작업

페이로드를 사용하여 크론 일정에 따라 함수를 실행합니다.

배포

CLI 또는 Studio에서 배포

Studio에서 또는 HTTP API를 통해 aura CLI를 사용하여 함수를 제공합니다.

작동 원리

핸들러에서 호출까지.

  1. 1

    쓰기

    요청을 읽고 응답을 반환하는 Deno.serve 핸들러를 만듭니다.

  2. 2

    배포

    Aura 기능 배포와 함께 배송하거나 Studio에서 배송하세요.

  3. 3

    호출

    aura.functions.invoke를 사용하여 이름으로 호출하세요.

  4. 4

    일정

    선택적으로 cron 일정에 따라 실행합니다.

REST API

일반 HTTP를 선호하시나요? 모든 것이 여기에 있습니다.

SDK는 이러한 경로에 대한 얇은 계층입니다. 각 요청과 함께 프로젝트의 API 키를 보냅니다.

방법엔드포인트설명
GET/v1/functions프로젝트의 기능을 나열하세요.
GET/v1/functions/{name}하나의 기능에 대한 세부정보를 읽어보세요.
POST/v1/functions/{name}/invoke메소드, 경로, 헤더 및 본문을 사용하여 함수를 실행합니다.
GET/v1/functions/jobs상태별로 필터링된 비동기 작업을 나열합니다.
GET/v1/functions/jobs/{id}직업 하나를 읽어보세요.
GET/v1/functions/cron예약된 작업을 나열합니다.
POST/v1/functions/croncron 표현식을 사용하여 기능을 예약합니다.
DELETE/v1/functions/cron/{name}예약된 작업을 삭제합니다.

질문

알아두면 좋아요.

함수는 어떤 런타임을 사용합니까?+
데노. 귀하의 함수는 TypeScript 또는 JavaScript로 작성된 Deno.serve 핸들러입니다.
함수를 배포하려면 어떻게 해야 하나요?+
CLI를 사용하여 aura 함수를 배포 <name> 실행하거나 Studio 또는 HTTP API를 사용하세요. SDK는 함수를 호출하지만 배포하지는 않습니다.
함수가 응답을 스트리밍할 수 있나요?+
아니요. SDK는 사용자가 선택한 응답 유형에 관계없이 해결되기 전에 전체 응답을 기다립니다.
실패한 통화를 다시 시도해도 안전합니까?+
503 이후에는 함수가 실행되지 않았으므로 다시 시도해도 안전합니다. 504 이후에는 시작되었고 부작용이 있을 수 있으므로 멱등성이 있는 작업만 재시도하세요.
행사를 예약할 수 있나요?+
그렇습니다. 이름, 크론 표현식 및 호출할 함수를 사용하여 크론 작업을 만듭니다. SDK에서 작업을 나열하고 삭제할 수 있습니다.
함수가 실행되는 지역을 선택할 수 있나요?+
지금은 아닙니다. 기능에 대한 지역 선택을 사용할 수 없습니다.

코드를 실행할 준비가 되셨나요?

오늘 첫 번째 기능을 배송해 보세요.

모든 프로젝트에는 기능이 포함되어 있습니다. 신용 카드가 필요하지 않습니다.