跳转到内容
搜索文档

自动拉取请求

最后更新 查看 MarkdownAgent 设置

Workers Builds 可以在你的仓库中自动创建拉取请求,以配置项目或解决部署问题。

配置 PR

当你连接没有 Wrangler 配置文件的仓库时,Workers Builds 会运行 wrangler deploy,从而触发自动项目配置。它不会失败,而是创建一个包含检测到的框架所需配置的拉取请求。

为什么应该合并 PR

如果仓库中没有配置,每次构建都必须先运行 autoconfig,这意味着项目会被构建两次——一次在 autoconfig 期间生成配置,一次用于实际部署。合并 PR 会将配置提交到仓库,因此后续构建会跳过 autoconfig,直接进行构建和部署。这可以加快部署速度,并使设置受版本控制。

PR 包含的内容

Workers Builds 创建的自动配置拉取请求示例

配置 PR 可能包含以下文件的更改,具体取决于你的框架:

  • wrangler.jsonc - 包含 Worker 设置的 Wrangler 配置文件
  • Framework adapter - 框架所需的任何 Cloudflare 适配器(例如 Astro 的 @astrojs/cloudflare
  • Framework configuration - 对框架配置文件的更新(例如 Astro 的 astro.config.mjs 或 SvelteKit 的 svelte.config.js
  • package.json - 新的 deploypreviewcf-typegen 等脚本,以及所需依赖项
  • package-lock.json / yarn.lock / pnpm-lock.yaml - 包含新依赖项的更新锁文件
  • .gitignore - 针对 .wrangler.dev.vars* 文件的条目
  • .assetsignore - 适用于在输出目录中生成 worker 文件的框架

PR 描述

PR 描述包括:

  • 检测到的设置 - 框架、构建命令、部署命令和版本命令
  • 预览链接 - 使用检测到的设置生成的可用预览
  • 后续步骤 - 添加绑定(binding)、自定义域名等的文档链接

名称冲突 PR

如果 Workers Builds 检测到 Cloudflare 仪表板中的 Worker 名称与 Wrangler 配置文件中的 name 字段不匹配,将创建一个拉取请求来修复冲突。

这可能发生在以下情况:

  • 你在仪表板中重命名了 Worker,但未在配置文件中更新
  • 你连接了之前与不同 Worker 一起使用的仓库
  • 配置文件中的 name 字段与连接的 Worker 不匹配

PR 将更新 Wrangler 配置中的 name 字段,以匹配仪表板中的 Worker 名称。

更多详情,请参阅名称冲突更新日志

审查 PR

当你收到 Workers Builds 的 PR 时:

  1. 审查更改 - 检查配置是否符合项目要求
  2. 测试预览 - 使用 PR 描述中的预览链接验证一切正常
  3. 准备就绪后合并 - 满意后合并 PR 以加快部署速度

这篇文档对您有帮助吗?