SuperAPI AI 工具集

wrangler

部署与运维

查看项目

更新于 10-15 21:41

技能介绍

用途:帮助运行或排查 Wrangler CLI 命令,并配置 Worker 项目,用于本地开发、Previews、部署和 Cloudflare 资源管理。若项目存在 cloudflare.config.ts 或用户要求使用 cf CLI,则不应使用本技能,应改用 Cloudflare CLI 文档。

主要能力:发现命令与参数(资源管理、部署、回滚、诊断);编辑配置或添加绑定;部署框架应用;按需迁移到 Workers;配置预发或生产环境;设置本地、CI 或已部署 Worker 的密钥;生成绑定与运行时类型;本地运行或选择测试方式;选择角色、作用域或 API token 权限;创建或管理分支与 PR 环境;决定 Preview 资源是否隔离;配置 Preview URL、访问、调试或 CI;在 Previews、Version URLs 与 Wrangler 环境之间选择;诊断认证或选择账户;部署未认证原型。

使用方式:先检查项目,确认包管理器、已安装 Wrangler 版本、脚本、框架与配置,通过项目脚本或包管理器运行以使用本地版本;按现有 lockfile 安装依赖,不要静默升级 Wrangler。确定构建或部署命令使用的配置(含框架生成的配置),编辑其源文件而非生成产物。执行变更前先确定目标账户、Worker、环境与资源;数据操作需判断目标是本地还是远程。优先使用 Cloudflare MCP 文档工具或直接抓取相关页面,避免加载整份参考。新配置优先用 wrangler.jsonc;新项目兼容日期设为当天。注意环境继承,部分字段需按环境单独指定。使用 Cloudflare Vite 插件时,在 dev 或 build 时通过 CLOUDFLARE_ENV 选择环境。部署前将仪表盘改动与配置对齐,绑定已有资源时核对标识符。区分本地模拟与远程绑定。远程命令前确认认证成员或 API token 及所需角色与作用域,取满足意图的最小作用域;wrangler login 的 OAuth 不支持细粒度授权,需要时用账户自有 API token,且不要要求用户把值粘贴到对话中。密钥值不得出现在命令参数、源码和日志中。wrangler secret put 与 secret delete 视为部署,会立即创建并部署版本;需暂存时用 wrangler versions secret 工作流。回滚前注意限制:已连接资源及其数据不会随 Worker 代码回滚。

Workers Previews:需要项目本地 Wrangler 4.135.0 或更高版本,项目命令不会使用更新的全局安装。分支与 PR 环境用 Previews,检查特定已上传版本用 Version URLs,持久且单独部署的 Worker 用 Wrangler 环境。先了解用户如何管理生产配置与部署,Preview 域通过同一配置系统设置,部署走用户既有路径。部署前遵循当前配置放置表、资源矩阵与限制,不要凭 Preview 名称推断隔离,也不要写入生产资源,除非用户明确要共享。告知用户 Preview URL 默认公开,除非配置访问控制。确认目标 Worker 或 Wrangler 环境;针对 Wrangler 环境时,每条 Preview 命令传相同的 --env 值。

验证:TypeScript 项目改配置或绑定后,用项目的 wrangler types 重新生成类型,不要手改生成声明,并运行现有类型检查或测试。部署变更用项目构建流程和 wrangler deploy --dry-run(若支持),配合目标配置与环境;dry run 成功只验证构建与打包,不证明远程资源或运行时行为可用。Previews 返回 URL 不能验证依赖缺失绑定的行为。报告变更内容、目标环境、已做检查与未解决的验证缺口,并在结果依赖当前命令或配置行为时给出所用文档链接。

限制:CLI 参数与配置字段会变化,不要依赖记忆中的示例;若检索不可用,应说明缺口并使用本地证据,而非编造语法。