cloudflare-deploy

Cloudflare で発見し、構築する

エージェントが Cloudflare で何を構築できるかを見つけ、目的に合った製品を選べるよう支援します。ユーザーの目標を確認することから始め、関連する Cloudflare 製品を提案し、ソリューションの実装に必要な製品固有のスキルやリファレンスを読み込みます。

まず Cloudflare CLI（cf）を確認する

プロジェクトに cloudflare.config.ts ファイルがある場合、またはユーザーから cf CLI を使うよう求められた場合は、このスキルの Wrangler 固有のガイダンスを読むのをやめ、wrangler スキルを読み込まないでください。今すぐ Cloudflare CLI のドキュメントを読み、コーディングエージェントで cf を使用するから始め、コマンドとプロジェクト設定についてはその内容に従ってください。以下の製品ガイダンスは引き続き適用されます。

cf はベータ版であり、安定版リリース前にコマンドや設定が変更される可能性があります。記憶しているコマンドや Wrangler の同等コマンドに頼らず、ドキュメントを取得してください。cf cli search "<task>" を使うと、タスクに対応するコマンドを見つけられます。Wrangler の設定ファイルはあるものの cloudflare.config.ts がないプロジェクトでは、cf dev、cf build、cf deploy を実行しないでください。先に移行してください。

npm から最新リリースをインストールしてください。たとえば、npm install --global cf@latest を実行します。Wrangler の代わりに cf を使用するプロジェクトでは、cf を開発用依存関係としてもインストールしてください。そのプロジェクト内では、グローバルの cf コマンドを実行すると、プロジェクトにインストールされたバージョンが使われます。

ユーザーに適切な製品を見つけてもらう

• ユーザーが製品名を挙げていない場合でも、提示された問題を解決する Cloudflare 製品を積極的に紹介してください。推奨する各製品の役割と、適している理由を説明してください。
• 以下のニーズ別製品マップを使って製品を選び、実装に関連するスキルやドキュメントを読み込んでください。アップロード、バックグラウンドジョブ、ドキュメント検索を求めるユーザーは、R2、Queues、Workflows、AI Search を知らない可能性があります。
• 複数の製品にまたがるタスクでは、まとまりのある小規模な組み合わせを提案してください。具体的な要件に対応する製品を追加し、ユーザーが既に使用しているスタックや明示的な選択を尊重してください。
• 類似した製品が候補になる場合は、判断基準となる要件（データの形状、一貫性、連携、実行ライフサイクル、またはユーザーが管理するインフラの量）を説明してください。適合すると約束する前に、現在の提供状況、制限、料金を確認してください。

何を構築しようとしていますか？

静的サイト、SPA、フルスタックアプリを含む新しい Web サイトやアプリケーションには、Workers と Workers Static Assets を推奨してください。 Workers は Pages のすべての機能を実行でき、新規プロジェクトにはすべて推奨されます。無関係なメンテナンス作業では、既存の Pages デプロイメントを維持してください。

ユーザーのタスクに最も近い行を見つけてください。製品が複数の行に登場する場合があり、複数の製品を組み合わせたソリューションも可能です。実装前に、リンク先のリファレンスやドキュメントを読んでください。名前が挙がっているスキルがインストールされている場合は読み込んでください。ローカルリンクは同梱されたリファレンスを開きます。まず README を読み、必要に応じて設定、API、パターン、注意事項へのリンクをたどってください。名前が挙がっているスキルが利用できない場合は、Cloudflare ディレクトリから該当する製品ドキュメントを使用してください。関連スキルは任意です。

