开发指南生命周期插件开发
生命周期插件开发
开发、注册和联调生命周期插件服务,并区分当前 v1 协议与 Bundle 顶层预览协议。
生命周期插件用于管理平台资源账本之外的状态,例如开通外部租户、同步托管配置、 停止外部实例或解除 Runtime 绑定。插件服务是独立后端服务:它先部署,再在平台注册完整 执行地址和协议能力,最后由安装或 Runtime 编排链调用。
先选择当前协议
当前生产实现仍是模块生命周期兼容协议 v1,使用 BEFORE_DEPLOY 等 Hook。Bundle 顶层
operationType + stage 协议正在标准化,只是目标模型,不能按预览字段直接开发当前生产插件。
当前开发链路
开发独立插件 Endpoint
-> 按 v1 实现请求与 CModel 响应
-> 部署插件服务
-> 注册插件定义和完整 executeUrl
-> 在模块兼容绑定中引用 pluginId
-> 按 Hook 联调、重试和验证外部状态文档路线
- 当前协议 v1:查看 Hook、请求、响应和当前限制。
- 插件注册与管理:查看注册记录字段、创建、更新和查询语义。
- 开发插件服务:实现 Endpoint、幂等协调、配置输出和敏感信息边界。
- 验证与发布:完成契约、重试、隔离和回归验证。
- Bundle 生命周期协议(预览):了解后续目标模型和迁移边界。
不需要插件的情况
下列需求应由平台标准能力完成,不应为它们增加插件:
- 安装或升级 Bundle 内已发布的模块、平台应用、工作流或定时任务。
- 存储普通模块数据或 Runtime 配置。
- 调用无状态 HTTP API。
- 由用户填写已有租户编号、Endpoint 或凭据。
- 仅为了让模块自动安装。
模块不拥有整个产品的安装、升级和卸载状态机。“模块插件”只表示当前 v1 兼容绑定,不是新的 产品所有权模型。