Funciones del aura y secretos del aura.
Cada comando aura functions y aura secrets, con sus opciones, los archivos que lee y el entorno que necesita.
1. Configuración
Los comandos que se comunican con su proyecto necesitan tres cosas:
| necesidad | como |
|---|---|
| una sesión | aura login, luego aura link --project-id <uuid>, que escribe aurabase.toml |
| La URL del proyecto | AURA_PROJECT_URL o project_url en aurabase.toml |
Una clave service_role | AURA_API_KEY o AURA_SERVICE_ROLE_KEY, en el entorno o en un archivo .env |
| variable | Predeterminado | Rol |
|---|---|---|
AURA_GATEWAY_URL | https://api.aurabase.cloud | API de administración utilizada por login, orgs y projects. Configúrelo explícitamente cuando trabaje con otra pila: el valor predeterminado es la nube alojada. |
AURA_PROJECT_URL | project_url de aurabase.toml | Plano de datos de tu proyecto |
AURA_STUDIO_URL | http://localhost:3000 | Estudio abierto por aura studio |
Sin AURA_GATEWAY_URL, aura login y aura projects create hablan con https://api.aurabase.cloud. Exporte la URL de su propia pila antes de realizar la prueba.
2. funciones del aura
aura functions new <name> [--runtime deno|wasm]
Crea aurabase/functions/<name>/. El tiempo de ejecución predeterminado es deno (plantilla TypeScript con index.ts y deno.json). Con --runtime wasm crea una caja Rust (Cargo.toml, src/lib.rs). Rechaza un nombre existente.
aura functions serve [name] [--port 54321]
Ejecuta index.ts o index.js con deno run --allow-net --allow-env --allow-read --watch, por lo que la función se reinicia cuando guarda. Necesita Deno instalado; sin él, el comando explica cómo instalarlo. Sin nombre, enumera funciones locales.
El servidor escucha en http://127.0.0.1:<port> y la función recibe la solicitud como lo haría en producción (método, ruta, encabezados, cuerpo), sin la plataforma: sin encabezados de identidad x-aura-*, sin secretos, sin límites. PORT y DENO_SERVE_ADDRESS están configurados para usted, por lo que un Deno.serve(handler) simple usa el puerto elegido.
Una función WASM no se puede servir localmente: el comando imprime cómo implementarla.
aura functions deploy <name>
Lee index.ts (o index.js) y lo envía al proyecto, creando o reemplazando la función. Se guardan los secretos existentes. Para una función sin index.ts o index.js, ejecuta cargo build --target wasm32-unknown-unknown --release y envía el binario compilado.
Una función Deno es un archivo único : el comando rechaza importaciones relativas (./helper.ts, ../lib.ts). Utilice importaciones remotas (npm:<package> o https://esm.sh/<package>) o inserte el código.
aura functions invoke <name> [--data '<json>']
Llama a la función implementada e imprime el sobre de respuesta. --data es el cuerpo de la solicitud. Un --data que no es JSON válido es un error: no se reemplaza por {}.
aura functions list [--json]
Enumera las funciones locales con su tiempo de ejecución (Deno / TypeScript o Rust / WASM) y, cuando un proyecto está vinculado, las implementadas con actif o inactif.
aura functions logs <name> [--limit 50]
Enumera las solicitudes HTTP recientes para la función: hora, método, ruta, estado, duración e identificación de la solicitud. no muestra el resultado de su código (console.log). Consulte los límites de .
aura functions download <name>
Escribe el código implementado en aurabase/functions/<name>/: index.ts para una función Deno, <name>.wasm para una WASM. La fuente Rust de una función WASM no se almacena en el servidor.
aura functions delete <name> [--force]
Elimina la función implementada después de una confirmación. --force (o -f) omite la confirmación, que necesita en los scripts.
3. secretos del aura
| Comando | Efecto |
|---|---|
aura secrets list --function <name> [--json] | Enumera las claves; los valores están enmascarados (sk_l***) |
aura secrets set --function <name> KEY=VALUE … | Agrega o actualiza claves, mantiene las demás. |
aura secrets unset --function <name> KEY … | Elimina llaves |
--function se puede escribir -f. Estos comandos almacenan valores tal como se indican y no los cifran: consulte secretos y entorno para conocer la ruta cifrada.