SuperAPI AI 工具集

cloudflare-deploy

部署与运维

查看项目

更新于 10-15 08:52

技能介绍

Cloudflare Deploy 是一个用于在 Cloudflare 上构建、配置和部署应用与平台资源的技能。它的工作方式强调先选择正确的 Cloudflare 产品,再检查项目或基础设施形态,然后只加载相关的参考文件夹,最后才进行变更或部署。

使用条件:当前环境需要能够按需运行终端命令;用户需要拥有相关 Cloudflare 账户的访问权限;所选工作流需要具备所需的 Cloudflare 工具链,通常是基于 npx wrangler。如果认证或 CLI 设置尚未就绪,应先阅读 references/setup.md 再继续。

必需的工作流程按顺序执行:

第一步,先识别 Cloudflare 产品。不要直接跳到部署命令,而应先判断请求匹配的产品:workers 用于边缘代码执行;pages 用于 Web 应用托管;durable-objects、kv、d1、r2、queues 或 vectorize 用于数据和状态;workers-ai、agents-sdk、ai-gateway 或 ai-search 用于 AI 功能;waf、turnstile、api-shield 或 bot-management 用于安全;tunnel、spectrum、turn、argo-smart-routing 或相关网络工具用于连接。可借助决策树快速路由,然后只加载所需的参考目录,而不是扫描整个 references/ 目录树。

第二步,检查本地项目或目标基础设施。在更改任何内容前,检查相关文件和部署形态:应用部署需检查 package.json、wrangler.jsonc、wrangler.toml、迁移时的 netlify.toml 替代文件、构建脚本、锁文件和框架配置;Pages 需确定构建命令和输出目录;Workers 需确定入口点、绑定、兼容日期、路由和环境;基础设施或安全任务需确认目标账户、区域、资源标识符和环境。

第三步,验证认证与工具就绪状态。在执行 wrangler deploy、wrangler pages deploy 或其他 Cloudflare CLI 操作前验证认证,可运行 npx wrangler whoami 查看已认证的账户。如果缺少认证,则停止并使用 references/setup.md,不要猜测凭证、账户 ID 或区域 ID。

第四步,只加载匹配的参考集。选择产品后,读取相关参考文件夹:先看该文件夹的 README.md,再按需加载 configuration.md、api.md、patterns.md 或 gotchas.md,避免加载无关产品的参考。

技能内置多组快速决策树,用于回答“我需要运行代码”“我需要存储数据”“我需要 AI/ML”“我需要网络/连接”“我需要安全”“我需要媒体/内容”“我需要基础设施即代码”等场景,分别指向对应的产品参考目录。

技能还提供产品索引,按计算与运行时、存储与数据、AI 与机器学习、网络与连接、安全、媒体与内容、实时通信、开发者工具、基础设施即代码、其他服务等组别列出各产品对应的参考路径,例如 Workers、Pages、Durable Objects、KV、D1、R2、Queues、Workers AI、Vectorize、Agents SDK、AI Gateway、Tunnel、WAF、Images、Stream、Wrangler、Terraform、Pulumi 等。

故障排查方面:如果 Cloudflare CLI 操作因 DNS 或出站网络限制失败,可在主机支持时以提升或不受限的网络模式重新运行;遇到认证问题(如 npx wrangler whoami 失败、账户错误、CI 或无头环境需要基于令牌的认证)应使用 references/setup.md 和 references/wrangler/auth.md;如果请求范围过宽,应先缩小范围,明确哪个 Cloudflare 产品、哪个账户或区域、哪个环境,以及任务是只读、配置、迁移还是部署。