Flynor平台文档Flynor 首页
Flynor 文档/COMPONENT · FOUNDATION
草案

DevOps Connector

产品无关 DevOps 访问边界已完成当前治理,并继续作为 Agile Work Item 的唯一写入所有者。Choerodon Tester 只拥有 Test Manager 用例、计划、周期和执行记录,不能形成第二条评论、状态或缺陷写链。Test Writeback、Tech 已绑定项目的评论/状态/中央技术任务,以及 BA/Server 业务父子任务创建使用 DevOps Task Operation/Result;标准 Project、Iteration、Work Item、Status、Comment、User、Relation、Transition 与 Read Query/Result 已由 Fake/Choerodon Provider 同套实现。版本化 DevOpsConnection 与失败关闭的 Provider Registry 为新增 Provider 提供不含凭据正文的装配契约;现有宿主仍保留已验收的显式构造与兼容 Facade。标准 Compose 已通过受控 Secret 投影在 devbox 对真实项目完成读取、缓存刷新,以及专用低优先级测试任务的评论、合法状态流转、幂等重放和原状态恢复。

展示名称DevOps 连接器
类型connector-boundary
成熟度试点
Owner集成平台组
01

职责与边界

负责

  • 发布版本化 DevOps 标准模型和接口
  • 分离只读与受控写入能力
  • 校验权限、人工确认或策略授权、幂等键和审计上下文
  • 向上层返回产品无关结果与错误

不负责

  • 不成为第二套 Work Item 主数据
  • 不保存外部产品凭据正文
  • 不实现具体产品 API
  • 第一阶段不建设动态插件市场或复杂 Adapter 生命周期框架
  • 不写 Test Manager 执行记录,也不与 Test Manager Result Publisher 共享写凭据
02

数据与接口

拥有的数据

  • 无工作项主状态;仅允许保存契约版本、操作回执和带来源时间的缓存投影元数据

输入

标准 DevOps 读取请求;带人工确认或策略授权的标准写入命令;已注册 DevOps Adapter

输出

标准 Project、Iteration、Work Item、Status、Comment、User 与 Relation;标准写入计划与逐动作回执

协议

flynor/devops-read-query/v1alpha1;flynor/devops-read-result/v1alpha1;flynor/devops-work-item/v1alpha1;flynor/devops-task-operation/v1alpha1;flynor/devops-task-operation-result/v1alpha1;目标 flynor/devops-work-item/v1

依赖

protocol

03

运行与部署

Owner / 支持

集成平台组 · pilot · active;升级路径:集成平台组 → 运行平台组 → 平台治理组

交付策略

embedded · supported;作为 integration-choerodon 0.15.0 中的共享协议与运行库嵌入现有宿主,不新增强制中央服务或独立发布单元。现有宿主继续使用已验收的显式构造/兼容 Facade 和旧配置;DevOpsConnection/Provider Registry 是新增 Provider 与后续宿主逐项迁移的失败关闭装配契约,adapterConfigRef/credentialRef 仍由宿主既有配置加载器与 Secret Store 解析,未冒充已经替换全部成熟入口。

配置

DevOpsConnection v1alpha1 声明 connectionId、adapterId、兼容模式、Adapter 配置引用、统一 env:// / secret:// / managed-secret:// / file-ref:// SecretRef 和逐项目 read/write 范围;引用由宿主既有配置加载器/Secret Store 解析后以 providerContext 注入,Registry 不读取配置或秘密正文。写入继续从现有 Test Writeback 配置投影 policy authorization 与 idempotencyKey,产品状态映射和秘密正文只留在 Choerodon Provider/Secret Store。旧三套配置与 generic 模式别名继续兼容。

部署

Project Resource Connector 下的专业领域协议与共享运行库,不新增强制中央微服务;Test Runtime 内部 Intake/Writeback 只依赖此通用边界,宿主装配明确 Adapter

健康检查

DevOpsConnection/Provider Registry、Read Query/Result 与 Task Operation/Result Schema、Fake/Choerodon 同套 Provider、Test Intake 标准读取、Tech 读写受管 bridge/运行时装配/标准与旧入口选择、轻量 Relation/Status、完整详情正文/嵌套评论/分页/部分失败/freshness、用户评论单 dispatch、显式/策略状态流转、中央建单 marker 恢复/计划确认/priority-only 补全/partial create 恢复/依赖顺序/父任务先读后写、Test Writeback 幂等、Robot 缓存 Sync Run/last-good/原错误兼容,以及 bundled Robot MCP 逐调用 signature/scope/budget/delete-deny/indeterminate-write 审计;真实只读、缓存语义和专用测试任务写入已有 devbox live。

可观测性

只记录 connectionId、operationId、executionId/traceId、能力、耗时和回执状态,不记录凭据、评论正文或原始外部响应

升级与回滚

第一阶段通过项目级 legacy/standard 模式切换(兼容旧名 generic);旧协议、配置和命令别名至少保留两个正式小版本且不少于 90 天

依据

architecture/adrs/0005-devops-connector-boundary.md · architecture/schemas/devops-connector.schema.json · architecture/governance.backlog.json · packages/contracts/devops.js · packages/contracts/index.js · packages/integration-choerodon/src/devopsConnector.js · packages/integration-choerodon/test/devops-provider-registry.test.js · packages/integration-choerodon/src/testIntakeService.js · packages/integration-choerodon/test/devops-read-connector.test.js · apps/tech-codex/scripts/choerodon-tool-bridge.cjs · apps/tech-codex/src/choerodonClient.ts · apps/tech-codex/src/test/choerodonManagedBridge.test.ts · apps/tech-codex/src/test/choerodonTodoPolicy.test.ts · packages/integration-choerodon/src/testWritebackService.js · packages/integration-choerodon/test/test-writeback-service.test.js · architecture/audits/test-runtime-devops-governance-2026-08-26.md · architecture/audits/devops-read-connector-governance-2026-08-26.md · architecture/audits/tech-devops-write-governance-2026-08-26.md · architecture/audits/tech-central-devops-create-governance-2026-08-26.md · architecture/audits/server-business-devops-create-governance-2026-08-26.md · architecture/audits/robot-devops-cache-synchronizer-governance-2026-08-26.md · architecture/audits/robot-realtime-devops-mcp-governance-2026-08-26.md · architecture/audits/devops-connector-closure-2026-08-30.md · apps/server/packages/server/src/businessTaskDevOpsFacade.js · apps/robot/zcy-mcp/src/interfaces/work-item-provider.js