Cloudflare Workers
--platform cloudflare は、worker.mjs、main.js、prelude.js を持つ build/cloudflare/ と、アプリケーションのディレクトリの wrangler.toml (一度だけ) を書きます。npx wrangler deploy でデプロイします。ビルド を参照してください。
- ワーカーの
envはリクエストとともに届くので、コンテキストは最初のリクエストで起動します。その文字列の値 ([vars]、シークレット) はアプリケーションの環境になります。オブジェクトであるバインディング (KV、D1) はプロパティではありません。下の「バインディング」を参照してください。 - クライアントのアドレスは
CF-Connecting-IPです。これは Cloudflare のネットワークが自分で設定し、クライアントが送ってきたときは置き換えます。 wrangler.tomlは一度だけアプリケーションのディレクトリに、名前、mainとしてビルドされたworker.mjs、その日の互換性日付とともに書かれます。それ以降はあなたのものです (バインディング、ルート、cron トリガー)。
バインディング
Bean cloudflareBindings (CloudflareBindings) は、ワーカーの KV 名前空間 (KvNamespace) と D1 データベース (D1Database) を、wrangler.toml でのバインディング名で返します。
[[kv_namespaces]]
binding = "SETTINGS"
id = "..."
[[d1_databases]]
binding = "DB"
database_name = "shop"
database_id = "..."
@Service()
class Settings {
Settings(this.bindings);
final CloudflareBindings bindings;
Future<String?> theme() => bindings.kv('SETTINGS').get('theme');
Future<List<Map<String, Object?>>> orders(String user) => bindings
.d1('DB')
.query('select id, total from orders where user = ?1', [user]);
}
バインディングはリクエストとともに届きます。コンストラクターではなく、リクエスト (またはスケジュールイベント) を処理している間に使ってください。その他の種類のバインディング (キュー、R2、Durable Objects) の API は、まだありません。
D1 のレートリミッター
spring.edge.cloudflare.rate-limit.database: DB (D1 データベースのバインディング) を設定すると、レートリミッターのカウンターはそのデータベースに置かれます (D1RateLimitStore、ストア名 d1。アトミックな一つの文で、テーブルがなければ作られます)。ワーカーのすべてのインスタンスで共有されます。spring.edge.cloudflare.rate-limit.table でテーブル名を指定できます (デフォルトは rate_limit)。KV はカウンターを置く場所ではありません。書き込みがアトミックではないためです。
cron トリガー
cron トリガー (wrangler.toml の [triggers] crons) は、アプリケーションの EdgeScheduledHandler の Bean を実行します。event.schedule はトリガーの式です。スケジュールによる処理 を参照してください。