Edge Functions
TypeScript에 함수를 작성하고, 하나의 명령으로 배포하고, 공개 키를 사용하여 앱에서 호출하세요.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
하나의 기능, 이를 트리거하는 세 가지 방법#
Edge Function은 Aurabase가 프로젝트를 위해 저장하고 요청 시 실행하는 서버 코드입니다. 세 가지 방법으로 동일한 기능을 트리거합니다.
- 호출: 앱이
aura.functions.invoke('name')을 호출하거나 HTTP 요청을 보내고 응답을 받습니다. - 작업: 지연 및 자동 재시도를 통해 백그라운드에서 실행되도록 호출을 대기열에 추가합니다.
- 일정: cron 항목은 선택한 시간에 작업을 대기열에 추가합니다.
런타임에는 Deno(기본값TypeScript 또는 JavaScript)와 WASM(컴파일된 Rust 바이너리)의 두 가지 런타임이 있습니다. 각 호출은 메모리 제한과 시간 제한이 있는 자체 격리된 작업자에서 실행됩니다.
기능의 계약#
Deno 함수는 Deno.serve을 호출하는 하나의 파일입니다. 설명된 요청을 수신하고 Response를 반환합니다.
typescript
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에 유지하세요.