从 GitHub 页面迁移基于 Jekyll 的网站
在本教程中，你将学习如何将现有的 使用 Jekyll 的 GitHub Pages 网站迁移到 Cloudflare Pages。Jekyll 是与 GitHub Pages 一起使用的最流行的静态网站生成器之一，将 GitHub Pages 网站迁移到 Cloudflare Pages 只需几个简单的步骤。
本教程将为你提供指导：
- 在项目配置中添加 GitHub Pages 使用的必要依赖项。
- 创建一个新的 Cloudflare Pages 站点，与现有的 GitHub 仓库相连。
- 在 Cloudflare 页面上构建和部署网站。
- (可选)迁移自定义域。
包括构建时间在内，本教程应在 15 分钟内完成。
开始之前
本教程假设
- 你已有一个使用 Jekyll 的 GitHub Pages 网站。
- 你对运行 Ruby 命令行工具有一定的了解，并且安装了
gem和bundle。 - 知道如何使用一些基本的 Git 操作，包括 “添加”、“提交”、“推送 “和 “拉取”。
- 你已阅读 Cloudflare 页面的 入门 指南。
如果你的机器上没有安装 Rubygems (gem) 或 Bundler (bundle) ，请参阅
Rubygems 和
Bundler 的安装指南。
准备 GitHub Pages 仓库
你现有的基于 Jekyll 的版本库必须指定一个 “Gemfile”(Ruby 的依赖关系配置文件)，以便 Cloudflare Pages 在 构建步骤 期间获取并安装这些依赖关系。
具体来说，你需要创建一个 Gemfile并安装 github-pagesgem，其中包括 GitHub Pages 环境假定的所有依赖项。
打开为你创建的 Gemfile，在文件底部添加以下一行：
你的 Gemfile应与下相似：
运行 bundle update，它会为你安装 github-pagesgem，并创建一个包含已解决依赖版本的 Gemfile.lock 文件。
应该可以成功完成。如果没有，请检查是否准确复制了上面的 github-pages 行，并且没有注释掉前面的 #。
现在，你需要将这些文件提交到你的版本库，以便 Cloudflare Pages 在以下步骤中引用它们：
配置页面项目
现在，你的 GitHub Pages 项目已明确指定其依赖关系，你可以开始配置 Cloudflare Pages 了。此过程与 部署 Jekyll 网站 几乎相同。
将网站部署到页面：
- 登录 Cloudflare 仪表板 并选择你的账户。
- 在账户主页，选择 工作者和页面> 创建应用程序> 页面> 连接到 Git。
- 选择创建的新 GitHub 仓库，并在 “设置构建和部署“部分提供以下信息：
| 配置选项 | 值 |
|---|---|
| 生产分支 | main |
| 生成命令 | jekyll build |
| 构建目录 | _site |
配置好网站后，即可开始首次部署。在部署之前，你应该看到 Cloudflare 页面正在安装jekyll、项目依赖项并构建网站。
部署网站后，你将在 *.pages.dev上为你的项目获得一个唯一的子域。每次你向 Jekyll 网站提交新代码时，Cloudflare Pages 都会自动重建你的项目并进行部署。你还将在新的拉取请求中访问 预览部署，这样你就可以在将更改部署到生产环境之前预览网站的外观。
迁移自定义域名
如果你使用的是
带有 GitHub Pages 的自定义域名，你必须更新 DNS 记录以指向新的 Cloudflare Pages 部署。这需要你更新域名 DNS 提供商的 CNAME 记录，使其指向 <your-pages-site>.pages.dev，替换 <your-username>.github.io。
请注意，DNS 缓存过期和反映此更改可能需要一些时间，这取决于你最初创建记录时设置的 DNS TTL(生存时间)值。
详细步骤请参阅入门指南中的 添加自定义域 部分。
下一步是什么？
- 了解如何使用 Cloudflare Workers 为你的 Pages 站点自定义 HTTP 响应头。
- 了解如何 回滚可能已损坏的部署 到以前的工作版本。
- 配置重定向，这样访问者就会被引导到你的 “规范 “自定义域。