Gatsby
Gatsby是一个用于创建网站和应用程序的开源 React 框架。在本指南中,你将创建一个新的 Gatsby 应用程序,并使用 Cloudflare Pages 进行部署。你将使用 gatsby
CLI 创建一个新的 Gatsby 站点。
安装Gatsby
在终端运行以下命令,安装 gatsby
CLI:
创建一个新项目
安装了 Gatsby 后,你可以使用 gatsby new
创建一个新项目。new
命令接受一个 GitHub URL 以使用现有模板。例如,在终端运行以下命令,使用 gatsby-starter-lumen
模板。你可以在
Gatsby 的启动器部分 找到更多信息:
在你继续之前
所有框架指南都假定你已经对 Git 有了基本了解。如果你是 Git 的新手,请参考这本 Git 手册摘要,了解如何在本地机器上设置 Git。
如果使用 SSH 克隆,则必须在每台用于从 GitHub 推送或拉取的计算机上 生成 SSH 密钥。
创建 GitHub 仓库
访问 repo.new,创建一个新的 GitHub 仓库。创建新仓库后,进入新创建的项目目录,准备并在终端运行以下命令将本地应用程序推送到 GitHub:
使用 Cloudflare 页面部署
将网站部署到页面:
- 登录 Cloudflare 仪表板 并选择你的账户。
- 在账户主页,选择 工作者和页面> 创建应用程序> 页面> 连接到 Git。
- 选择创建的新 GitHub 仓库,并在
**设置构建和部署**
部分提供以下信息:
Configuration option | Value |
---|---|
Production branch | main |
Build command | npx gatsby build |
Build directory | public |
配置好网站后,你就可以开始第一次部署了。在部署之前,你应该会看到 Cloudflare 页面正在安装 gatsby
、项目依赖项并构建网站。
部署网站后,你将在 *.pages.dev
上为你的项目收到一个唯一的子域。
每次你向 Gatsby 站点提交新代码时,Cloudflare Pages 都会自动重建你的项目并进行部署。你还可以访问新拉取请求上的 预览部署,这样你就可以在将更改部署到生产环境之前预览网站的外观。
动态路由
如果在 Gatsby 项目中使用 dynamic routes,请设置 proxy redirect,以使这些路由生效。
如果你有动态路由,如 /users/[id]
,请参照以下示例创建代理重定向:
了解更多
完成本指南后,你已成功将 Gatsby 网站部署到 Cloudflare Pages。要开始使用其他框架,请参阅框架指南列表