関数のデプロイ
spring_boot_starter_edge で作ったアプリケーションを Supabase Edge Functions、Cloudflare Workers、AWS Lambda に届ける手順を、順を追って説明します。最初は手作業で、次に GitHub Actions からです。Supabase で空のディレクトリから最後まで通して行う例は、空のディレクトリから Supabase の関数まで を参照してください。
手順では各プラットフォーム自身のコマンドラインツールを使います。ツールのドキュメントに載っているコマンドと、スターターのテストが使うローカルランタイムに対して書かれたものです。デプロイした関数はそれらのテストの対象ではありません。プラットフォームがその後コマンドを変更していた場合は、このページよりもプラットフォームの記述を優先してください。
デプロイされるもの
dart run spring_boot_starter_edge:build は、次のものを含むディレクトリを書きます。
- コンパイルされたアプリケーション: JavaScript ファイル一つ (
main.js、約 1.8 MB、gzip で 0.6 MB)。--target wasmの場合は、WebAssembly モジュール (app.wasm、約 1.7 MB) とそのローダー。 - プラットフォームのエントリーファイル: プラットフォームがリクエストごとに呼び出し、リクエストをアプリケーションに渡します。
このディレクトリが関数のすべてです。Dart SDK も pubspec.yaml もパッケージも、プラットフォームには送られません。プラットフォームはインスタンスを起動してエントリーを読み込み、アプリケーションのコンテキストが一度だけ起動し (50 から 250 ms)、インスタンスはプラットフォームが停止するまでリクエストに応答します。
JavaScript または WebAssembly。 どちらも同じアプリケーションで、同じテストに通ります。JavaScript はどこでも動き、デフォルトです。WebAssembly (--target wasm、ビルドを参照) には WasmGC と、Dart 3.14 以降は WebAssembly の例外処理 (exnref) のあるランタイムが必要です。Cloudflare Workers と AWS Lambda の Node.js 22 にはありますが、Supabase の Edge Runtime (Deno 2.1) にはまだないため、Supabase が更新するまでは、Supabase 向けの WebAssembly は Dart 3.13 でコンパイルします (--dart、ビルドを参照)。デプロイの方法は同じで、ファイルが一つ増えるだけです。選ぶ前に、自分のアプリケーションで両方を計測してください。どちらが速いかについて、スターターは何も約束しません。
どのデプロイの前にも、アプリケーションのディレクトリで次を実行します。
dart pub get
dart run build_runner build # the generated code of the application
Supabase Edge Functions
Supabase CLI とプロジェクトが必要です。アプリケーションのディレクトリには、supabase init が作るのと同じ supabase/ ディレクトリがあります (なければ作られます)。
1. サインインしてプロジェクトを選ぶ (一度だけ):
supabase login
supabase link --project-ref <ref> # <ref>.supabase.co
2. 関数を宣言する (supabase/config.toml):
[functions.api]
verify_jwt = false # the application checks the tokens itself
verify_jwt = true (プラットフォームのデフォルト) では、プロジェクトのトークンを持たないリクエストはすべて、アプリケーションに届く前にゲートウェイが拒否します。そのため、誰にでも開かれたエンドポイントは開かれたものになりません。WebAssembly のビルドでは、モジュールも列挙します。
[functions.api]
verify_jwt = false
static_files = ["./functions/api/*.wasm"]
Warning
Supabase の WebAssembly は、当面 Dart 3.13 でコンパイルしたものだけ動きます。 Supabase の Edge Runtime は Deno 2.1 で、その V8 (13.0) には、Dart 3.14 (Flutter 3.50) 以降の dart compile wasm が使う WebAssembly の例外処理 (exnref) がありません。Supabase が更新するまでは、関数を Dart 3.13 でコンパイルしてください: --dart <Dart 3.13 SDK の dart>。新しい Dart でのビルドは理由とともに拒否されます。JavaScript はどの Dart でも動き、WebAssembly もほかのプラットフォームではどの Dart でも動きます。
dart run spring_boot_starter_edge:build --platform supabase --name api \
--target wasm --dart ~/sdk/dart-3.13/bin/dart
3. ビルドする (supabase/functions/api/ へ):
dart run spring_boot_starter_edge:build --platform supabase --name api
# or: ... --name api --target wasm
名前は関数のアドレスです: /functions/v1/api/...。アプリケーションのマッピングでは繰り返しません (@GetMapping('/todos') は /functions/v1/api/todos に応答します)。
4. シークレット。 プラットフォームはすべての関数に SUPABASE_URL、SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY を渡し、スターターはそれらから spring.supabase.* を作ります。アプリケーションが環境から読むそれ以外のものは、プロジェクトのシークレットです。
supabase secrets set MAIL_API_KEY=... GREETING=hello
シークレット SPRING_MAIL_HOST はプロパティ spring.mail.host になります。どのシークレットも、application.yml では ${NAME} として使えます。
5. データベース。 アプリケーションがレート制限をそこで数える場合: package:spring_boot_starter_supabase/sql/rate_limit.sql を supabase/migrations/ にコピーして push します。
supabase db push
6. デプロイする:
supabase functions deploy api
CLI は index.ts を、それがインポートするもの (main.js、prelude.js。WebAssembly のビルドのモジュールは静的ファイルとして) とまとめてバンドルし、アップロードします。
7. 呼び出す:
curl https://<ref>.supabase.co/functions/v1/api/health
curl https://<ref>.supabase.co/functions/v1/api/todos?list=home \
-H "Authorization: Bearer <a user's access token>"
関数のログ (アプリケーションのログ行、起動、警告のリスト) は、ダッシュボードの関数のページで見られます。
ローカルでは、同じディレクトリが CLI のスタックで動きます。supabase start は supabase/functions/api を http://127.0.0.1:54321/functions/v1/api で提供します。そこでは関数が http://kong:8000 でプロジェクトに到達する一方、トークンは http://127.0.0.1:54321 を名乗るため、ローカルのスタックでは config.toml にもう一行必要です (ホスト型のプロジェクトでは不要です)。
[edge_runtime.secrets]
SPRING_SUPABASE_AUTH_ISSUER = "http://127.0.0.1:54321/auth/v1"
Cloudflare Workers
Node.js (npx wrangler のため) と Cloudflare のアカウントが必要です。
1. サインインする (一度だけ): npx wrangler login。
2. ビルドする:
dart run spring_boot_starter_edge:build --platform cloudflare --name shop
# or: ... --name shop --target wasm
build/cloudflare/ を書き、初回にはアプリケーションのディレクトリに wrangler.toml も書きます。
name = "shop"
main = "build/cloudflare/worker.mjs"
compatibility_date = "2026-11-11"
wrangler.toml はそれ以降あなたのものです。コミットしてください。build/ はコミットしません。
3. 設定。 通常の値は wrangler.toml に、シークレットは Cloudflare に置きます。どちらもアプリケーションの環境です (${NAME}、SPRING_... はプロパティとして)。
[vars]
GREETING = "hello"
npx wrangler secret put JWT_SECRET
4. バインディング。 アプリケーションが使う場合 (CloudflareBindings、D1 のレートリミッター):
npx wrangler d1 create shop # prints the database_id
npx wrangler kv namespace create SETTINGS # prints the id
[[d1_databases]]
binding = "DB"
database_name = "shop"
database_id = "<printed>"
[[kv_namespaces]]
binding = "SETTINGS"
id = "<printed>"
[vars]
# The rate limiter's counters in that database, shared by every instance.
SPRING_EDGE_CLOUDFLARE_RATE_LIMIT_DATABASE = "DB"
5. デプロイする:
npx wrangler deploy
wrangler は worker.mjs を main.js とまとめてバンドルし (WebAssembly のビルドでは app.wasm をモジュールとしてアップロードします。Cloudflare がデプロイ時にコンパイルし、Worker は実行時にはコンパイルできません)、アドレス https://shop.<your-subdomain>.workers.dev を表示します。
6. 独自ドメインとスケジュール (wrangler.toml):
routes = [{ pattern = "api.example.com", custom_domain = true }]
[triggers]
crons = ["0 3 * * *"] # runs the EdgeScheduledHandler beans
ローカルでは: npx wrangler dev が、D1 と KV のローカルの代替を備えた Cloudflare のランタイムで、同じ Worker を実行します。
知っておくべき制限。 Worker のスクリプトは、無料プランでは gzip 後 3 MB、有料プランでは 10 MB までです。web と security のスターターを使った関数は 0.6 MB です。また無料プランではリクエストの CPU 時間が 10 ms に制限されており、インスタンスの最初のリクエストでアプリケーションのコンテキストが起動する時間は、これを超えることがあります。有料プランの上限ははるかに高いです。
AWS Lambda
AWS CLI と、サインイン済みのアカウントが必要です。
1. ビルドして zip にする:
dart run spring_boot_starter_edge:build --platform aws --name api
(cd build/aws && zip -q -r ../function.zip .)
2. 関数のロール (一度だけ): Lambda が関数を実行し、ログを書けるようにします。
aws iam create-role --role-name api-function \
--assume-role-policy-document '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}'
aws iam attach-role-policy --role-name api-function \
--policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
3. 関数を作成する (一度だけ):
aws lambda create-function --function-name api \
--runtime nodejs22.x --handler index.handler \
--architectures arm64 --memory-size 512 --timeout 30 \
--role arn:aws:iam::<account>:role/api-function \
--zip-file fileb://build/function.zip
ハンドラーは常に index.handler です。メモリを増やすと CPU も増え、起動が短くなります。
4. アドレス。 最も簡単なのは関数 URL です。
aws lambda create-function-url-config --function-name api --auth-type NONE
aws lambda add-permission --function-name api --statement-id url \
--action lambda:InvokeFunctionUrl --principal "*" \
--function-url-auth-type NONE
--auth-type NONE は、AWS がすべてのリクエストを通し、アプリケーション (Spring Security) が判断することを意味します。サーバーと同じです。同じ関数は、別のビルドなしで、API Gateway の HTTP API、API Gateway の REST API、Application Load Balancer にも応答します。エントリーがイベントの種類を見分けます。
5. 設定: 関数の環境変数が、アプリケーションの環境です。
aws lambda update-function-configuration --function-name api \
--environment "Variables={GREETING=hello,JWT_SECRET=...}"
6. 新しいバージョンをデプロイする:
dart run spring_boot_starter_edge:build --platform aws --name api
(cd build/aws && zip -q -r ../function.zip .)
aws lambda update-function-code --function-name api \
--zip-file fileb://build/function.zip
ストリーミング。 レスポンスはデフォルトでバッファリングされます。サーバー送信イベントは、ストリームが終わってから届きます。書かれている間に本文を送るには、--streaming でビルドし、関数 URL をストリーミングに切り替えます。
dart run spring_boot_starter_edge:build --platform aws --name api --streaming
aws lambda update-function-url-config --function-name api \
--invoke-mode RESPONSE_STREAM
ストリーミングのビルドは、関数 URL にのみ応答します。
スケジュール。 この関数をターゲットにした EventBridge のルールが、アプリケーションの EdgeScheduledHandler の Bean を実行します。
aws events put-rule --name nightly --schedule-expression "cron(0 3 * * ? *)"
aws lambda add-permission --function-name api --statement-id nightly \
--action lambda:InvokeFunction --principal events.amazonaws.com \
--source-arn arn:aws:events:<region>:<account>:rule/nightly
aws events put-targets --rule nightly \
--targets "Id=api,Arn=arn:aws:lambda:<region>:<account>:function:api"
レートリミッター。 スターターには AWS 用の共有ストアがありません。アプリケーションにあるもの (DynamoDB のテーブル、データベース) の上に RateLimitStore の Bean を宣言してください。宣言しないと、制限はインスタンスごとに数えられます。関数は起動時にそのことを伝えます。
GitHub Actions から
dart run spring_boot_starter_edge:workflow --platform supabase --name api
dart run spring_boot_starter_edge:workflow --platform cloudflare --name shop
dart run spring_boot_starter_edge:workflow --platform aws --name api
どれも .github/workflows/deploy-<name>.yml をリポジトリに書きます。main (--branch) への push のたびに、依存関係をインストールし、ジェネレーターを実行し、関数をビルドし (WebAssembly のビルドでは --target wasm)、上の手順でデプロイします。シークレットは書かれません。ファイルが挙げているものを、リポジトリの設定で登録してください。
| プラットフォーム | シークレットと変数 |
|---|---|
| Supabase | secrets.SUPABASE_ACCESS_TOKEN (アカウントのアクセストークン)、secrets.SUPABASE_PROJECT_REF |
| Cloudflare | secrets.CLOUDFLARE_API_TOKEN (Workers を編集できるトークン)、secrets.CLOUDFLARE_ACCOUNT_ID |
| AWS | secrets.AWS_ROLE_ARN (GitHub が OIDC で引き受けられるロール。lambda:UpdateFunctionCode を許可)、vars.AWS_REGION、vars.AWS_LAMBDA_FUNCTION |
ワークフローがデプロイするのはコードです。一度設定すればよいものは、その外に残ります。関数のシークレット (supabase secrets set、wrangler secret put、Lambda 関数の環境)、Supabase のマイグレーション、そして Lambda 関数をロールとアドレスとともに作成することです。
デプロイした関数の確認
- 誰にでも開かれたエンドポイントに
GETします。次にトークンが必要なエンドポイントを、トークンなし (401) とトークンありで呼びます。 - 関数のログの最初の行:
Function started in ... msと、警告のリスト (Running as a function; these work differently here)。警告のリストには、インメモリのレートリミッター、@Scheduledメソッド、インメモリのキャッシュが挙げられます。 - 小さな負荷: スターターのディレクトリから
dart run tool/function_load.dart <url> --clients 16 --seconds 10を実行すると、レート、レイテンシ、ステータスが表示されます。