Edge Functions
Scrivi una funzione in TypeScript, distribuiscila con un comando e chiamala dalla tua app con la chiave pubblica.
Una funzione, tre modi per attivarla#
Una funzione Edge è una parte di codice server che Aurabase archivia per il tuo progetto ed viene eseguita su richiesta. Puoi attivare la stessa funzione in tre modi:
- Una chiamata: la tua app chiama
aura.functions.invoke('name')o invia una richiesta HTTP e ottiene la risposta. - Un lavoro: accoda una chiamata da eseguire in background, con un ritardo e tentativi automatici.
- Una pianificazione: una voce cron accoda un lavoro negli orari che scegli.
Sono disponibili due runtime: Deno (TypeScript o JavaScript, il valore predefinito) e WASM (un file binario compilato Rust). Ogni chiamata viene eseguita nel proprio lavoratore isolato con un limite di memoria e un timeout.
Il contratto di una funzione#
Una funzione Deno è un file che chiama Deno.serve. Riceve la richiesta che hai descritto e restituisce un Response.
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
Un export default non viene mai chiamato. Una funzione è un file singolo : le importazioni relative non vengono spedite, quindi utilizzare le importazioni npm: o https://esm.sh/.
Trova ciò di cui hai bisogno#
| voglio… | Leggi |
|---|---|
| Distribuisci e chiama la mia prima funzione | La tua prima Edge Function |
| Chiama una funzione e scopri chi sta chiamando | Invoca una funzione |
| Gestire errori, timeout e tentativi | Errori, timeout e tentativi |
| Restituisce testo, un'immagine o HTML | Restituisce testo, binario e HTML |
| Assegna a una funzione una chiave API | Segreti e variabili di ambiente |
| Esegui il lavoro in background o secondo una pianificazione | Job, cron e coda dei messaggi non recapitati |
| Ricevi un avviso quando qualcosa va storto | Avvisi |
| Testare localmente e distribuire da CI | Testa e distribuisci da CI |
| Cerca un comando | funzioni e segreti dell'aura |
| Cerca un percorso | Riferimento API HTTP |
| Cerca un metodo SDK | SDK JavaScript: funzioni |
| Conoscere le dimensioni, le durate e le quote | Limiti e quote |
| Comprendi cosa succede durante una chiamata | Come funziona un'invocazione |
| Capire chi può fare cosa | Modello di sicurezza |
| Passa all'SDK 0.6 | Aggiorna all'SDK 0.6 |
Fatti da sapere prima#
- Solo invocando una funzione funziona con la chiave pubblica. Tutto il resto necessita di una chiave
service_rolee appartiene al tuo server. - Le richieste e le risposte devono rimanere al di sotto di circa 256 KiB. Utilizza Spazio di archiviazione per dati più grandi.
- Ogni chiamata è apolide. Non conservare i dati in memoria tra una chiamata e l'altra.
- I segreti sono variabili della funzione, impostate con
aura secrets setoPUT /env. La crittografia dei dati inattivi si applica solo al percorsoPUTe solo quando la distribuzione dispone di una chiave. - Ciò che scrive una funzione con
console.lognon è ancora disponibile per te. Vedi limiti per gli attuali gap. - C'è una regione e nessuna cronologia delle versioni: mantieni le tue funzioni in Git.