Edge Functions
在 TypeScript中编写一个函数,使用一个命令部署它,然后使用公钥从您的应用程序调用它。
该页面已自动翻译。英文版具有权威性。
一种功能,三种触发方式#
边缘函数是 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密钥并且属于您的服务器。 - 请求和响应必须保持在约 256 KiB 以下。使用存储来存储更大的数据。
- 每个调用都是无状态的。不要在调用之间将数据保留在内存中。
- 秘密是函数的变量,使用
aura secrets set或PUT /env设置。静态加密仅适用于PUT路径,并且仅当部署具有密钥时才适用。 - 您尚无法使用
console.log函数写入的内容。有关当前差距,请参阅 限制。 - 只有一个区域,没有版本历史记录:将您的函数保留在 Git 中。