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

后端应用开发

把工作区后端项目主线发布为不可变版本,并通过 Hosted Service 部署为稳定 API。

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

它不等同于:

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

标准生命周期

项目源码
  -> 主线 HEAD 与 Cargo package.version
  -> Release Operation
  -> 不可变 hosted_service_release
  -> Project Environment
  -> Deployment
  -> 稳定 Endpoint
  -> 健康与业务验证

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

多租户后端需要随 Bundle 生命周期开通租户或解除绑定时,应同时设计供插件管理服务调用的入口。 AI 在生成清单和服务 listener 前,先阅读 业务、管理与插件生命周期入口, 明确业务、人工管理和平台生命周期各自的路由、凭据与权限。

后端应用独立交付

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

继续阅读:

  1. 架构与资源边界
  2. Rust 服务设计约束
  3. 微服务后端开发
  4. Project、Environment、Slot、Endpoint 与数据库
  5. 完整构建与部署链路
  6. 数据库迁移
  7. 环境配置与服务鉴权
  8. 环境日志查询与错误排查
  9. 发布验证与故障排查

本页内容