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

后端开发

把工作区后端项目构建为不可变制品,并通过 Hosted Service 部署为稳定 API。

后端应用用于承载业务规则、数据处理、外部系统集成和稳定 API。本文所说的后端应用,是从工作区项目构建、以不可变 Artifact 发布、由 Hosted Service 管理环境和部署的独立服务。

它不等同于:

  • 平台应用:面向用户的工作区入口。
  • 运行时模块:安装到 App Runtime、通过模块方法调用的能力包。
  • 平台基础服务:由平台发布系统管理的控制面或运行时基础设施。

标准生命周期

项目源码
  -> 测试和构建
  -> BuildJob
  -> 不可变 Artifact
  -> Hosted Service Environment
  -> Deployment
  -> 稳定 Endpoint
  -> 健康与业务验证

后端应用可以被平台应用、网站、智能体、模块、工作流或外部系统调用。调用方身份、服务 token 和业务用户身份需要分别设计,不能只依赖“知道 URL”作为权限控制。

后端应用独立交付

后端 Artifact 和 Hosted Service Deployment 不进入 Bundle。Bundle 中的模块可以调用 后端 Endpoint;高级 Bundle 的生命周期插件也可以引用已注册的插件服务,但后端发布 状态必须单独验证。

继续阅读:

  1. 架构与资源边界
  2. 构建制品并部署
  3. 环境配置与服务鉴权
  4. 发布验证与故障排查

本页内容