你可以将每个 Cloudflare Pages 项目连接到 GitLab 仓库,Cloudflare 会在你每次向分支推送更改时自动部署代码。
除自动部署外,Cloudflare GitLab 集成还允许你在 GitLab 中直接监控、管理和预览部署,无需离开工作流程即可掌握状态。
Pages 默认将你首次推送的分支设为生产环境。若默认分支(例如 main)以外的分支代表项目的生产分支,请前往 Settings(设置) > Builds(构建) > Branch control(分支控制),点击 Production branch(生产分支) 下拉菜单并选择其他分支来更改生产分支。
你还可以使用预览部署在合并生产分支并部署到生产环境之前预览项目版本。Pages 允许你使用分支构建控制配置哪些预览分支自动部署。要配置,请前往 Settings(设置) > Builds(构建) > Branch control(分支控制),并在 Preview branch(预览分支) 下选择选项。使用 Custom branches(自定义分支) 指定要包含或排除在自动预览部署之外的分支。
无需任何配置,你可以选择临时跳过部署。在提交消息中添加 [CI Skip]、[CI-Skip]、[Skip CI]、[Skip-CI] 或 [CF-Pages-Skip] 前缀,Pages 将跳过该次部署。前缀不区分大小写。
若一个或多个项目连接到同一仓库(即 monorepo),你可以通过 GitLab 提交状态 ↗在 GitLab 中查看每次构建的状态。
你可以在 GitLab 仓库中选择提交旁的状态图标,或前往 Build(构建) > Pipelines(流水线) 查看状态。在以下示例中,你可以选择绿色勾选标记查看检查运行结果。
检查运行在你的仓库中显示如下。你可以选择其中一个状态查看该部署的预览 URL。
若构建因任何原因被跳过(例如 CI Skip、构建监视路径或分支部署控制),检查运行/提交状态将不会出现。
你可以使用 Cloudflare Pages 应用从公司或个人 GitLab 项目部署 Cloudflare Workers 项目。
你可以从 GitHub 和 GitLab 上的公司或个人项目部署 Cloudflare Pages 项目。
授权 Cloudflare Pages 访问 GitLab 账户时,你自动授予 Cloudflare Pages 访问 GitLab 账户可访问的组织、组和命名空间的权限。这些组织和组的访问管理由 GitLab 处理。
你可以前往 GitLab 的 Authorized Applications(已授权应用)页面 ↗移除 Cloudflare Workers 对 GitLab 账户的访问。找到名为 Cloudflare Workers 的应用并选择 Revoke(撤销) 按钮撤销访问。
请注意,GitLab 应用 Cloudflare Workers 在 Workers 和 Pages 项目之间共享,移除对 GitLab 的访问将禁用 Workers 和 Pages 的新构建,但之前的部署仍由 Cloudflare Pages 托管。
遇到 Git 集成相关问题时,一种排查步骤是尝试卸载并重新安装与 Cloudflare Pages 安装关联的 GitHub 或 GitLab 应用。
- 前往 GitLab 上的应用设置页面:https://gitlab.com/-/profile/applications ↗
- 若存在 Cloudflare Pages 安装,选择 Revoke(撤销) 按钮。
- 返回 Workers & Pages 概览页面
https://dash.cloudflare.com/[YOUR_ACCOUNT_ID]/workers-and-pages。选择 Create application(创建应用程序) > Pages > Connect to Git(连接到 Git)。 - 选择顶部的 GitLab 选项卡,选择 + Add account(+ 添加账户) 按钮,选择要添加的 GitLab 账户,然后在标题为「Authorize Cloudflare Pages to use your account?(授权 Cloudflare Pages 使用你的账户?)」的模态框中选择 Authorize(授权)。
- 你将被重定向到创建项目页面,账户列表中包含你的 GitLab 账户或组织。
- 尝试为之前失败的项目进行新部署。