光环标志
光环基地文档
文档›Edge Functions›CLI: aura functions

光环功能和光环秘密

每个 aura functions 和 aura secrets 命令及其选项、它读取的文件以及它所需的环境。

6分钟 读取·级别 参考·修改于 2026年10月12日
该英文文本是根据法文原文自动生成的,尚未经过审查。
该页面已自动翻译。英文版具有权威性。
#
设置

1. 设置

与您的项目交互的命令需要三件事:

需要如何
一次会议aura login,然后 aura link --project-id <uuid>,写入 aurabase.toml
项目网址AURA_PROJECT_URL或 aurabase.toml 中的 project_url
service_role 键AURA_API_KEY 或 AURA_SERVICE_ROLE_KEY,在环境中或在 .env 文件中
变量默认角色
AURA_GATEWAY_URLhttps://api.aurabase.cloudlogin、 orgs 和 projects使用的管理 API。 当您使用另一个堆栈时显式设置它:默认是托管云。
AURA_PROJECT_URLaurabase.toml 的 project_url您项目的数据平面
AURA_STUDIO_URLhttp://localhost:3000工作室由 aura studio 开设
默认目标是托管云

如果没有 AURA_GATEWAY_URL, aura login 和 aura projects create 会与 https://api.aurabase.cloud对话。在测试之前导出您自己的堆栈的 URL。

#
命令

2. 光环功能

aura functions new <name> [--runtime deno|wasm]

创建 aurabase/functions/<name>/。默认运行时为 deno (带有 index.ts 和 deno.json的TypeScript 模板)。使用 --runtime wasm 创建一个 Rust 箱子(Cargo.toml, src/lib.rs)。它拒绝现有的名称。

aura functions serve [name] [--port 54321]

使用 deno run --allow-net --allow-env --allow-read --watch运行 index.ts 或 index.js ,因此该函数会在您保存时重新启动。需要安装Deno;如果没有它,该命令将解释如何安装它。它没有名称,但列出了本地函数。

服务器侦听 http://127.0.0.1:<port> 并且该函数接收请求,就像在生产中一样(方法、路径、标头、主体),没有 平台:没有 x-aura-* 身份标头,没有秘密,没有限制。 PORT 和 DENO_SERVE_ADDRESS 已为您设置,因此普通 Deno.serve(handler) 使用所选端口。

terminalbash
aura functions serve hello --port 54321
curl -X POST http://127.0.0.1:54321/ -d '{"name":"Ada"}'

WASM 函数无法在本地提供:该命令会打印如何部署它。

aura functions deploy <name>

读取 index.ts (或 index.js)并将其发送到项目,创建或替换函数。现有的秘密被保留。对于没有 index.ts 或 index.js的函数,它运行 cargo build --target wasm32-unknown-unknown --release 并发送编译后的二进制文件。

Deno 函数是 单文件:该命令拒绝相对导入(./helper.ts、 ../lib.ts)。使用远程导入(npm:<package> 或 https://esm.sh/<package>)或内联代码。

aura functions invoke <name> [--data '<json>']

调用已部署的函数并打印响应信封。 --data 是请求正文。不是有效 JSON 的 --data 是一个错误:它不会被 {}替换。

terminalbash
aura functions invoke hello --data '{"name":"Ada"}'

aura functions list [--json]

列出本地函数及其运行时(Deno / TypeScript 或 Rust / WASM),并在链接项目时列出已部署的函数 actif 或 inactif。

aura functions logs <name> [--limit 50]

列出该函数最近的 HTTP 请求:时间、方法、路径、状态、持续时间和请求 ID。它确实 而不是 显示代码的输出(console.log)。请参阅 限制。

aura functions download <name>

将部署的代码写入 aurabase/functions/<name>/:对于 Deno 函数,将其写入 index.ts;对于 WASM 函数,将其写入 <name>.wasm。 WASM 函数的 Rust 源未存储在服务器上。

aura functions delete <name> [--force]

确认后删除已部署的功能。 --force (或 -f)会跳过脚本中需要的确认。

#
秘密

3.气场秘密

命令效果
aura secrets list --function <name> [--json]列出键;值被屏蔽 (sk_l***)
aura secrets set --function <name> KEY=VALUE …添加或更新密钥,保留其他密钥
aura secrets unset --function <name> KEY …移除钥匙

--function 可以写成 -f。这些命令存储给定的值,并且不对其进行加密:请参阅 秘密和环境 了解加密路径。

#
文件

4. 文件夹布局

projecttext
aurabase.toml                      # project_id和project_url,由aura link编写
.env                               # AURA_PROJECT_URL、AURA_API_KEY(请勿提交)
aurabase/
  functions/
    hello/
      index.ts                     # 整个功能
      deno.json
最后更新· 2026年10月12日