NOWYPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Zobacz dziennik zmian →

Edge Functions

Kod serwera obok Twoich danych.

Napisz funkcje Deno, wywołaj je z SDK z wpisanymi błędami i przekroczeniami limitu czasu, a następnie uruchamiaj je na żądanie, w tle lub zgodnie z harmonogramem.

Deno
czas wykonania
3
sposoby uruchamiania: na żądanie, praca, cron
functions.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
const { data, error } = await aura.functions.invoke<{ ok: boolean }>(
'hello-world',
{ body: { name: 'Ada' } },
)
if (error) throw error

Co jest wliczone w cenę

Wszystko, aby uruchomić Twój kod. Bez zarządzania serwerami.

Czas wykonania

Funkcje Deno

Napisz standardowe procedury obsługi żądań i odpowiedzi za pomocą Deno.serve i TypeScript.

Wezwanie

Wywołaj z SDK

Wywołaj funkcję według nazwy, podając metodę, ścieżkę, nagłówki i treść.

Rozgromienie

Podtrasy wewnątrz funkcji

Jedna funkcja może obsługiwać kilka ścieżek i metod.

Kontrola

Limity czasu i anulowanie

Ustaw limit czasu lub przekaż AbortSignal. Obydwa zgłaszają ten sam błąd przekroczenia limitu czasu.

Błędy

Wpisane błędy

Poinformuj o błędzie, że funkcja zwróciła się po awarii przekaźnika, abyś wiedział, czy została uruchomiona, zanim spróbujesz ponownie.

Odpowiedzi

JSON, tekst, Blob lub ArrayBuffer

Wybierz sposób dekodowania treści odpowiedzi.

Tło

Zadania asynchroniczne

Wyświetlaj zadania według statusu i śledź je według jego identyfikatora.

Harmonogramy

Praca Crona

Uruchom funkcję zgodnie z harmonogramem cron z ładunkiem.

Wdrożyć

Wdróż z interfejsu CLI lub Studio

Wyślij funkcję za pomocą interfejsu CLI aura, ze Studio lub poprzez interfejs API HTTP.

Jak to działa

Od obsługi do połączenia.

  1. 1

    Pisać

    Utwórz procedurę obsługi Deno.serve, która odczytuje żądanie i zwraca odpowiedź.

  2. 2

    Wdrożyć

    Wyślij go wraz z wdrożeniem funkcji aury lub z Studio.

  3. 3

    Odwołać się

    Nazwij to po nazwie za pomocą aura.functions.invoke.

  4. 4

    Harmonogram

    Opcjonalnie uruchom go zgodnie z harmonogramem cron.

API REST

Wolisz zwykły HTTP? To wszystko jest tutaj.

Zestaw SDK to cienka warstwa na tych trasach. Przy każdym żądaniu wysyłaj klucz API swojego projektu.

MetodaPunkt końcowyOpis
GET/v1/functionsWymień funkcje projektu.
GET/v1/functions/{name}Przeczytaj szczegóły jednej funkcji.
POST/v1/functions/{name}/invokeUruchom funkcję z metodą, ścieżką, nagłówkami i treścią.
GET/v1/functions/jobsWyświetl listę zadań asynchronicznych, filtrowanych według stanu.
GET/v1/functions/jobs/{id}Przeczytaj jedną pracę.
GET/v1/functions/cronLista zaplanowanych zadań.
POST/v1/functions/cronZaplanuj funkcję z wyrażeniem cron.
DELETE/v1/functions/cron/{name}Usuń zaplanowane zadanie.

Pytania

Dobrze wiedzieć.

Z jakiego środowiska wykonawczego korzystają funkcje?+
Deno. Twoja funkcja to moduł obsługi Deno.serve napisany w TypeScript lub JavaScript.
Jak wdrożyć funkcję?+
Uruchom funkcje aury i wdróż <nazwa> za pomocą interfejsu CLI lub użyj Studio lub interfejsu API HTTP. Zestaw SDK wywołuje funkcje, ale ich nie wdraża.
Czy funkcja może przesyłać strumieniowo swoją odpowiedź?+
Nie. Zestaw SDK czeka na całą odpowiedź przed jej rozwiązaniem, niezależnie od wybranego typu odpowiedzi.
Czy ponowienie nieudanego połączenia jest bezpieczne?+
Po błędzie 503 funkcja nie została uruchomiona, więc ponowna próba jest bezpieczna. Po błędzie 504 faktycznie się uruchomiło i mogło mieć skutki uboczne, więc ponawiaj tylko operacje idempotentne.
Czy mogę zaplanować funkcję?+
Tak. Utwórz zadanie cron z nazwą, wyrażeniem cron i funkcją do wywołania. Możesz wyświetlać i usuwać zadania z zestawu SDK.
Czy mogę wybrać region, w którym działa funkcja?+
Nie w tej chwili. Wybór regionu dla funkcji nie jest dostępny.

Gotowy do uruchomienia kodu?

Wyślij swoją pierwszą funkcję już dziś.

Funkcje są zawarte w każdym projekcie. Nie jest wymagana karta kredytowa.