ビルド
dart run spring_boot_starter_edge:build はアプリケーションをコンパイルし (dart compile js -O2 -DSPRING_ALL_PLATFORMS=true)、その隣にプラットフォームのエントリーファイルを書きます。どれも手で書くものではなく、コミットするものでもありません。
dart run build_runner build
dart run spring_boot_starter_edge:build --platform supabase --name api
書かれるもの
--platform |
書き込み先 | ファイル | デプロイ |
|---|---|---|---|
supabase |
supabase/functions/<name>/ |
index.ts、main.js、prelude.js |
supabase functions deploy <name> |
cloudflare |
build/cloudflare/ |
worker.mjs、main.js、prelude.js。wrangler.toml はアプリケーションのディレクトリに (一度だけ) |
npx wrangler deploy |
aws |
build/aws/ |
index.mjs、main.cjs、prelude.js |
ディレクトリを zip にする。ランタイムは Node.js 22、ハンドラーは index.handler |
deno |
build/deno/ |
main.ts、main.js、prelude.js |
main.ts をエントリーポイントにして Deno Deploy へ。それ以外では deno run -A main.ts (PORT) |
netlify |
netlify/edge-functions/<name>/ |
index.js、main.js、prelude.js |
Netlify のビルドがコマンドを実行する |
vercel |
build/vercel/ |
index.mjs、main.cjs、prelude.js |
Vercel プロジェクトの関数 (その fetch エクスポート) |
オプション
| オプション | |
|---|---|
--name、-n |
関数の名前。デフォルトは api。Supabase と Netlify ではそのディレクトリ名、Supabase ではさらにパスの最初のセグメント、新しい wrangler.toml ではワーカーの名前 |
--target、-t |
js (デフォルト) または wasm |
--entry |
main のある Dart ファイル。デフォルトは bin/main.dart |
--output、-o |
関数のディレクトリ |
--optimization |
コンパイラーの -O レベル。0 から 4 で、デフォルトは 2 |
--dart |
コンパイルに使う dart。デフォルトは PATH 上の dart。Supabase 向けの WebAssembly には Dart 3.13 のものが必要 |
--streaming |
AWS: レスポンスストリーミングのハンドラー (AWS Lambda を参照) |
--path |
Netlify: 関数が応答するパス。デフォルトは /* |
-D<name>=<value> |
コンパイラーへの定義 |
サイズ
Web スターターとセキュリティスターターを持つ関数は、約 1.8 MB の JavaScript (gzip で 0.6 MB) です。コンテキストは、プラットフォームによって 50 から 250 ms で起動します。
WebAssembly
--target wasm は dart compile wasm (WasmGC) でコンパイルします。app.wasm (約 1.7 MB) とその app.mjs、そしてスクリプトの代わりに小さなローダーが書かれ、エントリーファイルは同じです。アプリケーションのコードは変わりません。
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 でも動きます。
| プラットフォーム | WebAssembly |
|---|---|
| Supabase | Supabase が Edge Runtime を更新するまでは、Dart 3.13 でコンパイルしたものだけ。Edge Runtime は Deno 2.1 で、その V8 (13.0) には、Dart 3.14 以降の dart compile wasm が使う WebAssembly の例外処理 (exnref) がありません。--dart <Dart 3.13 SDK の dart> でビルドし (ビルド自体はどの Dart でも動きます。新しい Dart は理由とともに拒否されます)、config.toml にモジュールを列挙します: [functions.<name>] static_files = ["./functions/<name>/*.wasm"] |
| Cloudflare | 対応。wrangler がデプロイ時にモジュールをコンパイルする (ワーカーは実行時にはできない) |
| AWS Lambda (Node.js 22) | 対応 |
| Deno Deploy | 対応 |
| Netlify、Vercel | 未確認 |
デプロイのワークフロー
dart run spring_boot_starter_edge:workflow --platform supabase --name api
アプリケーションのリポジトリに .github/workflows/deploy-<name>.yml を書きます。main (--branch) への push のたびに、ジェネレーターを実行し、関数をビルドし (--target)、デプロイします。対象は supabase (supabase functions deploy)、cloudflare (wrangler deploy)、aws (aws lambda update-function-code、GitHub の OIDC を使用) です。
必要なものはファイルの最初の数行に書かれ、リポジトリのシークレットと変数から取られます。秘密の値は書かれません。
| プラットフォーム | 必要なもの |
|---|---|
supabase |
シークレット SUPABASE_ACCESS_TOKEN、SUPABASE_PROJECT_REF |
cloudflare |
シークレット CLOUDFLARE_API_TOKEN、CLOUDFLARE_ACCOUNT_ID |
aws |
シークレット AWS_ROLE_ARN。変数 AWS_REGION、AWS_LAMBDA_FUNCTION |
その後、ファイルはあなたのものです (--force で置き換えます)。手作業の手順、各プラットフォームのシークレット、デプロイした関数の確認は関数のデプロイにあります。Deno Deploy、Netlify、Vercel は、リポジトリから自分でデプロイします。ビルドコマンドを渡してください。
コードとして
package:spring_boot_starter_edge/build.dart には、同じビルドがコード (EdgeBuild) として用意されています。ビルドスクリプトとテスト用です。