Pages构建和路由指南

优势

• 基础设施即代码 ：配置与您的代码一同被版本控制，每一次变更都有迹可循。

• 易于团队协作： 团队所有成员共享同一份配置文件，确保了本地开发和云端部署的一致性。

• 便捷回滚：任何时候都可以回滚到历史上的任意一次提交，并精确复现当时的构建环境。

生效优先级

esa.jsonc 文件中的配置优先级大于控制台界面上的配置：

• 如果您的项目中没有 esa.jsonc 文件：

  • 您可以在项目的详情页面参考如何通过控制台修改基础配置信息调整相关构建选项。

  • 控制台的配置将作为本次及后续部署的依据。

• 如果您的项目中存在 esa.jsonc 文件：

  • 系统会自动检测到该文件，并将其作为配置的唯一来源。

  • 在项目的详情页面，所有被 esa.jsonc 管理的配置项将不生效。

  • 如需修改配置，必须直接编辑 esa.jsonc 文件，并将更改推送到您的 Github 仓库。

配置示例

在Github中对应的Pages仓库中新增esa.jsonc文件，配置示例可参考：

{
  "name": "vite-react-template",’
  "entry": "./src/index.js",
  "installCommand": "npm install",
  "buildCommand": "npm run build",
  "assets": {
    "directory": "./dist",
    "notFoundStrategy": "singlePageApplication"
  }
}

默认模式

当在esa.jsonc中未配置notFoundStrategy字段时，如：

{
  "name": "vite-react-template",
  "entry": "./src/index.js",
  "assets": {
    "directory": "./dist"
  }
}

ESA将根据下述流程进行路由：

1. 客户端请求URL到达边缘节点时，将会判断是否有对应的静态资源：若有，则直接响应对应静态文件；若无，则继续判断2。

2. 判断是否有ER函数脚本：若有，则执行ER函数脚本；若无，则响应404 Not Found。

单页应用

当您构建的应用为单页应用类型，可以在esa.jsonc中配置notFoundStrategy字段为 singlePageApplication 模式，如：

{
  "name": "vite-react-template",
  "entry": "./src/index.js",
  "assets": {
    "directory": "./dist",
    "notFoundStrategy": "singlePageApplication"
  }
}

ESA将根据下述流程进行路由：

1. 客户端请求URL到达边缘节点时，将会判断是否有对应的静态资源：若有，则直接响应对应静态文件；若无，则继续判断2。

2. 判断是否为导航请求（请求头携带Sec-Fetch-Mode: navigate）：若否，则继续判断3；若是，则将请求路由至/index.html文件，继续判断a：

   1. 判断是否存在index HTML页面：若有，则响应200 OK并且返回/index.html内容；若无，则继续判断3。

3. 判断是否有ER函数脚本：若有，则执行ER函数脚本；若无，则响应404 Not Found。

静态站点生成

当您构建的应用为静态站点生成类型，可以在esa.jsonc中配置notFoundStrategy字段为 404Page 模式，如：

{
  "name": "vite-react-template",
  "entry": "./src/index.js",
  "assets": {
    "directory": "./dist",
    "notFoundStrategy": "404Page"
  }
}

ESA将根据下述流程进行路由：

1. 客户端请求URL到达边缘节点时，将会判断是否有对应的静态资源：若有，则直接响应对应静态文件；若无，则继续判断2。

2. 判断是否为导航请求（请求头携带Sec-Fetch-Mode: navigate）：若否，则继续判断3；若是，则将请求路由至/404.html文件，继续判断a：

   1. 判断是否存在404 HTML页面：若有，则响应200 OK并且返回/404.html内容；若无，则继续判断3。

3. 判断是否有ER函数脚本：若有，则执行ER函数脚本；若无，则响应404 Not Found。