将 Git 仓库连接到 Worker 后,在生产分支上的提交会生成生产构建。要为非生产分支创建 Previews,以及(对于 GitHub 和 GitLab 仓库)拉取请求评论,请启用 Preview 构建。
要更改项目的生产分支:
- 在 Overview(概览) 中,选择你的 Worker 项目。
- 前往 Settings(设置) > Build > Branch control。Worker 默认使用 Git 仓库的默认分支,但可以在下拉菜单中更改。
对此分支的每次推送事件都会触发构建,并执行构建命令,随后执行部署命令。
Preview 构建是针对非生产分支的构建。
新 Worker 默认对 Preview 构建使用 Worker Previews。其 Preview command(预览命令)为 npx wrangler preview。
要启用或禁用 Preview 构建:
- 在 Overview(概览) 中,选择你的 Worker 项目。
- 前往 Settings(设置) > Build > Branch control。Enable Preview Builds 复选框允许你启用或禁用 Preview Builds。
启用后,对非生产分支的每次推送都会触发 Preview 构建。Workers Builds 会运行构建命令,随后运行 Preview command(预览命令)。
在 Worker Previews 之前连接到 Builds 的 Worker 会保留之前的预览模型,直到你完成一次性切换。
-
在 Cloudflare 仪表板中,前往 Workers & Pages > 你的 Worker > Settings(设置) > Builds(构建)。在 Set up Worker Previews 横幅中,选择 Set up(设置)。
前往 Workers & Pages ↗
-
配置 Worker 的 Previews 所需的变量、密钥和绑定(binding)。Previews 不使用生产设置。有关说明,请参阅快速入门。
-
检查新的 Preview command(预览命令)。Workers Builds 会将当前命令替换为
npx wrangler preview。自定义命令必须调用npx wrangler preview。 -
选择 Switch to Worker Previews(切换到 Worker Previews)。
切换后,向非生产分支的推送会使用 Worker Previews。