この教科書について
読者として、JavaScript / HTTP / コマンドラインの基礎があるエンジニアを想定しています。Cloudflare の経験は不要です。各章は「概念解説 → 図解 → ハンズオン → つまずきポイント → 理解度チェック」で構成され、章ごとに独立して読めますが、第 I 部(第 1〜4 章)だけは順番に進めることを推奨します。
必要なもの: Cloudflare アカウント(Free プランで可)、Node.js LTS、ターミナル。一部の章(Queues など)は Workers Paid プラン(月額 $5〜)が必要で、該当箇所に明記しています。
情報の鮮度: 本書は 2026-08 時点の公式ドキュメントに準拠しています。制限値・料金・ベータ機能の状況は変わるため、実装前に各章末の参考リンクから最新のドキュメントを確認してください。
目次
第 I 部 基礎編
第 1 章
Cloudflare の全体像と開発環境セットアップ
Cloudflare のネットワークと開発者プラットフォームを俯瞰し、アカウント作成から C3 でのプロジェクト生成、wrangler dev でのローカル起動までを実践する。
第 2 章
Workers 基礎 — 初めてのサーバーレス関数
V8 isolate の実行モデルを理解し、fetch ハンドラで最初の Worker を書き、wrangler dev からデプロイ・tail でのログ確認までの基本サイクルを一周します。
第 3 章
Workers 実践 — 設定・バインディング・スケジュール実行
wrangler.jsonc の主要設定、環境変数とシークレット、バインディングの全体像、Cron Triggers、複数環境、キャッシュの初歩まで、Worker を実運用に近づける設定術を学ぶ。
第 4 章
静的アセットと Pages — サイトホスティング
assets ディレクトリで静的サイトを無料配信し、SPA フォールバックや run_worker_first、_headers / _redirects で挙動を制御。静的サイト + API を 1 つの Worker にまとめ、Pages との使い分けも学ぶ。
第 II 部 ストレージとデータ編
第 5 章
Workers KV — グローバル key-value ストア
結果整合・読み取り特化の Workers KV を学ぶ。namespace 作成、wrangler kv、Worker からの get / put / list / delete、TTL と metadata、無料枠までを実装で体得する。
第 6 章
R2 — エグレス無料のオブジェクトストレージ
エグレス無料・S3 互換の R2 を学ぶ。Worker バインディングで put / get / delete / list を実装し、画像アップローダーの構築から公開方法・料金モデルまで押さえる。
第 7 章
D1 — サーバーレス SQL データベース
SQLite セマンティクスの D1 を学ぶ。migrations でスキーマを管理し、prepare / bind / batch で蔵書管理 CRUD API を構築。リードレプリカ・制限・料金まで押さえる。
第 8 章
Durable Objects — ステートフルな分散オブジェクト
ID ごとに世界で 1 つだけ動く Durable Object の実行モデルを学び、SQLite ストレージ・Alarms・WebSocket Hibernation でカウンタとチャットルームを作ります。
第 9 章
Queues — 非同期メッセージング
HTTP 受付は即応答し、重い処理は Queues へ逃がす非同期パターンを実装。at-least-once 配送、バッチ調整、ack / retry の個別制御、Dead Letter Queue まで学びます。
第 10 章
Workflows — 耐久性のある多段処理
step 単位で状態を永続化し自動リトライする Workflows。多段ステップの構築、意図的な失敗でのリトライ観察、waitForEvent による承認フローまでを体験する。
第 III 部 AI 編
第 11 章
Workers AI — エッジで動く AI 推論
サーバーレス GPU で LLM を動かす Workers AI。ai バインディングと env.AI.run、SSE ストリーミング、埋め込み、ニューロン課金を実践する。
第 12 章
Vectorize と AI Search — ベクトル検索と RAG
埋め込みと類似度検索の基礎から、Vectorize + Workers AI で手組みする RAG と AI Search によるマネージド RAG までを、小さな社内 FAQ ボットの実装で学びます。
第 13 章
AI Gateway と Agents — AI アプリの観測とエージェント
AI 呼び出しを AI Gateway に通してログ・コスト・キャッシュを観測し、Agents SDK で永続状態・スケジュール・WebSocket 同期を備えたエージェントを作る。
第 IV 部 守りと運用編
第 14 章
アプリを守る — Turnstile・WAF・レート制限
CAPTCHA 代替の Turnstile をフォームに設置し Worker で siteverify 検証を実装。WAF のマネージド/カスタム/レート制限ルールと Bot 対策、secrets の安全な扱いを無料プランの範囲込みで学ぶ。
第 15 章
CDN・DNS・カスタムドメイン
オレンジクラウドの意味とネームサーバー移管、CDN キャッシュの既定動作と Cache-Control、CF-Cache-Status の読み方、Worker への独自ドメイン設定と SSL/TLS モードを実測で学ぶ。
第 16 章
観測・デプロイ運用・料金
Workers Logs と wrangler tail、メトリクスとソースマップ、Versions による段階的デプロイとロールバック、limits・料金モデル・nodejs_compat・Workers Builds を運用目線で押さえる。