EdgeOne Makers 从入门到精通
附录

§13 CLI 与 CI/CD:把部署写进流水线

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.jsondevCommand千万别在 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 能脚本化的都别手点

部署、环境变量、预览——凡是能敲命令的,都写进脚本和流水线。控制台点一遍很爽,点第十遍就烦了,而且人点容易错。

下一章,我们用定时任务和函数微调,把"自动跑"这件事补上。