边缘安全加速平台 EO 构建指南

本章将介绍 Makers 部署的构建步骤及其工作原理。在创建项目时,使用预设模板的情况下,Makers 将采用模板的默认配置进行构建;而对于导入的 GitHub 仓库,Makers 会自动识别所使用的框架,并应用最常。

相关产品
边缘安全加速平台 EO 产品页,含版本规格、价格与购买入口。

如果你需要特定的设置,可以在创建新项目时或在项目设置中自定义根目录、构建命令和输出目录等参数。

你可以通过两种方式启动 Makers 部署:

·将代码变更推送到 GitHub。

·在控制台里面启动重新部署。

一、构建设置

你可以从项目设置 > 构建部署配置指定 Makers 如何构建你的项目。

二、框架预设

通过下拉菜单选择预设的框架,可以快速填充各个配置项。选择框架后,你仍然可以继续调整其他配置。

三、根目录

根目录是执行构建命令的路径,如果未设置,默认为存储库的根目录 ./。

四、输出目录

输出目录是存放构建产物(例如 HTML 文件和静态资源)的路径。该目录相对于根目录,默认为 root ( / )。你可以通过 构建指南 查询不同框架对应的输出目录。

五、构建命令

Makers 会根据所选框架自动设置构建命令,例如 npm run build。构建命令将在 Bash shell 中运行,你也可以添加与 Bash 兼容的语法。

有关不同框架对应的构建命令,请参见 构建指南 。

六、安装命令

Makers 在构建时会自动检测安装命令,从 package.json 安装依赖项。默认为 npm install。

目前支持的包管理器如下:

包管理器 Lock 文件 安装命令 支持版本
Yarn yarn.lock yarn install 1
npm package-lock.json npm install 8、9、10
pnpm pnpm-lock.yaml pnpm install 6、7、8、9、10、11

七、Node 版本

Makers 预装了 14.21.3、16.20.2、18.20.4、20.18.0、22.11.0、22.17.1、22.21.1、24.5.0、24.11.0、24.18.0 几个 Node 版本,你可以在项目设置 > Node.js 版本进行选择。

注意:预装的 Node 版本里提供 pnpm、yarn、bun 等包管理器,若项目根目录里有 .nvmrc 会自动下载并切换至指定版本,但不包含相应的包管理器。

八、环境管理

Makers 为每个项目默认提供生产和预览两个部署环境,二者均不可删除,各自拥有独立的关联分支、域名和环境变量。你可以在项目设置 > 环境管理中查看和管理这两个环境。

·生产:关联生产分支(例如 main),通过该分支触发的部署将作为生产环境,更新至用户访问的线上网站。

·预览:关联所有未分配到其他环境的 Git 分支,通过这些分支触发的部署将作为预览环境,便于预览新功能、修复 bug 或进行其他测试。

点击环境操作列的编辑,可配置以下内容:

·环境名称、关联分支:生产、预览为系统环境,二者的名称与关联分支固定,不支持修改。

·域名:为该环境绑定的访问域名。

·自动部署:开启后,每次符合条件的代码提交合并都会新建一个部署。

·环境变量:查看并编辑对该环境生效的环境变量。若某个变量同时对其他环境生效,修改和删除该环境变量会影响其他环境。更多说明详见下文 环境变量。

九、环境变量

Makers 支持使用环境变量来构建你的项目。每个环境变量可设置变量名、变量值、备注,以及生效范围。

如需批量导入环境变量,可以将 .env 文件中的所有环境变量粘贴至变量名的输入框内,Makers 会自动识别。

赞 (0)
上一篇 4天前
下一篇 4天前