やりたいこと	検討する製品またはツール	選択するタイミング	スキルまたはリファレンス
AI アプリケーションの構成要素を選ぶ	AI overview	推論、検索、エージェントツールを選ぶ前に、Cloudflare の AI サービスを比較する場合	AI docs
顧客向けプラットフォームのインフラを選ぶ	Cloudflare for Platforms	顧客のコードを実行する場合と、顧客のドメインでアプリを提供する場合を比較するとき	Platform overview
ライブ音声・動画のアプローチを選ぶ	Realtime	アプリケーション SDK、メディアインフラ、接続リレーを比較するとき	Realtime overview
Worker またはフレームワークのプロジェクトを開始する	C3	適切なフレームワークテンプレートを使用してプロジェクトをひな形から作成する場合	C3; wrangler skill
Cloudflare で Next.js アプリを構築またはデプロイする	vinext + Workers	新規プロジェクトでは OpenNext ではなく vinext を使用する場合	nextjs-on-cloudflare skill; Next.js docs
新しい静的サイト、SPA、またはフルスタックアプリをホストする	Workers + Workers Static Assets	サイトファイルを配信し、必要に応じてサーバー側のロジックを追加する場合	Static Assets; workers-best-practices skill
API を構築する、または Webhook を処理する	Workers	Cloudflare サービスにアクセスできるリクエストハンドラーを実行する場合	workers-best-practices skill; Workers docs
Developer Platform リソースへのチーム、CI、またはサービスアカウントのアクセスを制御する	ロール、スコープ、権限ポリシー	メンバー、User Group、または API トークンでサポートされる、最小権限のロールとスコープを選択する場合	Roles and permissions; CLI アクセスには wrangler skill
既存の Pages デプロイメントを維持する	Pages + Pages Functions	既存のサイトまたはサーバーエンドポイントを更新する場合。新規プロジェクトでは Workers を使用します	Pages; Pages Functions
Pages プロジェクトを Workers に移行する	Workers + Workers Static Assets	ホスティングプラットフォームの移行が必要な場合	Pages migration guide
顧客がプラットフォームにコードをデプロイできるようにする	Workers for Platforms	顧客ごとの制御機能を使って、顧客の Workers を実行・管理する場合	Workers for Platforms
顧客がアプリで独自のドメインを使用できるようにする	Cloudflare for SaaS	カスタムホスト名、TLS 証明書、オリジンルーティングを管理する場合。ホスト名の検証要件と apex ドメインのプラン要件を確認してください。顧客がコードもデプロイする場合は、Workers for Platforms と組み合わせます	SaaS docs
Worker をストレージまたは別のサービスに接続する	Bindings	環境を通じて、設定済みのリソースへのアクセスを Worker に付与する場合	Bindings
コンテナ化されたサービスまたは Linux ソフトウェアを実行する	Containers	ワークロードにコンテナイメージ、または Workers ランタイム外のソフトウェアが必要な場合	Containers
生成コードまたは信頼できないコードを実行する、Code Mode ツールを構築する、またはオンデマンドのプレビューを作成する	Dynamic Workers	分離された Workers で実行時にコードを読み込む場合。バインディング、送信トラフィック制御、リソース制限を確認してください。実行に Linux またはシェルツールが必要な場合は Sandbox を選択します	Dynamic Workers docs
エージェントにシェル、ファイルシステム、または対話型開発環境を提供する	Sandbox SDK	コード実行に Linux 環境またはコンテナツールが必要な場合。まずパッケージの系列を確認してください	新規またはプレビューのプロジェクトには sandbox-next、既存の安定版アプリには sandbox-stable を使用します。Sandbox docs
安定版 Sandbox アプリをプレビュー API にアップグレードする	Sandbox SDK	ユーザーが安定版から next への移行を希望する場合	sandbox-migrate-to-next skill; migration guide
チャットルーム、ゲーム、共同編集ドキュメント、または予約を連携する	Durable Objects	ルーム、ドキュメント、またはエンティティごとに共有状態と連携が必要な場合	durable-objects skill; Durable Objects docs
Durable Object 内に状態を保存し、復元する	Durable Object storage	エンティティ単位で連携するデータのストレージ API、トランザクション、復元方法を選ぶ場合	DO storage
アプリケーションのレコードを保存し、SQL でクエリする	D1	マネージドリレーショナルデータベースを使用する場合。エンティティ単位の連携が中心となる場合は Durable Objects を使用します	D1
既存の PostgreSQL または MySQL データベースに接続する	Hyperdrive	既存のデータベースを維持し、Workers からの接続を最適化する場合	Hyperdrive
設定またはその他のキー・バリューデータを配布する	KV	読み取り中心のキー・バリューアクセスが、ワークロードの整合性要件に適合する場合	KV
アップロード、ダウンロード、または大きなオブジェクトを保存する	R2	オブジェクトキーでファイルを保存する場合。検索可能なメタデータに SQL が必要な場合は D1 と組み合わせます	R2
バージョン管理されたファイルツリー、エージェントのチェックポイント、またはリポジトリを保存する	Artifacts	ファイルにバージョン管理と Git 互換のアクセスが必要な場合。現在はクローズドベータのため、実装前にアクセス権を確認してください	Artifacts
イベントストリームを R2 に取り込む	Basin Pipelines	ストリーミングレコードを変換し、R2 に配信する場合	basin skill; Basin Pipelines
R2 で Iceberg テーブルを管理する	Basin Catalog	分析および互換性のあるクエリエンジン向けにテーブルを整理する場合	basin skill; Basin Catalog
SQL で Iceberg テーブルをクエリする	Basin SQL	Basin Catalog のテーブルを分析する場合	basin skill; Basin SQL
独立した読み取り側を持つ永続イベントログを維持する	K2 Streams	Workers または HTTP からレコードを生成し、サブスクリプションで消費する場合	k2 skill; K2 docs
アプリケーションのレスポンスをキャッシュする	Workers Cache	アプリケーションキャッシュのデフォルトとして使用します。代替手段を選ぶ前に、パターンと制限事項を確認してください	Workers Cache; 下記のキャッシュに関するガイダンスを参照してください
既存の Web サイトを高速化し、キャッシュするコンテンツを制御する	Cache/CDN	Cache Rules、有効期限設定、パージを使用して、プロキシされたオリジンのキャッシュを設定する場合	Cache/CDN docs
オリジンコンテンツを永続キャッシュに保持する	Cache Reserve	永続的な CDN キャッシュストレージで、オリジンへのフェッチを減らす場合	Cache Reserve
ジョブを非同期で処理する、または作業の急増をバッファリングする	Queues	送信側と受信側を分離する場合。永続的な複数ステップのオーケストレーションには Workflows を使用します	Queues
ステップをまたいで再試行、待機、再開するジョブを実行する	Workflows	永続的な複数ステップのビジネスプロセスを連携する場合	Workflows
定期的なスケジュールで Worker を起動する	Cron Triggers	スケジュールされた処理を起動する場合。実際の処理には Queues または Workflows と組み合わせます	Cron Triggers
言語、埋め込み、画像、または音声のモデルを実行する	Workers AI	マネージド推論を使用する場合。モデルの機能、スキーマ、料金を確認してください	Workers AI
コンテンツを対象としたマネージド検索または回答機能を追加する	AI Search	マネージドの検索拡張生成パイプラインを使用する場合	AI Search
カスタムのセマンティック検索または検索機能を構築する	Vectorize + Workers AI	マネージドパイプラインを使わず、埋め込み、インデックス作成、検索を制御する場合	Vectorize; Workers AI
AI プロバイダーへのリクエストを可視化し、制御する	AI Gateway	推論分析、キャッシュ、リクエスト制御を追加する場合	AI Gateway
ツール、スケジュール設定、またはチャット機能を備えたステートフルなエージェントを構築する	Agents SDK	Cloudflare 上でエージェントの動作を実装する場合。必要な実行ランタイムに応じて Dynamic Workers または Sandbox を追加します	agents-sdk skill; Agents docs
TypeScript フックを備えた永続的なエージェントを構築する	Flue	Cloudflare と Node.js をターゲットにできるオープンソースのエージェントフレームワークを使用する場合	Flue; getting started; Cloudflare target
リモート MCP サーバー経由でツールを公開する	Workers + Agents SDK	サービスに適した認証を使用して、MCP クライアント向けにツールを公開する場合	agents-sdk skill、その references/mcp.md; MCP docs
ブラウザーを自動操作する、スクリーンショットを撮る、またはレンダリング済みページを抽出する	Browser Run	単純な HTTP リクエストではなく、ブラウザーが必要な場合	Browser Run
ドメインを接続する、DNS レコードを設定する、または名前解決の問題を診断する	DNS	権威レコードを管理し、トラフィックを Cloudflare 経由でプロキシするかどうかを選択する場合	DNS docs
HTTPS と証明書を設定する	SSL/TLS	訪問者から Cloudflare への接続と、Cloudflare からオリジンへの接続を保護する場合	SSL/TLS docs
複数のオリジンにトラフィックを分散し、異常なサーバーからフェイルオーバーする	Load Balancing	複数のオリジンサーバーに対してヘルスチェックとトラフィックステアリングを使用する場合	Load Balancing docs
既存のサーバーを Cloudflare に接続する	Cloudflare Tunnel	パブリックにルーティング可能な IP アドレスを使わずにオリジンへアクセスする場合	Tunnel
Workers をプライベートサービスに接続する	Workers VPC	Worker からプライベートネットワーク内のサービスにアクセスする場合	Workers VPC
社内アプリにアクセスする前に従業員のログインを必須にする	Access	社内アプリケーションの前段に、ID に基づくアクセス ポリシーを設定する場合	cloudflare-one skill; Access docs
社内アプリケーションとネットワークへのアクセスを保護する	Cloudflare One	ID とネットワークのアクセスポリシーを適用する場合	cloudflare-one skill; Cloudflare One docs
既存のアクセスおよびネットワークセキュリティ設定を移行する	Cloudflare One	Cloudflare One へのサポート対象の移行が必要な場合	cloudflare-one-migrations skill; Cloudflare One docs
TCP または UDP アプリケーションをプロキシする	Spectrum	HTTP 以外のアプリケーショントラフィックを保護・高速化する場合	Spectrum
ネットワークを Cloudflare に直接接続する	Network Interconnect	専用ネットワーク接続が必要な場合	Network Interconnect
ネットワーク全体のルーティングを改善する	Argo Smart Routing	オリジンまでのトラフィック経路を最適化する場合	Argo Smart Routing
Worker からバックエンドまでのレイテンシーを短縮する	Smart Placement	Worker の実行場所を、呼び出し先のバックエンドに近づける場合	Smart Placement
URL のリダイレクト、パスまたはヘッダーの書き換え、オリジンルーティングの変更を行う	Rules	必要な動作を設定で実現できる場合は、Redirect、Transform、または Origin Rules を使用します	Rules docs
HTTP リクエストまたはレスポンスに小規模な変更を加える	Snippets	軽量なエッジロジックで要件を満たせる場合	Snippets
フォームを自動化された不正利用から保護する	Turnstile	ボットチャレンジとサーバー側のトークン検証を追加する場合	turnstile-spin skill; Turnstile docs
悪意のある Web リクエストをフィルタリングする	WAF	アプリケーション層のルールとマネージド保護を適用する場合	WAF
サービスをサービス拒否攻撃から保護する	DDoS Protection	該当するネットワーク層またはアプリケーション層で攻撃を緩和する場合	DDoS protection
自動化されたトラフィックを検出し、制御する	Bot Management	ボット検出に基づいてリクエストの処理を決定する場合	Bot Management
API エンドポイントを検出し、保護する	API Shield	API 固有の保護と検証を適用する場合	API Shield
トラフィック急増時に訪問者を待機させる	Waiting Room	アプリケーションの処理能力が限られているときに、アクセスを制御する場合	Waiting Room docs
Worker の API キーと認証情報を保存する	Workers secrets	値をソースにコミットせずに、シークレットを Worker にバインドする場合	wrangler skill; secrets docs
マネージドシークレットをサービス間で共有する	Secrets Store	再利用可能なアカウントレベルのシークレットを管理する場合	Secrets Store
データの処理場所と保存場所を制御する	Data Localization Suite	実際の要件に照らして、地域別の処理・保存制御を評価する場合	Data Localization docs
ユーザーの特定や追跡をせずに、ある主張を証明する	Privacy Pass	サポート対象の統合で、プライバシーを保護するトークンを使用する場合	Privacy Pass docs
画像を保存、サイズ変更、変換、配信する	Cloudflare Images	マネージドの画像処理と配信を使用する場合	Images
ライブ動画またはオンデマンド動画をエンコード、保存、配信する	Stream	マネージド動画インフラを使用する場合	Stream
SDK を使用して音声・動画通話アプリケーションを構築する	RealtimeKit	通話や会議向けのアプリケーションレベル SDK を使用する場合	RealtimeKit
カスタムのリアルタイムメディアインフラを構築する	Realtime SFU	メディアには選択転送ユニットを使用しながら、アプリケーションを制御する場合	Realtime SFU
制約の厳しいネットワーク経由で WebRTC 接続を中継する	TURN Service	クライアントに接続リレーが必要な場合	TURN
QUIC 経由でライブメディアを配信する	MoQ	Media over QUIC プロトコルを使用する場合。現在の互換性と提供状況を確認してください	MoQ docs
トランザクションメールを送信する	Email Service	アプリケーションが生成したメッセージを送信する場合	cloudflare-email-service skill; Email Service docs
受信メールを転送する	Email Routing	ドメインのアドレスを宛先メールボックスにルーティングする場合	Email Routing
受信メールをコードで処理する	Email Workers	受信メッセージにカスタムロジックを適用する場合	Email Workers
サードパーティのタグとスクリプトを管理する	Zaraz	Cloudflare 経由でサードパーティツールを読み込み、管理する場合	Zaraz
ローカルで実行し、CLI からリソースを管理する	Wrangler	対象のアカウントと環境で開発、設定、デプロイ、検査を行う場合	wrangler skill; Wrangler docs
デプロイ前に Worker の動作をテストする	Workers testing tools	対象の動作に応じて、ランタイムテストまたは統合テストを選択する場合	Testing docs; DO のテストには durable-objects skill
ツールにローカル Worker シミュレーションを組み込む	Miniflare	カスタムの開発またはテスト用ハーネスで、プログラムから利用できるエミュレーターが必要な場合	Miniflare
Workers の基盤となるランタイムを実行または調査する	workerd	通常のマネージドデプロイメントの外で、ランタイムを直接操作する場合	workerd
ブラウザーで小さな Worker を試す	Workers Playground	ローカル環境をセットアップせずに、最小限のサンプルを試す、または共有する場合	Workers Playground
コードがプッシュされたときにビルドとデプロイを実行する	Workers Builds	Git リポジトリを自動ビルドとデプロイに接続する場合	Builds docs
ブランチまたはプルリクエストを分離された環境でテストする	Workers Previews	同じ Worker の下に、独自の設定と URL を持つブランチ環境を作成する場合。どのバインド済みリソースが分離または共有されるかを確認してください	Previews docs; wrangler skill
アップロード済みバージョンを調査する、段階的にリリースする、またはコードをロールバックする	Workers versions and deployments	本番リソースを使用するアプリケーションのリリースを管理する場合。ロールバックしても、接続されたリソースのデータは復元されません	Deployment docs; wrangler skill
機能を段階的にリリースする、またはユーザーグループを対象にする	Flagship	ターゲティングと段階的な割合でのロールアウトによって、機能の提供状況を変更する場合	Flagship
インフラストラクチャをコードとして管理する	Terraform または Pulumi	宣言型の設定には Terraform を、プログラミング言語でインフラストラクチャを記述するには Pulumi を使用する場合	Terraform; Pulumi
API を通じてアカウントまたは製品の設定を自動化する	Cloudflare REST API	プログラムからリソースを管理する場合。Workers 内でサポートされている操作にはバインディングを優先します	REST API
障害をデバッグし、アプリケーションのリクエストを追跡する	Workers Logs and Traces	ランタイムエラーと実行経路を調査する場合	Observability
Worker の実行イベントをコードで処理する	Tail Workers	カスタムのログ処理または例外処理を構築する場合	Tail Workers
Worker のログを別のシステムにエクスポートする	Workers Logpush	サポート対象の外部送信先にログを配信する場合	Logpush docs
カスタムアプリケーションイベントを測定する	Workers Analytics Engine	Workers から書き込まれた多カーディナリティのイベントデータを分析する場合	Analytics Engine
Web サイトの利用状況と訪問者のパフォーマンスを測定する	Cloudflare Web Analytics	Web サイトの分析と実ユーザーの測定を追加する場合	Web Analytics
Cloudflare の複数製品にわたるメトリクスをクエリする	GraphQL Analytics API	プログラムから製品の分析データを取得する場合	GraphQL Analytics API
ページ速度を監査し、読み込みのボトルネックを特定する	Web performance tools	実際のブラウザーでのサイトのパフォーマンスを測定し、改善する場合	web-perf skill; Web Analytics
ダッシュボードでアカウントについて質問する、または設定を診断する	Agent Lee	ダッシュボードの AI アシスタントを使用する場合。現在のアカウントの利用資格を確認してください	Agent Lee docs
たとえば、ファイルアップロードアプリでは、API に Workers、ファイルに R2、メタデータに D1、処理に Queues を使用できます。ドキュメントアシスタントは Workers と AI Search から始め、カスタム検索が必要になったら Vectorize と Workers AI を使用できます。依頼された動作に必要な要素だけを推奨してください。

