blog.dopana

戻る

Durable Objects(DO)は、Cloudflare Workersにステートフルな協調レイヤーを提供するソリューションです。各DOはグローバルに唯一のインスタンスとして動作し、強整合性(Strong Consistency)を保ちながら状態を保持します。

Durable Object(世界で唯一のインスタンス)ステートレス Workers(グローバルエッジ)永続ストレージ永続ストレージRAM(メモリ内ステート)RAM(メモリ内ステート)"同一IDの全リクエストを1つのインスタンスへルーティング""強い整合性(競合状態なし)""状態を継続的に保持"Worker 東京Worker ロンドンWorker 米国ID: 'user-room-42'アクティブ接続 & 状態"SQLite / KV Storage"

Workers vs Durable Objects#

Chat Room DO (ID: room-123)クライアント & ブラウザDurable Objects(IDごとに1つの調停インスタンス)Durable Objects(IDごとに1つの調停インスタンス)Chat Room DO (ID: room-456)Chat Room DO (ID: room-456)Cloudflare グローバルエッジ(ステートレス Workers)Cloudflare グローバルエッジ(ステートレス Workers)"エッジ接続""エッジ接続""HTTP リクエスト""ID: room-123 へルーティング""ID: room-123 へルーティング""ID: room-456 へルーティング"ユーザー A (WebSocket)ユーザー B (WebSocket)ユーザー C (HTTP REST)Worker(エッジ拠点 1)Worker(エッジ拠点 2)メモリ内ステート & 接続中WebSocket"組み込み SQLite / KV ストレージ"アラーム / タイマーメモリ内ステート"SQLite ストレージ"
WorkersDurable Objects
ステートレスステートフル
リクエストごとに複数インスタンス1つのIDに対して世界で1つのインスタンス
メモリ状態を保持しないメモリ(RAM)+ストレージに状態を保持
無限に自動スケールシャーディング(複数のDO)でスケール
330以上の拠点に分散単一のロケーションで実行(マイグレーション可能)

チャットルーム — 基本的な例#

12345678GET /?room=general&name=Alice (Upgrade: WebSocket)stub.fetch(request) [idFromName("general")]server.accept(), セッション "Alice" を保存101 Switching Protocols (WebSocket 接続確立)ブロードキャスト "Alice joined the chat"WS メッセージ: "Hello room!"broadcast("Alice: Hello room!", sender=Alice)WS メッセージ: "Alice: Hello room!"WebSocket 接続の初期化リアルタイムメッセージ配信ユーザー Aliceユーザー Bobステートレス Worker ルーターChatRoom [Durable Object]ユーザー Aliceユーザー Bobステートレス Worker ルーターChatRoom [Durable Object]

SQLite Storage — 組み込みストレージエンジン#

各Durable Objectには専用のSQLiteストレージが組み込まれています:

"/increment""/get""/reset"その他リクエスト: GET /increment/get /reseturl.pathnamestorage.get('count')storage.put('count', count + 1)storage.get('count')storage.put('count', 0)404 Not FoundJSON count を返却

storage.sql による SQL クエリ#

Durable Object 内で直接 SQL クエリを実行できます:

"GET""POST""PUT""DELETE"その他HTTP リクエストテーブルが存在しなければ作成:CREATE TABLE IF NOTEXISTS todos (...)HTTP メソッドSELECT * FROM todosORDER BY id DESCINSERT INTO todos (title)VALUES (?)UPDATE todos SET completed= ? WHERE id = ?DELETE FROM todos WHEREid = ?405 Method Not AllowedJSON: todos の配列201 Created: 作成された todoJSON: &{ success: true &}JSON: &{ success: true &}

アラーム — DO のスケジュールタスク#

123456GET /?delay=5000setAlarm(futureTimestamp){"message": "Alarm set for 5000ms"}alarm() ハンドラーの起動POST https://hooks.example.com/notify { event: 'alarm_fired' }setAlarm(nextHourTimestamp) [次回の定期実行をスケジュール]1. タイマー / アラームの登録2. 時間経過による実行(DOの起動)ユーザー / クライアントReminder DOctx.storage [アラームキュー]外部 Webhookユーザー / クライアントReminder DOctx.storage [アラームキュー]外部 Webhook

マルチプレイヤー ゲームサーバー#

"join""move""shoot"WebSocket メッセージイベントmsg.type1. プレイヤーセッションをMap に追加2. 初期状態を作成: x=0, y=03. ブロードキャスト: type:'players'1. 座標を更新: player.x += dx,player.y += dy2. ブロードキャスト: type:'move'1. 弾のベクトル・角度を計算2. ブロードキャスト: type:'shoot'WebSocket 切断イベント1. Map & State からプレイヤーを削除2. ブロードキャスト: type:'leave'ルーム内の全接続プレイヤーに更新ステートを送信

マイグレーション — DO の移行管理#

DO はクラスやスキーマの移行をダウンタイムなしでサポートします:

// wrangler.jsonc
{
  "durable_objects": {
    "bindings": [
      {
        "name": "COUNTER",
        "class_name": "Counter",
        "migration": "new_tag"
      }
    ]
  }
}
typescript

マイグレーションタイプ:

  • new_tag — 新規クラスタグ
  • new_classes — 複数クラスの追加
  • rename — クラス名変更
  • transfer — ネームスペース間のデータ移行

パターン — シャーディング(Sharding)#

単一の Durable Object インスタンスは物理的に1箇所で動作します。水平スケールを行うにはキーでシャーディングします:

"userId: 0 - 999""userId: 1000 - 1999""userId: 2000 - 2999""userId: N - N+999"リクエスト: userIdshardId = floor(userId / 1000)シャードルーターDO インスタンス: shard-0DO インスタンス: shard-1DO インスタンス: shard-2DO インスタンス: shard-N

まとめ#

Durable Objects はサーバーレスにおける「状態管理」の課題を解決します:

  • リアルタイム: WebSocket接続と中央集権的な強い整合性メモリ
  • ゲームサーバー: 低遅延なマルチプレイヤー協調
  • 分散協調: 分散ロック、リーダー選出、レートリミット
  • 組み込み SQLite: 外部データベース不要でリレーショナルクエリを実行

アーキテクチャの基本:通常のリクエストはステートレスな Workers で処理し、状態が必要な処理を Durable Objects に委譲します。キーによるシャーディングで無限のスケールアウトが可能です。

参考文献#