13.1 双命令体系:makers 与 pages
3月前我把 CI 脚本从 edgeone pages deploy 改成 edgeone makers deploy。不是闲得慌,是新产品名(Pages 升级成 Makers)有了新命名空间。
先给结论:现在有两套命令,edgeone makers <command>(推荐)和 edgeone pages <command>(过渡期可用)。两者等价,老命令暂时不会下线,但新功能只在 makers 下提供(比如 edgeone makers create)。
标叔的建议:新项目直接用
makers;存量脚本过渡期内不急着改,但别拖到老命令真下线那天。
13.2 本地开发:init / link / dev
npm install -g edgeone # 装 CLI
edgeone -v # 看版本
edgeone login # 登录,选 Global 或 China
edgeone whoami # 看当前账号
edgeone makers init # 在现有项目初始化,生成 edge-functions/ 等
edgeone makers link # 关联控制台已建的项目,拉环境变量到本地
edgeone makers dev # 本地 8088 端口起服务,热更新调试
警告:
edgeone makers dev默认读edgeone.json的devCommand;千万别在 edgeone.json 或 package.json 里把 dev 命令配成edgeone makers dev,会套娃。dev 服务有启动次数限制,别频繁重启。
13.3 部署:deploy 与多环境
edgeone makers deploy # 生产环境
edgeone makers deploy -e preview # 预览环境
edgeone makers deploy ./dist # 部署本地已构建产物
-e preview 出来的就是 §09 讲过的那个临时预览链接(3 小时有效)。生产部署才进正式域名。
13.4 CI/CD:API Token + deploy
把部署写进流水线,核心就一句:用 API Token 代替登录。
# 生产
edgeone makers deploy -n project-name -t $EDGEONE_API_TOKEN
# 预览
edgeone makers deploy -n project-name -e preview -t $EDGEONE_API_TOKEN
Token 在 Makers 控制台生成。这样你的 GitHub Actions / 任意 CI 推完代码就自动部署,零人工。
| 方式 | 适合 | 标叔的结论 |
|---|---|---|
| Git 推送自动构建 | 大多数项目 | 默认就用它 |
| CLI deploy + Token | CI/CD 流水线 | 要自动化必选 |
| 控制台手动点 | 临时验证 | 能脚本化就别手点 |
13.5 环境变量管理:env ls/pull/set/rm
edgeone makers env ls # 列出控制台所有环境变量
edgeone makers env pull # 拉到本地 .env
edgeone makers env pull -f .env.prod
edgeone makers env set KEY value # 新增/修改
edgeone makers env rm KEY # 删除
标叔的经验
环境变量别写死在代码里(§04 讲过模型网关解耦)。用 env pull 把生产变量拉到本地调试,和线上保持一致,少踩"我本地好的"那种坑。
13.6 能脚本化的都别手点
部署、环境变量、预览——凡是能敲命令的,都写进脚本和流水线。控制台点一遍很爽,点第十遍就烦了,而且人点容易错。
下一章,我们用定时任务和函数微调,把"自动跑"这件事补上。