百积木文档
开发指南平台应用、模块与 Bundle 开发

交付完整性与验收证据

在发布验收中关联精确 Bundle、后端制品、部署、插件协议与真实业务证据,保留独立安装边界。

Bundle 是业务资源定义的版本化交付单元。前端构建、独立后端程序、插件进程、数据库和第三方账号有各自的 所有者与生命周期。一个完整 Bundle JSON 不代表目标环境已经部署所有程序或配置所有业务入口。

交付闭包由谁证明

内容权威来源发布时记录什么
Bundle 与本包资源Bundle 精确版本、源码项目与各资源 Owner来源环境、Bundle 身份和精确版本、源码提交、完整资源及精确版本
编译期类型Module 不可变版本内闭合的类型合同所消费的精确 Type Definition 合同;不生成 Bundle 安装依赖
前端和后端项目版本、BuildJob、Artifact、站点或 Hosted Service 部署项目、精确程序版本、源码提交、制品身份、目标环境与成功部署记录
生命周期插件插件目录与提供方程序版本稳定 pluginId、生命周期和引用协议、精确程序版本及已验证入口;不记录凭据
平台能力目标平台登记的资源 Owner、内容与执行协议本包实际需要的资源类型和合同,以及目标环境的执行验证证据
外部服务与绑定Module 显式属性配置、第三方账号与业务授权必要配置项名称、绑定目的、配置责任人和验收场景;Secret 仅记录受控引用

清单记录不可变交付引用及本次验收结果,不创建第二份部署目录、Runtime 库存或安装状态。 发布者负责核对是否遗漏程序、资源或业务前置条件;工具不能从空清单推断“没有外部要求”。

分别验收三个结果

  1. 定义交付通过:精确源码提交、资源版本、同包引用与插件资源授权通过校验。
  2. 部署验证通过:必要程序的精确制品已部署到声明的目标,迁移和 Endpoint 成功;Runtime Owner 返回预期资源。
  3. 业务验收通过:配置和授权完成,真实入口执行成功,结果符合预先声明的断言。

未知、失败、跳过或仍在执行的结果都不能标记通过。历史成功部署不代表当前 Environment 正在运行该版本; 应同时核对当前部署关联。Bundle 安装账不能替代资源 Owner 库存。报告只是采集时的证据,后续配置变更需重新验收。

发布阶段采集

先按本机分级帮助确认命令:

baijimu bundle version list --help
baijimu bundle manifest preflight --help
baijimu project version get --help
baijimu rust-build artifact get --help
baijimu hosted-service project deployments --help
baijimu hosted-service env list --help
baijimu lifecycle-plugin get --help
baijimu bundle resources --help

从真实目录取得身份并读取精确版本;不要使用展示名猜 ID、选择 latest 或拼接部署地址。 按项目清单执行结构验证和在线预检,正式创建版本仍重新校验准确提交。 独立后端的制品与部署分别按后端验证回读。

交付证据采集脚本通过官方 CLI 读取声明范围内的 Bundle 版本、 Hosted Service 项目版本和制品、当前部署、插件登记及 Owner 资源,生成脱敏 JSON 报告。它只执行只读查询, 不安装、不配置、不调用业务方法、不补授权,也不新增安装器前置探测。 使用前在自己的发布流程中列出完整交付范围;具体输入和退出状态见脚本的 --help。

业务验收由业务项目自身的测试执行,保存准确目标、源码与程序版本、执行时间、场景、预期断言和实际结果。 报告中的业务状态保持“待业务验收”,不能用查询成功或 HTTP 200 自动生成业务成功结论。

独立安装与功能前置条件

在不安装其他业务 Bundle 的 Runtime 中验证本包定义可以独立安装。声明的核心业务需要可重复执行的场景测试; 第三方服务自身的合法账号、API Key 或用户授权仍可作为该功能的必要配置。

跨 Bundle 集成另外验证未绑定、目标缺失、接口不匹配、权限拒绝、撤销、提供方升级与卸载;失败只影响相应功能。 可选提供方不进入安装依赖闭包,不导致安装排序、反向卸载阻断或自动安装。 平台不支持本包必要的资源类型或协议时应明确失败,不跳过未知资源,也不自动创建基础设施。

安装、绑定与调用的职责见安装与资源绑定。

插件注册证据的范围

采集规范为每个插件明确填写 lifecycleProtocol、referenceProtocol、credentialsProtocol、bindingReadProtocol、inventoryProtocol 和 propertyWriteProtocol 的准确 SemVer;版本以权威协议规范与本次交付目标为准。 脚本逐项核对目录的 bundleExecution.protocols,旧 protocolVersion 格式、声明缺失或任一版本不符均失败,不做旧格式回退。 registrationVerification: MATCHED_DECLARED_PROTOCOLS 只证明目录声明相符。programVerification、businessVerification 仍为 NOT_EXECUTED;握手、生命周期配置、真实引用调用及轮换/撤销必须另行验收,不能用目录匹配结果替代。

本页内容