帮你快速理解、总结文档立即下载

通过 Cli 部署

最近更新时间:2026-11-13 16:16:03
我的收藏
在 Vibe Coding 场景中,Agent 生成基于 Makers 能力的项目后,可通过 CLI 在沙箱中启动开发环境供用户实时预览,并在效果确认后将项目部署上线。

安装 CLI

如果您使用自建或第三方沙箱,可将 CLI 预装到沙箱镜像中,使 Agent 能够在隔离工作区内直接调用 edgeone 命令完成预览与部署。如果你使用的是 Makers 平台的沙箱,可以跳过这一步,因为它已经预置了 CLI。
说明:
此 CLI 安装包面向 Vibe Coding 沙箱场景进行了精简,主要提供开发环境启动与应用部署能力。
您可以直接下载 CLI 安装包并自行安装,也可以参考示例脚本,在镜像构建阶段完成安装:
COPY scripts/install-edgeone-cli.example.sh /tmp/install-edgeone-cli.sh
RUN bash /tmp/install-edgeone-cli.sh && rm /tmp/install-edgeone-cli.sh
示例脚本会从固定地址下载并解压 CLI 安装包,将文件安装到系统目录,并创建可通过 PATH 直接调用的 edgeone 命令入口。镜像构建完成后,可执行 edgeone --version 验证安装结果。

签发租户 Token

在沙箱环境中使用 CLI 部署时,应避免使用平台级凭证,可在 Agent 运行时签发租户级 Token,供 CLI 启动预览和执行部署时使用。
Typescript
Python
import { Makers } from "@edgeone/makers-sdk";

const platform = new Makers({
token: process.env.MAKERS_API_TOKEN,
region: "china",
});

const { token, tokenId, expired } = await platform.tokens.create({
tenantId: "user-open-id",
name: "user-open-id",
expiresIn: 86400,
});
import os

from makers_sdk import Makers

platform = Makers(
token=os.environ["MAKERS_API_TOKEN"],
region="china",
)

created = platform.tokens.create(
tenant_id="user-open-id",
name="user-open-id",
expires_in=86400,
)

启动预览

Agent 在运行时拼出启动预览的命令字符串,并以参数形式传入租户 Token,再通过沙箱的 commands 工具调用 EdgeOne CLI 启动项目预览。

export function buildMakersDevLaunchCommand(port: number, projectName: string) {
return `edgeone makers dev -t ${token} --port ${port} --skip-env-sync --name ${shellQuote(projectName)}`;
}

执行部署

Agent 在运行时拼出部署的命令字符串,并以参数形式传入租户 Token,再通过沙箱的 commands 工具调用 EdgeOne CLI 执行部署。

function makersDeployLaunch(projectName: string, requestedCommand: string, area = 'global') {
const previewEnvironment = /(?:^|\\s)(?:-e|--environment)(?:\\s+|=)preview(?:\\s|$)/i
.test(requestedCommand);
return [
'edgeone makers deploy',
`-t ${token}`,//租户 token
`-n ${shellQuote(projectName)}`,
'--json',
`--area ${area}`,
previewEnvironment ? '-e preview' : '',
].filter(Boolean).join(' ');
}