Good for Edge Functions with Supabase

适用于 Supabase 的边缘函数

在 Supabase 仪表板上开始使用 Edge Functions。

在本指南中，我们将介绍如何在 Supabase 仪表板上创建基本边缘功能，并使用 Supabase CLI 访问它。

从仪表板部署

转到您的项目 > 边缘功能 > 部署新功能 > 通过编辑器

这将为您搭建一个新功能。您可以从模板中选择一些预定义的函数用于常见用例。

根据需要修改函数，命名，然后单击Deploy function

您的函数现已启用。导航到函数的详细信息页面，然后单击测试按钮。

您可以通过提供预期的 HTTP 方法、标头、查询参数和请求正文来测试您的功能。您还可以更改传递的授权令牌（例如匿名密钥或用户密钥）。

通过 Supabase CLI访问已部署的函数

CLI 未安装？

查看CLI 文档以了解如何在本地机器上安装 Supabase CLI。

现在您的函数已部署，您可以从本地开发环境访问它。操作方法如下：

1. 将您的项目链接到您的本地环境。
2. 您可以在 Supabase 仪表板的 URL 或项目设置中找到您的项目参考 ID。

• 1
• supabase link --project-ref your-project-ref

1. 列出链接的 Supabase 项目中的所有函数。

• 1
• supabase functions list

1. 访问您想要使用的特定功能。

• 1
• supabase functions download function-name

1. 根据需要对功能代码进行局部编辑。
2. 重新部署之前，在本地运行您的功能。

• 1
• supabase functions serve function-name

1. 当您准备好更改后，重新部署。

• 1
• supabase functions deploy function-name

通过助手部署

您还可以利用 Supabase Assistant 来帮助您编写和部署边缘功能。

转到您的项目 > Edge Functions > 单击助手图标以使用 Supabase Assistant 创建

这将打开一个助手窗口，其中预先填写了生成边缘函数的提示。写下您的边缘函数要求，然后让 Supabase Assistant 完成剩下的工作。

单击“部署”，助手将自动部署您的功能。

此功能需要 OpenAI API 密钥。您可以在 Edge Functions 机密页面中添加密钥，或向 Assistant 寻求帮助。

1. 导航到您的 Edge Functions > Secrets 页面。
2. 寻找添加环境变量的选项。
3. 使用密钥添加新的环境变量OPENAI_API_KEY，并将其值设置为您的实际 OpenAI API 密钥。

设置此环境变量后，您的边缘函数将能够安全地访问 OPENAI_API_KEY，而无需将其硬编码到函数代码中。这是确保敏感信息安全的最佳实践。

设置好变量后，您可以通过仪表板发送请求进行测试。导航到函数的详细信息页面，然后单击测试按钮。然后提供函数所需的请求主体。

从仪表板编辑函数#

注意：目前没有编辑版本控制

仪表板的 Edge Function 编辑器目前不支持版本控制或回滚。我们建议仅将其用于快速测试和原型。当您准备投入生产时，请将 Edge Functions 代码存储在源代码存储库（例如 git）中，并使用其中一个CI 集成进行部署。

1. 在函数页面中，单击要编辑的函数。在函数页面中，单击代码选项卡。

2.这将在仪表板中打开一个代码编辑器，您可以在其中查看已部署函数的代码。

3.根据需要修改代码，然后单击部署更新。这将使用新编辑的函数代码覆盖现有部署。