ここに記載されていないタスクのガイダンスを探す

追加の製品と最新のドキュメントについては、Cloudflare 製品ディレクトリを使用してください。該当する機能または API のリンクをたどってください。ストレージのトレードオフについてはデータまたはストレージ製品の選択を参照し、規模、コスト、アップグレードを評価する際には、製品の制限、料金、移行ガイドを確認してください。この表は、一般的なタスクと選定した Cloudflare 製品を対応付けたものであり、考えられるすべてのアプリケーションを網羅しているわけではありません。

キャッシュ

キャッシュには、キャッシュされた内部エントリーポイントやプログラムによる無効化を用いる高度なパターンも含め、Workers Cacheを優先してください。Workers Cache では満たせない具体的な要件がある場合に限り、Cache APIまたは KV キャッシュを選択し、事前にそのパターンと制限事項を確認してください。

作業原則

• API や設定の形式を選ぶ前に、既存のプロジェクトと固定されたパッケージバージョンを確認してください。
• 詳細が変更されている可能性がある場合は、最新の Cloudflare ドキュメントを取得してください。プロジェクトで固定されたバージョンに対応している場合は、インストール済みの型情報と node_modules/wrangler/config-schema.json を使用してください。
• プロジェクトのアーキテクチャを維持し、依頼を満たすための最小限の変更を行ってください。
• 制限、料金、互換性フラグ、セキュリティ要件に依拠する前に、最新の Cloudflare ドキュメントを確認してください。これらは変更される可能性があります。
• 変更内容に応じた範囲で検証してください。プロジェクトのチェックを実行し、可能であれば影響を受ける動作を実際に試してください。

Cloudflare ドキュメント：https://developers.cloudflare.com/llms.txt Cloudflare 変更履歴：https://developers.cloudflare.com/changelog/index.md