百积木文档
开发指南生命周期插件开发

生命周期插件开发

开发、注册和联调生命周期插件服务,并区分当前 v1 协议与 Bundle 顶层预览协议。

生命周期插件用于管理平台资源账本之外的状态,例如开通外部租户、同步托管配置、 停止外部实例或解除 Runtime 绑定。插件服务是独立后端服务:它先部署,再在平台注册完整 执行地址和协议能力,最后由安装或 Runtime 编排链调用。

先选择当前协议

当前生产实现仍是模块生命周期兼容协议 v1,使用 BEFORE_DEPLOY 等 Hook。Bundle 顶层 operationType + stage 协议正在标准化,只是目标模型,不能按预览字段直接开发当前生产插件。

当前开发链路

开发独立插件 Endpoint
  -> 按 v1 实现请求与 CModel 响应
  -> 部署插件服务
  -> 注册插件定义和完整 executeUrl
  -> 在模块兼容绑定中引用 pluginId
  -> 按 Hook 联调、重试和验证外部状态

文档路线

  1. 当前协议 v1:查看 Hook、请求、响应和当前限制。
  2. 插件注册与管理:查看注册记录字段、创建、更新和查询语义。
  3. 开发插件服务:实现 Endpoint、幂等协调、配置输出和敏感信息边界。
  4. 验证与发布:完成契约、重试、隔离和回归验证。
  5. Bundle 生命周期协议(预览):了解后续目标模型和迁移边界。

不需要插件的情况

下列需求应由平台标准能力完成,不应为它们增加插件:

  • 安装或升级 Bundle 内已发布的模块、平台应用、工作流或定时任务。
  • 存储普通模块数据或 Runtime 配置。
  • 调用无状态 HTTP API。
  • 由用户填写已有租户编号、Endpoint 或凭据。
  • 仅为了让模块自动安装。

模块不拥有整个产品的安装、升级和卸载状态机。“模块插件”只表示当前 v1 兼容绑定,不是新的 产品所有权模型。

本页内容