関数のデプロイ

spring_boot_starter_edge で作ったアプリケーションを Supabase Edge Functions、Cloudflare Workers、AWS Lambda に届ける手順を、順を追って説明します。最初は手作業で、次に GitHub Actions からです。Supabase で空のディレクトリから最後まで通して行う例は、空のディレクトリから Supabase の関数まで を参照してください。

手順では各プラットフォーム自身のコマンドラインツールを使います。ツールのドキュメントに載っているコマンドと、スターターのテストが使うローカルランタイムに対して書かれたものです。デプロイした関数はそれらのテストの対象ではありません。プラットフォームがその後コマンドを変更していた場合は、このページよりもプラットフォームの記述を優先してください。

デプロイされるもの

dart run spring_boot_starter_edge:build は、次のものを含むディレクトリを書きます。

このディレクトリが関数のすべてです。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 関数をロールとアドレスとともに作成することです。

デプロイした関数の確認

関連項目