跳到主要内容

aigne deploy

aigne deploy 命令会将您的 AIGNE 应用程序打包并作为 Blocklet 部署到指定的 Blocklet Server 端点。这是发布您的 Agent 以供生产使用的标准方式，使其可以作为一个独立的、可执行的服务进行访问。

用法

基本用法

bash
aigne deploy --path <path-to-project> --endpoint <deploy-endpoint>

选项

  • --path string (required) — 指定包含 aigne.yaml 文件的 AIGNE 项目目录的路径。
  • --endpoint string (required) — 将要部署应用程序的 Blocklet Server 端点的 URL。

部署流程

deploy 命令会自动执行多个步骤，以正确打包您的 Agent 并将其部署到目标环境。对于一个给定的项目，该流程在首次运行时是交互式的，而在后续更新时则是非交互式的。

部署工作流

d2
direction: down

Developer: {
  shape: c4-person
}

CLI: {
  label: "`aigne deploy`"

  task-1: { label: "1. 准备环境" }
  task-2: { label: "2. 检查 Blocklet CLI" }
  task-3: { label: "3. 配置 Blocklet\n(名称和 DID)" }
  task-4: { label: "4. 打包项目" }
  task-5: { label: "5. 部署到服务器" }

  task-1 -> task-2 -> task-3 -> task-4 -> task-5
}

Blocklet-Server: {
  label: "Blocklet Server"
  icon: "https://www.arcblock.io/image-bin/uploads/eb1cf5d60cd85c42362920c49e3768cb.svg"
}

Deployed-Blocklet: {
  label: "已部署的 Agent\n(作为 Blocklet)"
}

Developer -> CLI: "使用路径和端点运行命令"
CLI.task-5 -> Blocklet-Server: "上传捆绑包"
Blocklet-Server -> Deployed-Blocklet: "托管 Agent"

以下是运行该命令时发生情况的逐步分解：

  1. 环境准备：在您的项目根目录下会创建一个临时的 .deploy 目录。该命令会将您的 Agent 的源文件和标准的 Blocklet 模板复制到此目录中，为打包做准备。
  2. 依赖安装：如果存在 package.json 文件，该命令会在临时目录中运行 npm install 来获取所有必要的依赖项。
  3. Blocklet CLI 检查：该命令会验证 @blocklet/cli 是否已全局安装。如果未安装，系统将提示您自动安装，因为打包和部署 Blocklet 需要它。
  4. 配置（首次部署）：在项目首次部署时，CLI 将引导您完成一个简短的交互式设置：
  • Blocklet 名称：系统将要求您为您的 Blocklet 提供一个名称。它会根据您 aigne.yaml 文件中的 name 字段或项目目录名建议一个默认名称。
  • DID 生成：系统会使用 blocklet create --did-only 为您的 Blocklet 自动生成一个新的去中心化标识符（DID），为其提供一个唯一的、可验证的身份。
  • 此配置（名称和 DID）将保存在本地的 ~/.aigne/deployed.yaml 文件中。对于同一项目的后续部署，将自动使用这些已保存的值，从而使过程变为非交互式。
  1. 打包：CLI 执行 blocklet bundle --create-release 将您所有的应用程序文件打包成一个单一的、可部署的构件。
  2. 部署：最终的捆绑包会使用 blocklet deploy 上传到您指定的 --endpoint。
  3. 清理：成功部署后，临时的 .deploy 目录会被自动删除。

示例

要将在当前目录下的 AIGNE 项目部署到您的 Blocklet Server：

部署项目

bash
aigne deploy --path . --endpoint https://my-node.abtnode.com

如果这是您第一次部署此项目，您将看到一个提示，要求您为 Agent Blocklet 命名：

首次部署提示

text
✔ Prepare deploy environment
✔ Check Blocklet CLI
ℹ Configure Blocklet
? Please input agent blocklet name: › my-awesome-agent
✔ Bundle Blocklet
...
✅ Deploy completed: /path/to/your/project -> https://my-node.abtnode.com

有关设置部署目标和管理已部署 Agent 的更详细演练，请参阅 部署 Agent 指南。