SuperAPI AI 工具集

astrofy-cloudflare-deploy

部署与运维

查看项目

更新于 10-17 02:22

技能介绍

用途:该技能围绕 Cloudflare 发布与运维命令的定义和校验,要求先读取 cloudflare.config.ts 或 wrangler.jsonc、package.json 脚本、所采用的模式、绑定名称、CI 环境以及上一次发布标识,并在组装命令前确认由 astrofy-cloudflare 指定的路径。

主要能力:按路径组装脚本。cf 路径包含 cf dev、cf build、cf deploy 和 cf previews deploy;Wrangler 路径为 astro build 后接 wrangler deploy。cf build 不会执行 package.json 中的 build 脚本,额外步骤需以链式方式加入,例如 tsc -b && cf build。模式处理方面,未指定 --mode 时 Vite 插件在 dev 使用 development、在 build 使用 production;prebuilt 构建必须与构建时模式一致,cf build 生成 production,因此 cf deploy --prebuilt --mode production 才会发布该构建。

验证方式:发布前可用 cf deploy --dry-run 查看 Worker 与绑定,不向 API 发送请求也不要求凭据;cf workers check 可测量 bundle 大小与本地环境的启动时间。在 CI 中应使用 CLOUDFLARE_API_TOKEN 和 CLOUDFLARE_ACCOUNT_ID,每次执行只做一次构建,并用 --prebuilt 发布已核对的内容;可通过 CF_SEND_TELEMETRY=false 关闭遥测。

使用约束:仅在获得明确授权后发布。发布后记录版本标识并保留上一版本以便恢复,检查公开 URL、一条动态路由、一个静态资源和 404。密钥使用 --secrets-file 指向未纳入版本控制的文件,只记录绑定名称而不记录值。发布命令应与通过 dry-run 的命令一致,模式需记录在 Build Output 中;报告需说明环境、模式、版本及已测试路由。可通过 astrofy check --rule quality.build 做质量校验。

适用场景:面向 Astro 项目在 Cloudflare 上的部署流程规范化,尤其是需要区分 cf 与 Wrangler 路径、管理 prebuilt 发布模式和 CI 凭据的团队。限制:资料未提供具体平台支持范围、收费信息或完整配置细节。