[ PROMPT_NODE_23910 ]
cloudflare-deploy
[ SKILL_DOCUMENTATION ]
# Cloudflare 部署
用于在 Cloudflare 平台上构建的整合技能。使用下方的决策树找到合适的产品,然后加载详细参考资料。
## 前置条件
- 当沙盒阻止部署网络调用时,请使用 `sandbox_permissions=require_escalated` 重新运行。
- 部署可能需要几分钟。请使用适当的超时值。
## 身份验证(部署前必需)
在执行 `wrangler deploy`、`wrangler pages deploy` 或 `npm run deploy` 之前验证身份:
bash
npx wrangler whoami # 如果已认证,显示账户信息
未认证?→ `references/wrangler/auth.md`
- 交互式/本地:`wrangler login` (一次性 OAuth)
- CI/CD:设置 `CLOUDFLARE_API_TOKEN` 环境变量
## 快速决策树
### "我需要运行代码"
需要运行代码?
├─ 边缘服务器函数 → workers/
├─ 带有 Git 部署的全栈 Web 应用 → pages/
├─ 有状态协调/实时处理 → durable-objects/
├─ 长时间运行的多步任务 → workflows/
├─ 运行容器 → containers/
├─ 多租户(客户部署代码) → workers-for-platforms/
├─ 定时任务 (cron) → cron-triggers/
├─ 轻量级边缘逻辑 (修改 HTTP) → snippets/
├─ 处理 Worker 执行事件 (日志/可观测性) → tail-workers/
└─ 优化到后端基础设施的延迟 → smart-placement/
### "我需要存储数据"
需要存储?
├─ 键值对 (配置, 会话, 缓存) → kv/
├─ 关系型 SQL → d1/ (SQLite) 或 hyperdrive/ (现有 Postgres/MySQL)
├─ 对象/文件存储 (S3 兼容) → r2/
├─ 消息队列 (异步处理) → queues/
├─ 向量嵌入 (AI/语义搜索) → vectorize/
├─ 强一致性实体状态 → durable-objects/ (DO 存储)
├─ 密钥管理 → secrets-store/
├─ 流式 ETL 到 R2 → pipelines/
└─ 持久化缓存 (长期保留) → cache-reserve/
### "我需要 AI/ML"
需要 AI?
├─ 运行推理 (LLMs, 嵌入, 图像) → workers-ai/
├─ 用于 RAG/搜索的向量数据库 → vectorize/
├─ 构建有状态 AI 智能体 → agents-sdk/
├─ 任何 AI 提供商的网关 (缓存, 路由) → ai-gateway/
└─ AI 驱动的搜索组件 → ai-search/
### "我需要网络/连接"
需要网络?
├─ 将本地服务暴露到互联网 → tunnel/
├─ TCP/UDP 代理 (非 HTTP) → spectrum/
├─ WebRTC TURN 服务器 → turn/
├─ 私有网络连接 → network-interconnect/
├─ 优化路由 → argo-smart-routing/
├─ 优化到后端延迟 (非用户端) → smart-placement/
└─ 实时视频/音频 → realtimekit