Cloudflare Workers

--platform cloudflare は、worker.mjs、main.js、prelude.js を持つ build/cloudflare/ と、アプリケーションのディレクトリの wrangler.toml (一度だけ) を書きます。npx wrangler deploy でデプロイします。ビルド を参照してください。

バインディング

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 はトリガーの式です。スケジュールによる処理 を参照してください。

関連項目