본문으로 건너뛰기
아우라베이스 로고
아우라베이스

Edge Functions

TypeScript에 함수를 작성하고, 하나의 명령으로 배포하고, 공개 키를 사용하여 앱에서 호출하세요.

설명4분 읽기레벨 초보자2026. 10. 12.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

하나의 기능, 이를 트리거하는 세 가지 방법#

Edge Function은 Aurabase가 프로젝트를 위해 저장하고 요청 시 실행하는 서버 코드입니다. 세 가지 방법으로 동일한 기능을 트리거합니다.

  • 호출: 앱이 aura.functions.invoke('name')을 호출하거나 HTTP 요청을 보내고 응답을 받습니다.
  • 작업: 지연 및 자동 재시도를 통해 백그라운드에서 실행되도록 호출을 대기열에 추가합니다.
  • 일정: cron 항목은 선택한 시간에 작업을 대기열에 추가합니다.

런타임에는 Deno(기본값TypeScript 또는 JavaScript)와 WASM(컴파일된 Rust 바이너리)의 두 가지 런타임이 있습니다. 각 호출은 메모리 제한과 시간 제한이 있는 자체 격리된 작업자에서 실행됩니다.

기능의 계약#

Deno 함수는 Deno.serve을 호출하는 하나의 파일입니다. 설명된 요청을 수신하고 Response를 반환합니다.

aurabase/functions/hello/index.tstypescript
Deno.serve(async (req) => {
  const { name = 'world' } = await req.json().catch(() => ({}))
  return Response.json({ greeting: `Hello, ${name}!` })
})

export default은 호출되지 않습니다. 함수는 단일 파일입니다. 상대 가져오기는 제공되지 않으므로 npm: 또는 https://esm.sh/ 가져오기를 사용하세요.

필요한 것을 찾아보세요#

나는하고 싶다…읽기
첫 번째 함수 배포 및 호출첫 번째 엣지 기능
기능을 호출하고 누가 전화하는지 확인함수 호출
실패, 시간 초과 및 재시도 처리오류, 시간 초과 및 재시도
텍스트, 이미지 또는 HTML 반환텍스트, 바이너리 및 HTML 반환
함수에 API 키 제공비밀 및 환경 변수
백그라운드에서 또는 일정에 따라 작업 실행작업, cron 및 배달 못한 편지 대기열
문제가 발생하면 경고를 받습니다.경고
로컬에서 테스트하고 CI에서 배포CI에서 테스트 및 배포
명령을 찾아보세요아우라 기능 및 아우라 비밀
경로 찾기HTTP API 참조
SDK 메소드 조회JavaScript SDK: 함수
크기, 기간, 할당량 파악한도 및 할당량
통화 중에 무슨 일이 일어나는지 이해하기호출 작동 방식
누가 무엇을 할 수 있는지 이해하기보안 모델
SDK 0.6으로 이동SDK 0.6으로 업그레이드

먼저 알아야 할 사실#

  • 공개 키를 사용하면 함수 호출만 작동합니다. 다른 모든 것에는 service_role 키가 필요하며 서버에 속합니다.
  • 요청과 응답은 약 256KiB 미만으로 유지되어야 합니다. 더 큰 데이터에는 저장소를 사용하세요.
  • 모든 호출은 상태 비저장입니다. 호출 사이에 데이터를 메모리에 보관하지 마십시오.
  • 비밀은 aura secrets set 또는 PUT /env로 설정된 함수의 변수입니다. 미사용 암호화는 PUT 경로와 배포에 키가 있는 경우에만 적용됩니다.
  • console.log로 작성하는 함수는 아직 사용할 수 없습니다. 현재 격차는 제한을 참조하세요.
  • 지역은 하나이며 버전 기록은 없습니다. 함수를 Git에 유지하세요.