[控场AI]
· 4 分钟阅读· 2,453 字

Vercel推出仅PR预览构建预设,跳过无PR分支构建

Vercel推出仅PR预览构建预设,跳过无PR分支构建

Vercel 新增预设:仅对有关联开放 PR 的分支构建预览,节省构建资源。

Vercel 为预览部署引入了一项新的 Ignored Build Step 预设「Only build previews for pull requests」,允许团队跳过没有开放拉取请求(PR)的分支的预览构建,从而节省构建资源。该预设会自动填充忽略命令,使项目在分支无关联开放 PR 时跳过预览构建,而生产部署和已有开放 PR 的分支预览构建不受影响。对于 GitHub 和 GitLab 项目,被跳过的预览部署会在消耗任何 Build CPU Minutes 之前取消。启用路径简单:进入 Deployments > Configuration,在 Ignored Build Step 区域选择该预设并保存即可。这项改进将预览构建与代码审查流程对齐,减少不必要的构建消耗和部署列表噪音,尤其适合频繁产生临时分支或接收外部贡献的项目。

Vercel 为预览部署引入了一项新的 Ignored Build Step 预设:「Only build previews for pull requests」。这项功能让团队可以跳过没有开放拉取请求(PR)的分支的预览构建,从而节省构建资源。

功能概览:什么是“仅PR预览构建”预设?

根据 Vercel 官方发布的信息,这个预设会自动填充忽略命令,使项目在以下场景中跳过预览构建:

  • 分支没有关联的开放拉取请求时,不触发预览构建。
  • 生产部署不受影响,始终会构建。
  • 有开放拉取请求的分支,预览构建照常进行。

对于使用 GitHub 和 GitLab 的项目,被跳过的预览部署会在消耗任何 Build CPU Minutes 之前取消。这意味着团队不会为那些“无效”的预览构建付费或消耗额度。

Vercel Ignored Build Step 配置界面

预览部署(Preview Deployment) 是 Vercel 的核心能力之一:每次向 Git 仓库推送代码(非生产分支),Vercel 都会自动构建并部署一个独立的、带唯一 URL 的环境,供团队在合并前查看效果。它通常与 Pull Request 关联,但传统上任何分支推送都会触发。Ignored Build Step 则是 Vercel 提供的一个可配置命令钩子:在构建开始前执行该命令,若其退出码为 0 则跳过构建,非 0 则继续。这个机制让团队可以用脚本自定义“什么情况下不构建”,例如仅当特定文件变更时才构建。新预设本质上就是官方预置了一段忽略命令,根据分支是否关联开放 PR 来决定是否跳过,从而省去手动编写脚本的麻烦。

如何启用:三步配置

启用该预设的操作路径非常直接:

  1. 进入项目的 Deployments > Configuration 页面。
  2. 在 Ignored Build Step 区域,从 Behavior 菜单中选择 Only build previews for pull requests。
  3. 点击 Save 保存设置。

保存后,系统会自动填充忽略命令,无需手动编写脚本。官方文档中提供了更详细的 Ignored Build Step 说明,供需要自定义行为的团队参考。

为什么这个功能值得关注?

在典型的开发工作流中,开发者经常会将分支推送到远程仓库以触发 CI/CD 流程,但并非每次推送都需要预览部署。例如,频繁推送的临时分支、实验性分支或仅用于备份的分支,如果每次都触发预览构建,会浪费构建资源和时间。

Vercel 的这项预设将“预览构建”与“拉取请求”绑定,更贴近现代代码审查流程:只有当你准备合并代码、需要团队评审时,才生成预览环境。这不仅能降低构建成本,也能减少部署列表中的噪音,让团队更聚焦于真正需要评审的变更。

有意思的是,该预设仅影响预览部署,生产部署始终会构建。对于依赖预览环境进行设计评审或 QA 的团队,只要保持 PR 开放,预览构建就不会被跳过。

Build CPU Minutes 是 Vercel 对构建资源消耗的计量单位,指构建过程中占用的 CPU 时间(以分钟计)。不同套餐包含一定的免费额度,超出后按用量计费。预览构建同样消耗 Build CPU Minutes,因此频繁推送临时分支会产生可观成本。该预设的关键在于:对于 GitHub 和 GitLab,Vercel 能在构建启动前通过 API 查询分支是否有关联的开放 PR,若没有则直接取消部署,此时尚未开始消耗 Build CPU Minutes。这区别于构建中途失败或取消——后者可能已产生部分消耗。因此,该预设实现的是“零成本跳过”,而非“构建后丢弃”。

与现有工作流的整合建议

如果你的团队已经在使用 Vercel 的预览部署进行协作,可以结合以下实践:

  • 在 PR 模板中提醒:确保开发者在需要预览时及时打开 PR,而不是仅推送分支。
  • 结合分支保护规则:在 GitHub 或 GitLab 中设置分支保护,要求 PR 才能合并,与 Vercel 的预设形成互补。
  • 监控构建用量:在 Vercel 仪表盘中观察 Build CPU Minutes 的变化,评估预设带来的节省效果。

对于开源项目或频繁接收外部贡献的仓库,这个预设尤其有用:它可以避免为每个 fork 的推送都生成预览,只有真正发起 PR 时才构建,减轻维护者的资源压力。

分支保护规则(Branch Protection Rules) 是 GitHub/GitLab 提供的仓库管理功能,可强制要求合并前必须通过 PR、获得指定数量的审批、通过状态检查等。将 Vercel 的“仅 PR 预览构建”预设与分支保护结合,能形成一致的流程约束:分支保护确保代码变更必须走 PR,而 Vercel 预设确保只有 PR 才生成预览。两者互补,避免开发者绕过 PR 直接推送分支却仍产生预览部署的情况。对于开源项目,还需注意 fork 工作流:外部贡献者通常从 fork 推送分支并发起 PR,该预设能有效阻止为 fork 的每次推送构建预览,仅当 PR 打开后才构建,减轻维护者资源压力。

总结

Vercel 的“仅PR预览构建”预设是一个小而实用的改进,它把预览构建的触发条件与代码审查流程对齐,帮助团队减少不必要的构建消耗。配置简单,无需编写自定义命令,适合大多数使用 GitHub 或 GitLab 的 Vercel 项目。如果你的项目经常产生大量临时分支的预览部署,不妨在 Deployments > Configuration 中尝试开启这个预设。

#Vercel#预览构建#Ignored Build Step#Pull Request#Build CPU Minutes#CI/CD#部署配置
分享:

相关推荐