Edge Functions
Schreiben Sie eine Funktion in TypeScript, stellen Sie sie mit einem Befehl bereit und rufen Sie sie mit dem öffentlichen Schlüssel aus Ihrer App auf.
Eine Funktion, drei Möglichkeiten, sie auszulösen#
Eine Edge-Funktion ist ein Teil des Servercodes, den Aurabase für Ihr Projekt speichert und bei Bedarf ausführt. Sie lösen dieselbe Funktion auf drei Arten aus:
- Ein Aufruf: Ihre App ruft
aura.functions.invoke('name')auf oder sendet eine HTTP-Anfrage und erhält die Antwort. - Ein Job: Sie stellen einen Anruf in die Warteschlange, um ihn im Hintergrund mit einer Verzögerung und automatischen Wiederholungsversuchen auszuführen.
- Ein Zeitplan: Ein Cron-Eintrag stellt einen Job zu den von Ihnen gewählten Zeiten in die Warteschlange.
Es gibt zwei Laufzeiten: Deno (TypeScript oder JavaScript, die Standardeinstellung) und WASM (eine kompilierte Rust-Binärdatei). Jeder Aufruf wird in einem eigenen isolierten Worker mit einem Speicherlimit und einer Zeitüberschreitung ausgeführt.
Der Vertrag einer Funktion#
Eine Deno-Funktion ist eine Datei, die Deno.serve aufruft. Es empfängt die von Ihnen beschriebene Anfrage und gibt ein Response zurück.
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
Ein export default wird nie aufgerufen. Eine Funktion ist eine -Einzeldatei: Relative Importe werden nicht ausgeliefert, verwenden Sie daher npm:- oder https://esm.sh/-Importe.
Finden Sie, was Sie brauchen#
| Ich möchte… | Lesen |
|---|---|
| Stellen Sie meine erste Funktion bereit und rufen Sie sie auf | Ihre erste Kantenfunktion |
| Rufen Sie eine Funktion auf und wissen Sie, wer anruft | Eine Funktion aufrufen |
| Behandeln Sie Fehler, Zeitüberschreitungen und Wiederholungsversuche | Fehler, Zeitüberschreitungen und Wiederholungsversuche |
| Geben Sie Text, ein Bild oder HTML zurück | Rückgabetext, Binär und HTML |
| Geben Sie einer Funktion einen API-Schlüssel | Geheimnisse und Umgebungsvariablen |
| Führen Sie die Arbeit im Hintergrund oder nach einem Zeitplan aus | Jobs, Cron und die Warteschlange für unzustellbare Nachrichten |
| Seien Sie gewarnt, wenn etwas schief geht | Warnungen |
| Lokal testen und über CI bereitstellen | Testen und Bereitstellen von CI |
| Suchen Sie nach einem Befehl | Aura-Funktionen und Aura-Geheimnisse |
| Suchen Sie nach einer Route | HTTP-API-Referenz |
| Suchen Sie nach einer SDK-Methode | JavaScript SDK: Funktionen |
| Kennen Sie die Größen, Dauer und Kontingente | Limits und Kontingente |
| Verstehen Sie, was während eines Anrufs passiert | So funktioniert ein Aufruf |
| Verstehen Sie, wer was tun kann | Sicherheitsmodell |
| Wechseln Sie zu SDK 0.6 | Upgrade auf SDK 0.6 |
Fakten, die Sie zuerst wissen sollten#
- Nur der Aufruf einer Funktion funktioniert mit dem öffentlichen Schlüssel. Alles andere benötigt einen
service_role-Schlüssel und gehört auf Ihren Server. - Anfragen und Antworten müssen unter etwa 256 KiB bleiben. Verwenden Sie Storage für größere Datenmengen.
- Jeder Anruf ist zustandslos. Behalten Sie keine Daten zwischen Anrufen im Speicher.
- Geheimnisse sind Variablen der Funktion, die mit
aura secrets setoderPUT /envfestgelegt werden. Die Verschlüsselung im Ruhezustand gilt nur für den PfadPUTund nur, wenn die Bereitstellung über einen Schlüssel verfügt. - Was eine Funktion mit
console.logschreibt, steht Ihnen noch nicht zur Verfügung. Die aktuellen Lücken finden Sie unter -Grenzwerte. - Es gibt eine Region und keinen Versionsverlauf: Behalten Sie Ihre Funktionen in Git.