Edge Functions
TypeScriptで関数を作成し、1 つのコマンドでデプロイし、公開キーを使用してアプリから呼び出します。
このページは自動翻訳されました。英語版が正式です。
1 つの機能で 3 つのトリガー方法#
エッジ関数は、Aurabase がプロジェクト用に保存し、オンデマンドで実行するサーバー コードの一部です。同じ関数を次の 3 つの方法でトリガーします。
- 呼び出し: アプリは
aura.functions.invoke('name')を呼び出すか、HTTP リクエストを送信して、応答を取得します。 - ジョブ: 呼び出しをキューに入れて、遅延と自動再試行を伴ってバックグラウンドで実行します。
- スケジュール: cron エントリは、選択した時間にジョブをキューに入れます。
ランタイムには、Deno (TypeScript または JavaScript、デフォルト) と WASM (コンパイルされた Rust バイナリ) の 2 つがあります。各呼び出しは、メモリ制限とタイムアウトを備えた独自の分離されたワーカーで実行されます。
関数のコントラクト#
Deno 関数は、 Deno.serveを呼び出す 1 つのファイルです。記述されたリクエストを受信し、 Responseを返します。
typescript
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
export default は呼び出されません。関数は 単一ファイル: 相対インポートは出荷されないため、npm: または https://esm.sh/ インポートを使用します。
必要なものを見つける#
| したいです… | 読む |
|---|---|
| 最初の関数をデプロイして呼び出します | 最初の Edge 関数 |
| 関数を呼び出して誰が呼び出しているかを知る | 関数の呼び出し |
| 失敗、タイムアウト、再試行を処理する | エラー、タイムアウト、および再試行 |
| テキスト、画像、または HTML を返します | テキスト、バイナリ、および HTML を返します |
| 関数に API キーを与える | シークレットと環境変数 |
| バックグラウンドまたはスケジュールに従って作業を実行する | ジョブ、cron、配信不能キュー |
| 何か問題が発生した場合は注意してください | アラート |
| ローカルでテストし、CI からデプロイする | CI からのテストとデプロイ |
| コマンドを調べる | aura 関数と aura シークレット |
| ルートを調べる | HTTP API リファレンス |
| SDKメソッドを調べる | JavaScript SDK: 関数 |
| サイズ、期間、割り当てを把握する | 制限とクォータ |
| 通話中に何が起こっているかを理解する | 呼び出しの仕組み |
| 誰が何をできるのかを理解する | セキュリティ モデル |
| SDK 0.6 への移行 | SDK 0.6 へのアップグレード |
最初に知っておくべき事実#
- 公開キーを使用して機能するのは関数の呼び出しのみです。それ以外はすべて
service_roleキーが必要であり、サーバー上に属します。 - リクエストとレスポンスは約 256 KiB 以下に抑える必要があります。より大きなデータにはストレージを使用します。
- すべての呼び出しはステートレスです。呼び出しの間にデータをメモリに保持しないでください。
- シークレットは関数の変数であり、
aura secrets setまたはPUT /envで設定されます。保存時の暗号化は、展開にキーがある場合にのみ、PUTパスにのみ適用されます。 - 関数が
console.logで何を記述するかは、まだ利用できません。現在のギャップについては、の制限 を参照してください。 - リージョンは 1 つで、バージョン履歴はありません。関数は Git に保存してください。