Edge Functions
Escriba una función en TypeScript, impleméntela con un comando y llámela desde su aplicación con la clave pública.
Una función, tres formas de activarla#
Una función perimetral es un fragmento de código de servidor que Aurabase almacena para su proyecto y se ejecuta bajo demanda. Activa la misma función de tres maneras:
- Una llamada: su aplicación llama a
aura.functions.invoke('name')o envía una solicitud HTTP y obtiene la respuesta. - Un trabajo: pones en cola una llamada para que se ejecute en segundo plano, con un retraso y reintentos automáticos.
- Una programación: una entrada cron pone en cola un trabajo en los momentos que usted elija.
Hay dos tiempos de ejecución: Deno (TypeScript o JavaScript, el valor predeterminado) y WASM (un binario compilado Rust). Cada llamada se ejecuta en su propio trabajador aislado con un límite de memoria y un tiempo de espera.
El contrato de una función.#
Una función Deno es un archivo que llama a Deno.serve. Recibe la solicitud que usted describió y devuelve un Response.
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
Nunca se llama a un export default. Una función es un archivo único : las importaciones relativas no se envían, así que use las importaciones npm: o https://esm.sh/.
Encuentra lo que necesitas#
| quiero… | leer |
|---|---|
| Implementar y llamar a mi primera función. | Su primera función Edge |
| Llame a una función y sepa quién llama | Invocar una función |
| Manejar fallas, tiempos de espera y reintentos | Errores, tiempos de espera y reintentos |
| Devolver texto, una imagen o HTML | Devolver texto, binario y HTML |
| Darle a una función una clave API | Secretos y variables de entorno |
| Ejecute el trabajo en segundo plano o según un cronograma | Trabajos, cron y cola de mensajes fallidos |
| Recibe un aviso cuando algo salga mal | Alertas |
| Pruebe localmente e implemente desde CI | Probar e implementar desde CI |
| Buscar un comando | funciones del aura y secretos del aura |
| buscar una ruta | Referencia de API HTTP |
| Buscar un método SDK | SDK de JavaScript: funciones |
| Conoce los tamaños, duraciones y cupos | Límites y cuotas |
| Entender lo que sucede durante una llamada | Cómo funciona una invocación |
| Entender quién puede hacer qué | Modelo de seguridad |
| Pasar al SDK 0.6 | Actualización a SDK 0.6 |
Hechos que debes saber primero#
- Solo que invoca una función funciona con la clave pública. Todo lo demás necesita una clave
service_roley pertenece a su servidor. - Las solicitudes y respuestas deben permanecer por debajo de aproximadamente 256 KiB. Utilice Almacenamiento para datos más grandes.
- Cada llamada es apátrida. No guarde datos en la memoria entre llamadas.
- Los secretos son variables de la función, configuradas con
aura secrets setoPUT /env. El cifrado en reposo se aplica solo en la rutaPUTy solo cuando la implementación tiene una clave. - Lo que escribe una función con
console.logaún no está disponible para usted. Consulte los límites de Limits and quotas para conocer las brechas actuales. - Hay una región y no hay historial de versiones: mantén tus funciones en Git.