
# 関数のデプロイ

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

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

## デプロイされるもの

`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`、[ビルド](building.md)を参照) には 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`、[ビルド](building.md)を参照)。デプロイの方法は同じで、ファイルが一つ増えるだけです。選ぶ前に、自分のアプリケーションで両方を計測してください。どちらが速いかについて、スターターは何も約束しません。

どのデプロイの前にも、アプリケーションのディレクトリで次を実行します。

```bash
dart pub get
dart run build_runner build     # the generated code of the application
```

## Supabase Edge Functions

[Supabase CLI](https://supabase.com/docs/guides/local-development/cli/getting-started) とプロジェクトが必要です。アプリケーションのディレクトリには、`supabase init` が作るのと同じ `supabase/` ディレクトリがあります (なければ作られます)。

**1. サインインしてプロジェクトを選ぶ** (一度だけ):

```bash
supabase login
supabase link --project-ref <ref>      # <ref>.supabase.co
```

**2. 関数を宣言する** (`supabase/config.toml`):

```toml
[functions.api]
verify_jwt = false        # the application checks the tokens itself
```

`verify_jwt = true` (プラットフォームのデフォルト) では、プロジェクトのトークンを持たないリクエストはすべて、アプリケーションに届く前にゲートウェイが拒否します。そのため、誰にでも開かれたエンドポイントは開かれたものになりません。WebAssembly のビルドでは、モジュールも列挙します。

```toml
[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 でも動きます。

```bash
dart run spring_boot_starter_edge:build --platform supabase --name api \
  --target wasm --dart ~/sdk/dart-3.13/bin/dart
```

**3. ビルドする** (`supabase/functions/api/` へ):

```bash
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.*` を作ります。アプリケーションが環境から読むそれ以外のものは、プロジェクトのシークレットです。

```bash
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 します。

```bash
supabase db push
```

**6. デプロイする:**

```bash
supabase functions deploy api
```

CLI は `index.ts` を、それがインポートするもの (`main.js`、`prelude.js`。WebAssembly のビルドのモジュールは静的ファイルとして) とまとめてバンドルし、アップロードします。

**7. 呼び出す:**

```bash
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` にもう一行必要です (ホスト型のプロジェクトでは不要です)。

```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. ビルドする:**

```bash
dart run spring_boot_starter_edge:build --platform cloudflare --name shop
# or: ... --name shop --target wasm
```

`build/cloudflare/` を書き、初回にはアプリケーションのディレクトリに `wrangler.toml` も書きます。

```toml
name = "shop"
main = "build/cloudflare/worker.mjs"
compatibility_date = "2026-11-11"
```

`wrangler.toml` はそれ以降あなたのものです。コミットしてください。`build/` はコミットしません。

**3. 設定。** 通常の値は `wrangler.toml` に、シークレットは Cloudflare に置きます。どちらもアプリケーションの環境です (`${NAME}`、`SPRING_...` はプロパティとして)。

```toml
[vars]
GREETING = "hello"
```

```bash
npx wrangler secret put JWT_SECRET
```

**4. バインディング。** アプリケーションが使う場合 (`CloudflareBindings`、D1 のレートリミッター):

```bash
npx wrangler d1 create shop                 # prints the database_id
npx wrangler kv namespace create SETTINGS   # prints the id
```

```toml
[[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. デプロイする:**

```bash
npx wrangler deploy
```

wrangler は `worker.mjs` を `main.js` とまとめてバンドルし (WebAssembly のビルドでは `app.wasm` をモジュールとしてアップロードします。Cloudflare がデプロイ時にコンパイルし、Worker は実行時にはコンパイルできません)、アドレス `https://shop.<your-subdomain>.workers.dev` を表示します。

**6. 独自ドメインとスケジュール** (`wrangler.toml`):

```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](https://docs.aws.amazon.com/cli/) と、サインイン済みのアカウントが必要です。

**1. ビルドして zip にする:**

```bash
dart run spring_boot_starter_edge:build --platform aws --name api
(cd build/aws && zip -q -r ../function.zip .)
```

**2. 関数のロール** (一度だけ): Lambda が関数を実行し、ログを書けるようにします。

```bash
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. 関数を作成する** (一度だけ):

```bash
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 です。

```bash
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. 設定:** 関数の環境変数が、アプリケーションの環境です。

```bash
aws lambda update-function-configuration --function-name api \
  --environment "Variables={GREETING=hello,JWT_SECRET=...}"
```

**6. 新しいバージョンをデプロイする:**

```bash
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 をストリーミングに切り替えます。

```bash
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 を実行します。

```bash
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 から

```bash
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` を実行すると、レート、レイテンシ、ステータスが表示されます。

## 関連項目

- [ビルド](building.md)
- [Supabase Edge Functions](supabase.md)
- [Cloudflare Workers](cloudflare.md)
- [AWS Lambda](aws.md)
- [関数が異なる点](differences.md)
