Workers Builds 可以在你的仓库中自动创建拉取请求,以配置项目或解决部署问题。
当你连接没有 Wrangler 配置文件的仓库时,Workers Builds 会运行 wrangler deploy,从而触发自动项目配置。它不会失败,而是创建一个包含检测到的框架所需配置的拉取请求。
如果仓库中没有配置,每次构建都必须先运行 autoconfig,这意味着项目会被构建两次——一次在 autoconfig 期间生成配置,一次用于实际部署。合并 PR 会将配置提交到仓库,因此后续构建会跳过 autoconfig,直接进行构建和部署。这可以加快部署速度,并使设置受版本控制。
配置 PR 可能包含以下文件的更改,具体取决于你的框架:
wrangler.jsonc- 包含 Worker 设置的 Wrangler 配置文件- Framework adapter - 框架所需的任何 Cloudflare 适配器(例如 Astro 的
@astrojs/cloudflare) - Framework configuration - 对框架配置文件的更新(例如 Astro 的
astro.config.mjs或 SvelteKit 的svelte.config.js) package.json- 新的deploy、preview和cf-typegen等脚本,以及所需依赖项package-lock.json/yarn.lock/pnpm-lock.yaml- 包含新依赖项的更新锁文件.gitignore- 针对.wrangler和.dev.vars*文件的条目.assetsignore- 适用于在输出目录中生成 worker 文件的框架
PR 描述包括:
- 检测到的设置 - 框架、构建命令、部署命令和版本命令
- 预览链接 - 使用检测到的设置生成的可用预览
- 后续步骤 - 添加绑定(binding)、自定义域名等的文档链接
如果 Workers Builds 检测到 Cloudflare 仪表板中的 Worker 名称与 Wrangler 配置文件中的 name 字段不匹配,将创建一个拉取请求来修复冲突。
这可能发生在以下情况:
- 你在仪表板中重命名了 Worker,但未在配置文件中更新
- 你连接了之前与不同 Worker 一起使用的仓库
- 配置文件中的
name字段与连接的 Worker 不匹配
PR 将更新 Wrangler 配置中的 name 字段,以匹配仪表板中的 Worker 名称。
更多详情,请参阅名称冲突更新日志。
当你收到 Workers Builds 的 PR 时:
- 审查更改 - 检查配置是否符合项目要求
- 测试预览 - 使用 PR 描述中的预览链接验证一切正常
- 准备就绪后合并 - 满意后合并 PR 以加快部署速度