Edge Functions
Napisz funkcję w TypeScript, wdróż ją jednym poleceniem i wywołaj ją z aplikacji za pomocą klucza publicznego.
Jedna funkcja, trzy sposoby jej uruchomienia#
Funkcja brzegowa to fragment kodu serwera, który Aurabase przechowuje dla Twojego projektu i uruchamia na żądanie. Tę samą funkcję uruchamiasz na trzy sposoby:
- Wywołanie: Twoja aplikacja wywołuje
aura.functions.invoke('name')lub wysyła żądanie HTTP i otrzymuje odpowiedź. - Zadanie: kolejkujesz wywołanie, aby działało w tle, z opóźnieniem i automatycznymi ponawianiami.
- Harmonogram: wpis cron kolejkuje zadanie w wybranym przez Ciebie momencie.
Istnieją dwa środowiska wykonawcze: Deno (domyślnie TypeScript lub JavaScript) i WASM (skompilowany plik binarny Rust). Każde wywołanie działa we własnym izolowanym procesie roboczym z limitem pamięci i limitem czasu.
Umowa funkcji#
Funkcja Deno to jeden plik wywołujący Deno.serve. Otrzymuje opisane żądanie i zwraca Response.
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
export default nigdy nie jest wywoływany. Funkcja jest pojedynczym plikiem : import względny nie jest dostarczany, dlatego należy używać importu npm: lub https://esm.sh/.
Znajdź to, czego potrzebujesz#
| Chcę… | Czytać |
|---|---|
| Wdróż i wywołaj moją pierwszą funkcję | Twoja pierwsza funkcja krawędziowa |
| Wywołaj funkcję i dowiedz się, kto dzwoni | Wywołaj funkcję |
| Obsługa błędów, przekroczeń limitu czasu i ponownych prób | Błędy, przekroczenia limitu czasu i ponowne próby |
| Zwróć tekst, obraz lub kod HTML | Zwraca tekst, binarnie i HTML |
| Nadaj funkcji klucz API | Sekrety i zmienne środowiskowe |
| Uruchamiaj pracę w tle lub zgodnie z harmonogramem | Zadania, cron i kolejka niedostarczonych wiadomości |
| Ostrzegaj, gdy coś pójdzie nie tak | Alerty |
| Testuj lokalnie i wdrażaj z poziomu CI | Testuj i wdrażaj z poziomu CI |
| Wyszukaj polecenie | funkcje aury i sekrety aury |
| Wyszukaj trasę | Dokumentacja API HTTP |
| Wyszukaj metodę SDK | JavaScript SDK: funkcje |
| Poznaj rozmiary, czas trwania i limity | Limity i kwoty |
| Zrozum, co dzieje się podczas rozmowy | Jak działa wywołanie |
| Zrozum, kto może co zrobić | Model zabezpieczeń |
| Przejdź do SDK 0.6 | Aktualizacja do SDK 0.6 |
Najpierw warto poznać fakty#
- Tylko wywołując funkcję działa z kluczem publicznym. Wszystko inne wymaga klucza
service_rolei należy do Twojego serwera. - Żądania i odpowiedzi muszą znajdować się poniżej około 256 KiB. Użyj magazynu, aby przechowywać większe dane.
- Każde połączenie jest bezstanowe. Nie przechowuj danych w pamięci pomiędzy połączeniami.
- Sekrety to zmienne funkcji, ustawiane za pomocą
aura secrets setlubPUT /env. Szyfrowanie w spoczynku ma zastosowanie tylko na ścieżcePUTi tylko wtedy, gdy wdrożenie ma klucz. - To, co funkcja zapisuje za pomocą
console.log, nie jest jeszcze dostępne. Zobacz limity Limits and quotas, aby zapoznać się z bieżącymi przerwami. - Jest jeden region i nie ma historii wersji: zachowaj swoje funkcje w Git.