用途
EdgeOne Makers Deployment Skill 用于将任意项目部署到 EdgeOne Makers(腾讯 EdgeOne)。当任务中包含部署环节时触发该技能,覆盖前端与全栈项目的部署需求。
主要能力
- 通过 edgeone CLI 完成部署,支持已链接项目(存在 edgeone.json)与新项目(首次部署自动创建 edgeone.json)。
- 支持浏览器登录与 Token 登录两种认证方式。
- 在 CLI 版本满足要求时支持匿名部署与认领(claim)流程。
- 非交互场景下可通过 --json 获取机器可读的部署结果。
- 部署结果会生成带鉴权查询参数(?eo_token=...&eo_time=...)的访问 URL。
使用方式
环境准备:在执行任何 edgeone CLI 命令前,需在当前 shell 会话设置环境变量:
export PAGES_SOURCE=skills
或以行内方式前缀:
PAGES_SOURCE=skills edgeone makers deploy
安装 CLI:
npm install -g edgeone@latest
版本要求:CLI 版本需 ≥ 1.6.0;匿名部署与认领需要 ≥ 1.6.29。低于 1.6.0 的版本在非交互环境中会挂起且缺少 --json。
登录检查:
edgeone whoami
退出码 0 表示已登录,无需 -t;退出码 1 表示未登录。注意 whoami 不支持 -t 参数。
浏览器登录(默认方式):
edgeone login --site china edgeone login --site global
需先让用户选择中国站或全球站,并始终显式传入 --site。
Token 登录:
edgeone login --token <token>
自动识别站点,无需 --site。也可在部署时单次传入:
edgeone makers deploy -t <token>
部署命令:
已链接项目
edgeone makers deploy
新项目
edgeone makers deploy -n <project-name>
适用场景
- 需要将前端或全栈项目部署到 EdgeOne Makers 并获取访问链接。
- 在 Agent / CI / 无头环境中进行非交互式部署。
- 需要匿名部署并后续认领项目的场景。
限制与注意事项
- 部署 URL 必须完整保留查询参数,截断会导致页面返回 401。
- 匿名部署与认领要求 CLI ≥ 1.6.29。
- 认领命令参数为 --sid,而非 --token。
- 浏览器登录可能因复用旧会话而绑定到错误账号,需引导用户切换账号或先登出。
- Token 具有账号级权限,不应提交到代码仓库。
- 匿名部署的认领窗口为 60 分钟。
- 关于自定义域名、ICP 备案、DNS 等细节,资料未提供具体说明。