Cloudflare 中文文档
Pages
编辑这个页面
跳转官方原文档
Set theme to dark (⇧+D)

Git 整合指南

在本指南中,你将开始使用 Cloudflare Pages,并通过 Git 集成将你的第一个网站部署到 Pages 平台。

​​ 将 Git 提供商连接到页面

Pages 支持 GitHub GitLab。创建你的第一个 Pages 项目:

  1. 登录 Cloudflare 仪表板 并选择你的账户。
  2. 账户主页 中,选择 **工作者和页面**
  3. 选择 创建应用程序> 页面> 连接到 Git

系统将提示你使用首选的 Git 提供商登录。这将允许 Cloudflare Pages 部署你的项目,并通过 预览部署 更新你的 PR。

​​ 选择你的 GitHub 仓库

你可以从个人账户或已授予 Pages 访问权限的组织中选择一个 GitHub 项目。这样就可以选择一个 GitHub 仓库来使用 Pages 进行部署。私有和公共仓库都支持。

​​ 选择你的 GitLab 仓库

如果使用 GitLab,可以从个人账户或所属的 GitLab 组中选择一个项目。这样就可以选择一个 GitLab 仓库来使用 Pages 进行部署。私人和公共版本库均受支持。

​​ 配置你的部署

选择 Git 仓库后,选择安装与授权开始设置。然后,你可以在设置构建和部署中自定义部署。

你的项目名称将用于生成项目的主机名。默认情况下,该名称与 Git 项目名称一致。

生产分支表示 Cloudflare Pages 部署网站生产版本时应使用的分支。对于大多数项目,这是 mainmaster 分支。所有非生产分支的其他分支将用于 预览部署

设置构建和部署页面,填写项目名称和生产分支](/images/pages/get-started/configuration.png)

​​ 配置你的构建设置

根据你要部署到 Cloudflare Pages 的框架、工具或项目,你需要指定网站的构建命令构建输出目录,以告诉 Cloudflare Pages 如何部署你的网站。此目录中的内容将作为你的网站内容上传到 Cloudflare Pages。

仪表板提供了许多特定于框架的预设。这些预设提供了所选框架的默认构建命令和构建输出目录值。如果不确定本部分的正确值,请参阅 构建配置。如果不需要构建步骤,请将构建命令字段留空。

需要填写的构建设置字段

Cloudflare Pages 从版本库的根目录开始工作。整个构建管道,包括安装步骤,都将从该位置开始。如果你想更改,请通过根目录(高级)> 路径字段指定新的根目录位置。

需要填写的根目录字段

Understanding your build configuration

构建命令由框架提供。例如,Gatsby 框架使用 gatsby build 作为构建命令。在没有框架的情况下工作时,请将构建命令字段留空。

构建命令会生成构建输出目录。每个框架都有自己的命名约定,例如,许多框架的联编输出目录都命名为/public

根目录是网站内容所在的位置。如果未指定,Cloudflare 会假定你链接的 Git 仓库为根目录。在 monorepos 等情况下,一个版本库中可能有多个项目,因此需要指定根目录。

更多信息请参阅 构建配置

​​ 环境变量

环境变量是为构建工作流程提供配置的常用方法。在设置项目时,你可以指定一些键值对作为环境变量。项目首次构建完成后,还可以对这些变量进行进一步自定义。

有关如何设置 Node.js 版本环境变量的详细信息,请参阅 Hexo 框架指南

选择_框架预设_后,如果没有框架,则将该字段留空;配置根目录(高级),并自定义**环境变量(可选)**后,就可以部署了。

​​ Your first deploy

完成构建配置设置后,选择保存并部署。当 Cloudflare 页面安装项目依赖项、构建项目并将其部署到 Cloudflare 全球网络时,你的项目构建日志将输出。

Cloudflare仪表板中的部署详情

项目部署完成后,你将收到一个唯一的 URL,用于查看已部署的网站。

​​ 管理你的网站

首次部署后,选择继续项目,即可在 Cloudflare Pages 控制面板中查看项目配置。在此页面上,你可以看到项目的当前部署状态、生产 URL 和相关提交以及所有过去的部署。

网站仪表板显示你的环境和部署

​​ 删除项目

删除页面项目

  1. 返回账户主页或使用仪表板顶部的下拉菜单。
  2. 选择 工作者和页面
  3. 选择页面项目 > 设置> 删除项目

​​ 高级项目设置

设置部分,你可以配置高级设置,例如更改项目名称、更新 Git 配置或更新构建命令、构建目录或环境变量。

​​ 相关资源