registry 生命周期
registry 中的每个集成都遵循相同的生命周期:被提案、合并、维护,并最终被弃用或移除。该生命周期让 registry 如实反映 Bricoop 实际支持的内容,所以用户从不会连接到一个已无法工作的集成。每个阶段都有明确的归属人和明确的动作;没有任何东西会静默漂移。
所有权
每个集成都有一位负责其 manifest 的维护者。维护者保持 manifest 的 metadata.yaml 联系字段最新、回应针对该集成报告的问题,并在上游 Application 或 Provider 发生变更时发布版本升级。所有权在 manifest 中声明,而不是隐含;没有声明维护者的集成不能发布。
维护
维护涵盖版本升级、新的 models 和 capabilities 以及兼容性更新。当上游 Application 或 Provider 发布破坏性变更时,维护者更新 manifest 的 version、minimal_client_version 或 minimal_application_version 并提交拉取请求。校验器会在合并前对更新后的 manifest 运行,所以维护 PR 与新集成的处理方式完全相同。
弃用
被弃用的集成仍然可用,但在 catalog 中被标记并不再被推广。弃用在 manifest 中声明,而不是追溯应用;维护者设置弃用标志并写明原因。已经连接该集成的用户可以继续使用,但新用户在连接前会看到弃用提示。
移除
移除是最后一个阶段,只发生在集成损坏、被弃置或被替换时。移除标准要求该集成对大多数用户已无法工作,或维护者已停止回应且找不到接替的归属人。移除随一个删除 manifest 子目录的 release 发布;Bricoop Desktop 在下一次更新检查时停止提供该集成。
紧急安全处理
集成中的安全问题会绕过正常的发布节奏。维护者(若集成归属人联系不上,则由 Bricoop 维护者)立即发布一个禁用或移除该集成的紧急 manifest,然后再补上正常审查。紧急路径的存在是为了让一个有漏洞的集成不会在标准 PR 走审查时继续运行。