百积木文档
开发指南后端开发

构建制品并部署

从后端项目创建 BuildJob、取得 Artifact,并部署到 Hosted Service 环境。

具体参数以本机 CLI 和当前平台版本为准。开始前先发现可用命令:

baijimu --version
baijimu rust-build --help
baijimu hosted-service --help

准备项目

构建前确认:

  • 项目属于目标工作区。
  • 测试、构建命令和最终二进制路径明确。
  • 项目在平台构建环境中能够完成依赖安装、测试和构建。
  • 密钥和环境配置没有写入源码。

创建并等待 BuildJob

baijimu rust-build job create <workspaceId> <projectId> \
  --test-command '<testCommand>' \
  --build-command '<buildCommand>' \
  --binary-path '<binaryPath>'

调用成功只表示构建任务已经创建。使用返回的真实 buildJobId 查询状态:

baijimu rust-build job get <workspaceId> <buildJobId>

只有 BuildJob 成功并返回可用 artifactId 后才能部署。构建失败时读取错误与日志,修复源码后创建新的 BuildJob。

创建 Hosted Service 和环境

baijimu hosted-service create <workspaceId> \
  --service-key <serviceKey> \
  --name <name> \
  --source-project-id <projectId>

baijimu hosted-service env create <workspaceId> \
  --hosted-service-id <hostedServiceId> \
  --name <environmentName>

使用平台返回的真实 hostedServiceIdenvironmentId。不要把展示名或列表第一项当作资源 ID。

部署 Artifact

baijimu hosted-service project deploy-artifact <workspaceId> <projectId> \
  --environment-id <environmentId> \
  --artifact-id <artifactId>

部署请求返回后继续查询部署记录:

baijimu hosted-service project deployments <workspaceId> <projectId> \
  --environment-id <environmentId>

只有 deployment 进入成功运行状态、Endpoint 健康且真实业务请求通过,发布才算完成。

BuildJob 不是 Artifact

buildJobId 只能查询构建过程;部署必须使用构建成功后产生的 artifactId

本页内容