Edge Functions
Schrijf een functie in TypeScript, implementeer deze met één opdracht en roep deze vanuit uw app aan met de openbare sleutel.
Eén functie, drie manieren om het te activeren#
Een Edge-functie is een stukje servercode dat Aurabase voor uw project opslaat en op aanvraag draait. U activeert dezelfde functie op drie manieren:
- Een oproep: uw app roept
aura.functions.invoke('name')aan of verzendt een HTTP-verzoek en krijgt het antwoord. - Een taak: u zet een oproep in de wachtrij zodat deze op de achtergrond wordt uitgevoerd, met een vertraging en automatische nieuwe pogingen.
- Een schema: een cron-invoer plaatst een taak in de wachtrij op de door u gekozen tijdstippen.
Er zijn twee runtimes: Deno (TypeScript of JavaScript, de standaard) en WASM (een gecompileerd binair bestand Rust). Elke oproep wordt uitgevoerd in een eigen geïsoleerde werker met een geheugenlimiet en een time-out.
Het contract van een functie#
Een Deno-functie is één bestand dat Deno.serve aanroept. Het ontvangt het door u beschreven verzoek en retourneert een Response.
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
Een export default wordt nooit aangeroepen. Een functie is een enkel bestand: relatieve imports worden niet verzonden, dus gebruik npm: of https://esm.sh/ imports.
Vind wat je nodig hebt#
| ik wil… | Lees |
|---|---|
| Implementeer en roep mijn eerste functie aan | Uw eerste Edge-functie |
| Bel een functie en weet wie er belt | Roep een functie op |
| Afhandelen van fouten, time-outs en nieuwe pogingen | Fouten, time-outs en nieuwe pogingen |
| Retourneer tekst, een afbeelding of HTML | Retourtekst, binair en HTML |
| Geef een functie een API-sleutel | Geheimen en omgevingsvariabelen |
| Voer werk uit op de achtergrond of volgens een schema | Taken, cron en de wachtrij voor onbestelbare brieven |
| Wees gewaarschuwd als er iets misgaat | Waarschuwingen |
| Lokaal testen en implementeren vanuit CI | Testen en implementeren vanaf CI |
| Zoek een opdracht op | aurafuncties en aurageheimen |
| Zoek een route op | HTTP API-referentie |
| Zoek een SDK-methode op | JavaScript SDK: functies |
| Ken de maten, duur en quota | Limieten en quota |
| Begrijp wat er gebeurt tijdens een gesprek | Hoe een aanroep werkt |
| Begrijp wie wat kan doen | Beveiligingsmodel |
| Ga naar SDK 0.6 | Upgrade naar SDK 0.6 |
Feiten die u eerst moet weten#
- Alleen die een functie aanroept, werkt met de publieke sleutel. Al het andere heeft een
service_role-sleutel nodig en hoort op uw server. - Verzoeken en antwoorden moeten onder ongeveer 256 KiB blijven. Gebruik opslag voor grotere gegevens.
- Elke oproep is staatloos. Bewaar geen gegevens in het geheugen tussen gesprekken.
- Geheimen zijn variabelen van de functie, ingesteld met
aura secrets setofPUT /env. Versleuteling in rust is alleen van toepassing op het padPUTen alleen wanneer de implementatie een sleutel heeft. - Wat een functie schrijft met
console.logis nog niet voor u beschikbaar. Zie limieten voor de huidige gaten. - Er is één regio en geen versiegeschiedenis: bewaar uw functies in Git.