aurafuncties en aurageheimen
Elke aura functions- en aura secrets-opdracht, met zijn opties, de bestanden die hij leest en de omgeving die hij nodig heeft.
1. Installatie
Commando's die met uw project praten, hebben drie dingen nodig:
| Behoefte | Hoe |
|---|---|
| Een sessie | aura login en vervolgens aura link --project-id <uuid>, wat aurabase.toml schrijft |
| De project-URL | AURA_PROJECT_URL, of project_url in aurabase.toml |
Een service_role-sleutel | AURA_API_KEY of AURA_SERVICE_ROLE_KEY, in de omgeving of in een .env bestand |
| Variabel | Standaard | Rol |
|---|---|---|
AURA_GATEWAY_URL | https://api.aurabase.cloud | Beheer-API gebruikt door login, orgs en projects. Stel dit expliciet in als u tegen een andere stapel werkt.: de standaardwaarde is de gehoste cloud. |
AURA_PROJECT_URL | project_url van aurabase.toml | Gegevensvlak van uw project |
AURA_STUDIO_URL | http://localhost:3000 | Studio geopend door aura studio |
Zonder AURA_GATEWAY_URL praten aura login en aura projects create met https://api.aurabase.cloud. Exporteer de URL van uw eigen stapel voordat u deze test.
2. aurafuncties
aura functions new <name> [--runtime deno|wasm]
Creëert aurabase/functions/<name>/. De standaardruntime is deno (TypeScript-sjabloon met index.ts en deno.json). Met --runtime wasm wordt een krat Rust gemaakt (Cargo.toml, src/lib.rs). Het weigert een bestaande naam.
aura functions serve [name] [--port 54321]
Voert index.ts of index.js uit met deno run --allow-net --allow-env --allow-read --watch, dus de functie start opnieuw wanneer u opslaat. Er moet Deno geïnstalleerd zijn; zonder dit legt de opdracht uit hoe u het moet installeren. Zonder naam worden lokale functies vermeld.
De server luistert naar http://127.0.0.1:<port> en de functie ontvangt het verzoek zoals het dat in productie zou doen (methode, pad, headers, body), zonder het platform: geen x-aura-* identiteitsheaders, geen geheimen, geen limieten. PORT en DENO_SERVE_ADDRESS zijn voor u ingesteld, dus een gewone Deno.serve(handler) gebruikt de gekozen poort.
Een WASM-functie kan niet lokaal worden bediend: de opdracht geeft weer hoe deze moet worden geïmplementeerd.
aura functions deploy <name>
Leest index.ts (of index.js) en verzendt het naar het project, waardoor de functie wordt gemaakt of vervangen. Bestaande geheimen blijven bewaard. Voor een functie zonder index.ts of index.js wordt cargo build --target wasm32-unknown-unknown --release uitgevoerd en wordt het gecompileerde binaire bestand verzonden.
Een Deno-functie is een enkel bestand: de opdracht weigert relatieve import (./helper.ts, ../lib.ts). Gebruik import op afstand (npm:<package> of https://esm.sh/<package>) of inline de code.
aura functions invoke <name> [--data '<json>']
Roept de geïmplementeerde functie aan en drukt de antwoordenvelop af. --data is de hoofdtekst van het verzoek. Een --data die geen geldige JSON is, is een fout: deze wordt niet vervangen door {}.
aura functions list [--json]
Geeft lokale functies weer met hun runtime (Deno / TypeScript of Rust / WASM) en, wanneer een project is gekoppeld, de geïmplementeerde functies met actif of inactif.
aura functions logs <name> [--limit 50]
Geeft een overzicht van recente HTTP-verzoeken voor de functie: tijd, methode, pad, status, duur en verzoek-ID. Het toont en niet de uitvoer van uw code (console.log). Zie limieten.
aura functions download <name>
Schrijft de geïmplementeerde code naar aurabase/functions/<name>/: index.ts voor een Deno functie, <name>.wasm voor een WASM functie. De Rust-bron van een WASM-functie wordt niet op de server opgeslagen.
aura functions delete <name> [--force]
Verwijdert de geïmplementeerde functie na een bevestiging. --force (of -f) slaat de bevestiging over, die u nodig heeft in scripts.
3. aurageheimen
| Commando | Effect |
|---|---|
aura secrets list --function <name> [--json] | Geeft een overzicht van de sleutels; waarden zijn gemaskeerd (sk_l***) |
aura secrets set --function <name> KEY=VALUE … | Voegt sleutels toe of werkt deze bij, behoudt de andere |
aura secrets unset --function <name> KEY … | Verwijdert sleutels |
--function kan worden geschreven als -f. Deze opdrachten slaan waarden op zoals opgegeven en coderen ze niet: zie geheimen en omgeving voor het gecodeerde pad.