PuppyIP 资源中心
开发工具与网络 5 分钟 发布于 2026-11-18

Cloudflare CLI 1.0 RC 怎么从 beta 升级?构建产物与脚本检查

从 Cloudflare CLI beta 试用 1.0.0-rc.1 时,先核对构建依赖和流水线。新版 Build Output 放到 .cloudflare/output/v1/,使用 Vite 和旧版 Wrangler 构建的项目各有最低依赖要求。候选版适合在隔离项目验证,正式发布仍需按项目规则审批。

Cloudflare CLI Build Output Wrangler Vite CI

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • Cloudflare 于 2026 年 11 月 17 日发布的 1.0.0-rc.1 是候选版。部分自动生成的 API 命令在 1.0 前仍可能变化。
  • Vite 构建需要 @cloudflare/vite-plugin 2.0.0-rc.0 或更新版本。由 Wrangler 构建的旧项目需要 Wrangler 4.163.0 或更新版本。
  • 较早 beta 的调用脚本要核对预览名参数和输出流。命令结果在 stdout,提示和进度在 stderr。

本次候选版适合谁试用?

这次升级主要影响已经使用 cf beta 的团队,尤其是把构建和部署分成两个流水线步骤的 Workers 项目。先在隔离分支记录当前 CLI、Node.js 和项目依赖的版本,再用 1.0.0-rc.1 验证。候选版公告列出预计稳定的配置格式与常用命令,部分低频 API 命令仍可能调整。

如果项目当前直接使用 Wrangler,先确认团队确实计划试用 cf。公告对旧项目的 Wrangler 最低版本要求,适用于交由 cf 调用 Wrangler 构建的路径。

构建产物目录和依赖要改哪里?

新的 Build Output 目录是 .cloudflare/output/v1/。官方说明 cf deploy 首次运行时会在新路径生成构建结果。升级前检查 CI 的缓存、上传产物和后续读取步骤,确认它们使用同一套目录和依赖。

先识别项目实际使用的构建器,再核最低版本。Vite 项目使用 @cloudflare/vite-plugin 2.0.0-rc.0 或更新版本。通过 Wrangler 构建的旧项目使用 Wrangler 4.163.0 或更新版本。锁定本次验证的依赖组合,方便复现和回退。

旧脚本为什么会读错输出或参数?

从较早 beta 升级时,先确认脚本把 stdout 当作命令结果,把 stderr 当作提示、进度和状态消息。假设脚本把 stdout 交给 JSON 解析器,同时要收集进度,应该分别保存两路输出,避免合在一起后解析失败。

预览名现在通过 --preview-name 传入 cf previews deploy。检查自动生成的命令名及参数,公告说明部分重命名没有保留别名。先用当前版本的帮助核对实际调用,再改脚本。

升到候选版后怎么验证和回退?

从可重复的本地构建开始,确认产物生成在 v1 目录,再检查会读取它的流水线步骤。在获准的测试环境核对目标账号、预览名、输出解析与退出状态。安排正式切换前记录旧的 CLI、锁文件和可用产物版本。

需要了解部署会改变什么时,可按官方说明查看 cf deploy --dry-run 预览。预览结果用于审核,正式切换仍需按目标环境的实际变更流程验证。

资料来源

常见问题

直接把老的 Build Output 目录改名为 v1 可以吗?

v1 是构建产物格式版本。升级对应依赖并重新生成产物,再让后续步骤读取 v1 目录。仅改目录名不能验证内部格式。

只改 CLI 版本,就能保留原来 beta 的生成命令名吗?

不能保证。官方说明候选版重命名了部分生成命令且没有别名。按项目使用的命令逐步核对当前帮助和发布记录。