本文档描述将项目从 Wrangler v1 迁移到 Wrangler v2 的步骤。在更新 Wrangler 版本之前,如果适用于你的项目,请先查看并完成从 Wrangler 版本 1 迁移 webpack 项目。
Wrangler v2 附带新功能和改进,可能需要对配置进行一些更改。
CLI 本身将引导你完成升级过程。
如果你之前使用 npm 全局安装了 Wrangler v1,可以用以下命令卸载:
npm uninstall -g @cloudflare/wrangler如果你使用 Cargo 安装了 Wrangler v1,可以用以下命令卸载:
cargo uninstall wrangler现在,安装最新版本的 Wrangler。
npm install -g wrangler要检查是否安装了正确的 Wrangler 版本,请运行:
npx wrangler --version现在你将测试 Wrangler v2 能否构建你的 Wrangler v1 项目。在大多数情况下,它可以正常构建。如果有错误,命令行会准确指示你需要更改什么才能成功构建。
如果你想了解更多导致 Wrangler v2 报错的已弃用 Wrangler 配置文件 字段,请参阅已弃用。
运行 wrangler dev 命令。这将显示需要处理的任何警告或错误。
请注意,在大多数情况下,消息将包含可操作的说明,告诉你如何解决该问题。
npx wrangler dev- 错误需要在 Wrangler 构建 Worker 之前修复。
- 在大多数情况下,你只会看到警告。 这些不会阻止 Wrangler 构建 Worker,但请考虑更新配置以消除它们。
以下是一些警告和错误的示例:
⛅️ wrangler 2.x
-------------------------------------------------------
▲ [WARNING] Processing wrangler.toml configuration:
- 😶 Ignored: "type":
Most common features now work out of the box with wrangler, including modules, jsx,
typescript, etc. If you need anything more, use a custom build.
- Deprecation: "zone_id":
This is unnecessary since we can deduce this from routes directly.
- Deprecation: "build.upload.format":
The format is inferred automatically from the code.
✘ [ERROR] Processing wrangler.toml configuration:
- Expected "route" to be either a string, or an object with shape { pattern, zone_id | zone_name }, but got "".有关不再支持的内容的更多详情,请参阅已弃用。