Cursor Origin ↗ 是 Cursor 的 Git 托管平台。Cloudflare 支持将 Cursor Origin 仓库连接到 Cloudflare Worker。当你向已配置的生产分支推送更改时,Workers Builds 会自动构建并部署 Worker。你也可以启用 Preview 构建,以创建 Previews,而无需将更改部署到生产环境。
除自动构建和部署外,Cloudflare Cursor Origin 集成还会在 Origin 中报告构建活动,让你可以在仓库中跟踪部署,而无需离开仓库。
当提交属于拉取请求时,Cloudflare 会在拉取请求上发布包含构建状态和构建链接的评论。
当 Preview 构建运行 wrangler preview 时,评论还会包含 Preview URL。此 URL 让你可以在 Worker 的隔离副本中测试代码更改。
后续向同一分支推送会更新同一个 Preview URL。每次部署还会获得一个不可变的 Deployment URL,用于测试某一次确切部署。
Cloudflare 会为从仓库触发的每次构建创建 Origin check run。Check runs 显示构建是排队、进行中还是已完成。选择 check run 详情可在 Cloudflare 仪表板中打开该构建。
如果多个 Worker 连接到同一个仓库,例如在 monorepo 中,每次触发的构建会显示为单独的 check run。
当你使用构建监视路径时,Cloudflare 仅会为配置路径触发构建的 Worker 创建 check run。
要为 Cursor Origin 安装 Cloudflare 应用:
- 打开 Cursor 中的 Cloudflare 应用 ↗。
- 选择 Install(安装)。
- 选择 Origin 所有者,并授予对所有仓库或选定仓库的访问权限。
- 按照提示将安装连接到你的 Cloudflare 账户并配置 Worker 构建。
你可以在 Cursor codebase settings ↗ 中管理 Cloudflare 应用。
安装该应用的 Cursor 工作区管理员会选择拥有 Cloudflare 可访问仓库的用户或团队。管理员可以授予对该用户或团队拥有的所有仓库的访问权限,或将访问限制为选定仓库。
Cloudflare 建议仅授予你打算连接到 Workers Builds 的仓库的访问权限。
要更改 Cloudflare 可用的仓库:
- 打开 Cursor codebase settings ↗。
- 选择 Cloudflare 应用。
- 更新安装可以访问的仓库。
从安装中移除仓库会禁用连接到该仓库的 Worker 的新构建。之前的部署会继续在 Cloudflare 上运行。
要从选定 Origin 用户或团队拥有的所有仓库中移除 Cloudflare 访问权限,请从 Cursor codebase settings ↗ 卸载 Cloudflare 应用。
卸载应用会禁用通过该安装连接的每个 Worker 的新构建。之前的部署会继续在 Cloudflare 上运行。
如果你只想停止某一个 Worker 的自动构建,请改为从该 Worker断开 Git 仓库。
如果 Origin 连接无法访问仓库或接收新更改,请重新安装该应用:
- 打开 Cursor codebase settings ↗。
- 选择 Cloudflare 应用并卸载。
- 打开 Cursor 中的 Cloudflare 应用 ↗。
- 选择 Install(安装),选择 Origin 所有者,并授予仓库访问权限。
- 按照提示将安装重新连接到 Cloudflare。
- 重试构建。