Edge Functions
TypeScript içine bir işlev yazın, onu tek komutla dağıtın ve genel anahtarla uygulamanızdan çağırın.
Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.
Tek işlev, onu tetiklemenin üç yolu#
Edge İşlevi, Aurabase'nin projeniz için sakladığı ve talep üzerine çalıştırdığı bir sunucu kodu parçasıdır. Aynı işlevi üç şekilde tetiklersiniz:
- Bir çağrı: uygulamanız
aura.functions.invoke('name')öğesini arar veya bir HTTP isteği gönderir ve yanıtı alır. - Bir iş: bir aramayı, gecikmeli ve otomatik yeniden denemelerle arka planda çalışacak şekilde sıraya koyarsınız.
- Bir zamanlama: bir cron girişi, bir işi seçtiğiniz zamanlarda kuyruğa alır.
İki çalışma zamanı vardır: Deno (TypeScript veya varsayılan JavaScript) ve WASM (derlenmiş bir Rust ikili dosyası). Her çağrı, bir bellek sınırı ve zaman aşımı süresiyle kendi yalıtılmış çalışanında çalışır.
Bir fonksiyonun sözleşmesi#
Deno işlevi, Deno.serve öğesini çağıran bir dosyadır. Tanımladığınız isteği alır ve bir Response döndürür.
typescript
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
Bir export default asla çağrılmaz. Bir işlev tek bir dosyadır: göreli içe aktarmalar gönderilmez, bu nedenle npm: veya https://esm.sh/ içe aktarmaları kullanın.
İhtiyacınız olanı bulun#
| istiyorum… | Oku |
|---|---|
| İlk işlevimi dağıt ve çağır | İlk Kenar İşleviniz |
| Bir işlevi çağırın ve kimin aradığını bilin | Bir işlevi çağırma |
| Hataları, zaman aşımlarını ve yeniden denemeleri yönetin | Hatalar, zaman aşımları ve yeniden denemeler |
| Metin, resim veya HTML döndür | Metin, ikili ve HTML döndürür |
| Bir işleve API anahtarı verme | Gizli diziler ve ortam değişkenleri |
| Çalışmayı arka planda veya bir programa göre çalıştırın | İşler, cron ve atılacak ileti kuyruğu |
| Bir şeyler ters gittiğinde uyarılırsınız | Uyarılar |
| Yerel olarak test edin ve CI'dan dağıtın | CI'dan test edin ve dağıtın |
| Bir komutu arayın | aura işlevleri ve aura sırları |
| Bir rota arayın | HTTP API referansı |
| Bir SDK yöntemi arayın | JavaScript SDK'sı: işlevler |
| Boyutları, süreleri ve kotaları öğrenin | Sınırlar ve kotalar |
| Görüşme sırasında neler olduğunu anlayın | Çağırma nasıl çalışır |
| Kimin ne yapabileceğini anlayın | Güvenlik modeli |
| SDK 0.6'ya geçin | SDK 0.6'ya yükseltin |
İlk önce bilmeniz gereken gerçekler#
- Yalnızca bir işlevi çağıran ortak anahtarla çalışır. Diğer her şeyin bir
service_roleanahtarına ihtiyacı vardır ve sunucunuza aittir. - İstekler ve yanıtlar yaklaşık 256 KiB değerinin altında kalmalıdır. Daha büyük veriler için Depolamayı kullanın.
- Her çağrı vatansızdır. Aramalar arasında hafızada veri tutmayın.
- Sırlar, işlevin
aura secrets setveyaPUT /envile ayarlanan değişkenleridir. Beklemedeki şifreleme yalnızcaPUTyolunda ve yalnızca dağıtımın bir anahtarı olduğunda geçerlidir. - Bir fonksiyonun
console.logile ne yazdığı henüz sizin için mevcut değil. Mevcut boşluklar için sınırlarına bakın. - Tek bir bölge var ve sürüm geçmişi yok: İşlevlerinizi Git'te tutun.