funções da aura e segredos da aura
Cada comando aura functions e aura secrets, com suas opções, os arquivos que lê e o ambiente que necessita.
1. Configuração
Os comandos que atendem ao seu projeto precisam de três coisas:
| Necessidade | Como |
|---|---|
| Uma sessão | aura login, então aura link --project-id <uuid>, que escreve aurabase.toml |
| O URL do projeto | AURA_PROJECT_URL ou project_url em aurabase.toml |
Uma chave service_role | AURA_API_KEY ou AURA_SERVICE_ROLE_KEY, no ambiente ou em um arquivo .env |
| Variável | Padrão | Função |
|---|---|---|
AURA_GATEWAY_URL | https://api.aurabase.cloud | API de gerenciamento usada por login, orgs e projects. Defina-o explicitamente ao trabalhar em outra pilha: o padrão é a nuvem hospedada. |
AURA_PROJECT_URL | project_url de aurabase.toml | Plano de dados do seu projeto |
AURA_STUDIO_URL | http://localhost:3000 | Estúdio aberto por aura studio |
Sem AURA_GATEWAY_URL, aura login e aura projects create fale com https://api.aurabase.cloud. Exporte o URL da sua própria pilha antes de testá-la.
2. funções da aura
aura functions new <name> [--runtime deno|wasm]
Cria aurabase/functions/<name>/. O tempo de execução padrão é deno ( modelo TypeScript com index.ts e deno.json). Com --runtime wasm ele cria uma caixa Rust (Cargo.toml, src/lib.rs). Recusa um nome existente.
aura functions serve [name] [--port 54321]
Executa index.ts ou index.js com deno run --allow-net --allow-env --allow-read --watch, então a função é reiniciada quando você salva. Ele precisa de Deno instalado; sem ele, o comando explica como instalá-lo. Sem nome, lista funções locais.
O servidor escuta em http://127.0.0.1:<port> e a função recebe a solicitação como faria na produção (método, caminho, cabeçalhos, corpo), sem a plataforma: sem cabeçalhos de identidade x-aura-*, sem segredos, sem limites. PORT e DENO_SERVE_ADDRESS estão configurados para você, então um Deno.serve(handler) simples usa a porta escolhida.
Uma função WASM não pode ser atendida localmente: o comando mostra como implantá-la.
aura functions deploy <name>
Lê index.ts (ou index.js) e envia para o projeto, criando ou substituindo a função. Os segredos existentes são mantidos. Para uma função sem index.ts ou index.js, ela executa cargo build --target wasm32-unknown-unknown --release e envia o binário compilado.
Uma função Deno é um arquivo único : o comando recusa importações relativas (./helper.ts, ../lib.ts). Use importações remotas (npm:<package> ou https://esm.sh/<package>) ou incorpore o código.
aura functions invoke <name> [--data '<json>']
Chama a função implantada e imprime o envelope de resposta. --data é o corpo da solicitação. Um --data que não é JSON válido é um erro: ele não é substituído por {}.
aura functions list [--json]
Lista as funções locais com seu tempo de execução (Deno / TypeScript ou Rust / WASM) e, quando um projeto está vinculado, as implantadas com actif ou inactif.
aura functions logs <name> [--limit 50]
Lista solicitações HTTP recentes para a função: hora, método, caminho, status, duração e ID da solicitação. não mostra a saída do seu código (console.log). Consulte limites.
aura functions download <name>
Grava o código implantado em aurabase/functions/<name>/: index.ts para uma função Deno, <name>.wasm para uma função WASM. A origem Rust de uma função WASM não está armazenada no servidor.
aura functions delete <name> [--force]
Exclui a função implantada após uma confirmação. --force (ou -f) ignora a confirmação, necessária nos scripts.
3. segredos da aura
| Comando | Efeito |
|---|---|
aura secrets list --function <name> [--json] | Lista as chaves; os valores são mascarados (sk_l***) |
aura secrets set --function <name> KEY=VALUE … | Adiciona ou atualiza chaves, mantém as outras |
aura secrets unset --function <name> KEY … | Remove chaves |
--function pode ser escrito -f. Esses comandos armazenam valores conforme fornecidos e não os criptografam: consulte segredos e ambiente para obter o caminho criptografado.