cloudflare-deploy

Cloudflare Deploy

Cloudflare プラットフォーム上で構築するための統合スキルです。以下の決定ツリーを使って適切なプロダクトを見つけ、その後に詳細なリファレンスを読み込んでください。

前提条件

• サンドボックスによってデプロイのネットワーク呼び出しがブロックされる場合は、sandbox_permissions=require_escalated を指定して再実行してください。
• デプロイには数分かかる場合があります。適切なタイムアウト値を設定してください。

認証（デプロイ前に必須）

wrangler deploy、wrangler pages deploy、または npm run deploy を実行する前に、認証を確認してください。

npx wrangler whoami    # Shows account if authenticated

認証されていない場合 → references/wrangler/auth.md

• 対話型／ローカル：wrangler login（一度だけの OAuth）
• CI/CD：CLOUDFLARE_API_TOKEN 環境変数を設定

クイック決定ツリー

「コードを実行したい」

Need to run code?
├─ Serverless functions at the edge → workers/
├─ Full-stack web app with Git deploys → pages/
├─ Stateful coordination/real-time → durable-objects/
├─ Long-running multi-step jobs → workflows/
├─ Run containers → containers/
├─ Multi-tenant (customers deploy code) → workers-for-platforms/
├─ Scheduled tasks (cron) → cron-triggers/
├─ Lightweight edge logic (modify HTTP) → snippets/
├─ Process Worker execution events (logs/observability) → tail-workers/
└─ Optimize latency to backend infrastructure → smart-placement/

「データを保存したい」

Need storage?
├─ Key-value (config, sessions, cache) → kv/
├─ Relational SQL → d1/ (SQLite) or hyperdrive/ (existing Postgres/MySQL)
├─ Object/file storage (S3-compatible) → r2/
├─ Message queue (async processing) → queues/
├─ Vector embeddings (AI/semantic search) → vectorize/
├─ Strongly-consistent per-entity state → durable-objects/ (DO storage)
├─ Secrets management → secrets-store/
├─ Streaming ETL to R2 → pipelines/
└─ Persistent cache (long-term retention) → cache-reserve/

「AI/ML を利用したい」

Need AI?
├─ Run inference (LLMs, embeddings, images) → workers-ai/
├─ Vector database for RAG/search → vectorize/
├─ Build stateful AI agents → agents-sdk/
├─ Gateway for any AI provider (caching, routing) → ai-gateway/
└─ AI-powered search widget → ai-search/

「ネットワーキング/接続性が必要」

Need networking?
├─ Expose local service to internet → tunnel/
├─ TCP/UDP proxy (non-HTTP) → spectrum/
├─ WebRTC TURN server → turn/
├─ Private network connectivity → network-interconnect/
├─ Optimize routing → argo-smart-routing/
├─ Optimize latency to backend (not user) → smart-placement/
└─ Real-time video/audio → realtimekit/ or realtime-sfu/

「セキュリティが必要」

Need security?
├─ Web Application Firewall → waf/
├─ DDoS protection → ddos/
├─ Bot detection/management → bot-management/
├─ API protection → api-shield/
├─ CAPTCHA alternative → turnstile/
└─ Credential leak detection → waf/ (managed ruleset)

「メディア/コンテンツを扱いたい」

Need media?
├─ Image optimization/transformation → images/
├─ Video streaming/encoding → stream/
├─ Browser automation/screenshots → browser-rendering/
└─ Third-party script management → zaraz/

「Infrastructure-as-Code を使いたい」

Need IaC? → pulumi/ (Pulumi), terraform/ (Terraform), or api/ (REST API)

プロダクトインデックス

コンピュート & ランタイム

プロダクト	リファレンス
Workers	references/workers/
Pages	references/pages/
Pages Functions	references/pages-functions/
Durable Objects	references/durable-objects/
Workflows	references/workflows/
Containers	references/containers/
Workers for Platforms	references/workers-for-platforms/
Cron Triggers	references/cron-triggers/
Tail Workers	references/tail-workers/
Snippets	references/snippets/
Smart Placement	references/smart-placement/

ストレージ & データ

プロダクト	リファレンス
KV	references/kv/
D1	references/d1/
R2	references/r2/
Queues	references/queues/
Hyperdrive	references/hyperdrive/
DO Storage	references/do-storage/
Secrets Store	references/secrets-store/
Pipelines	references/pipelines/
R2 Data Catalog	references/r2-data-catalog/
R2 SQL	references/r2-sql/

AI & 機械学習

プロダクト	リファレンス
Workers AI	references/workers-ai/
Vectorize	references/vectorize/
Agents SDK	references/agents-sdk/
AI Gateway	references/ai-gateway/
AI Search	references/ai-search/

ネットワーキング & 接続性

プロダクト	リファレンス
Tunnel	references/tunnel/
Spectrum	references/spectrum/
TURN	references/turn/
Network Interconnect	references/network-interconnect/
Argo Smart Routing	references/argo-smart-routing/
Workers VPC	references/workers-vpc/

セキュリティ

プロダクト	リファレンス
WAF	references/waf/
DDoS Protection	references/ddos/
Bot Management	references/bot-management/
API Shield	references/api-shield/
Turnstile	references/turnstile/

メディア & コンテンツ

プロダクト	リファレンス
Images	references/images/
Stream	references/stream/
Browser Rendering	references/browser-rendering/
Zaraz	references/zaraz/

リアルタイム通信

プロダクト	リファレンス
RealtimeKit	references/realtimekit/
Realtime SFU	references/realtime-sfu/

開発者ツール

プロダクト	リファレンス
Wrangler	references/wrangler/
Miniflare	references/miniflare/
C3	references/c3/
Observability	references/observability/
Analytics Engine	references/analytics-engine/
Web Analytics	references/web-analytics/
Sandbox	references/sandbox/
Workerd	references/workerd/
Workers Playground	references/workers-playground/

Infrastructure as Code

プロダクト	リファレンス
Pulumi	references/pulumi/
Terraform	references/terraform/
API	references/api/

その他のサービス

プロダクト	リファレンス
Email Routing	references/email-routing/
Email Workers	references/email-workers/
Static Assets	references/static-assets/
Bindings	references/bindings/
Cache Reserve	references/cache-reserve/

トラブルシューティング

エスカレートされたネットワークアクセス

デプロイがネットワークの問題（タイムアウト、DNS エラー、接続リセット）で失敗した場合は、エスカレートされた権限（sandbox_permissions=require_escalated を使用）でデプロイを再実行してください。サンドボックスのネットワーク設定が送信リクエストをブロックしている場合、デプロイにはエスカレートされたネットワークアクセスが必要です。

ユーザーへの案内の例:

The deploy needs escalated network access to deploy to Cloudflare. I can rerun the command with escalated permissions—want me to proceed?