OCManager / 私有化软件仓库管理（犀牛鸟实战任务二）：多仓库发布、节点运维与自动化验收 · Pull Request !420 · OpenCloudOS/OCManager

本 PR 完成“犀牛鸟 OpenCloudOS 实战任务二”的私有化软件仓库管理功能，在 OCManager 现有 Go / Vue 技术栈内打通仓库配置、远程同步、私有 RPM 上传、可信校验、标准 YUM/DNF 发布、安装验证、节点运维、分发和失败诊断。

本次更新原 PR !420，保留既有评审记录；源分支为 `shibuchou/ocmanager-repository:feature/private-repository`，目标为 `OpenCloudOS/ocmanager:master`。已核对最新上游 `853dba6`，候选包含该提交，不覆盖上游历史。

## 产品能力与实现落点

| 能力 | 实现与边界 |
| --- | --- |
| 多仓库管理 | 仓库管理、任务总览、仓库节点、上游源四个入口；服务端分页与统计、批量 Repo Config、Inventory 导入/导出、定时同步及幂等调度 |
| 远程同步 | 来源模板和自定义地址、来源/架构联动筛选、include/exclude、MIRROR/APPEND；节点容量/inode/工具预检，真实下载限速与并发控制 |
| 私有上传 | RPM/tar.gz、多文件队列、独立 Upload Session、Indexed Chunk 乱序与断点续传；损坏包、危险归档及不可信签名拒绝进入可用源 |
| 标准与可信发布 | RPM + repodata、不可变 Revision、manifest/SHA-256、Mutation Lock、Prepare/Activate/Confirm 与 Atomic Publish；只读 HTTP 对外提供 YUM/DNF 源 |
| 节点与任务 | 后端聚合容量和仓库实际占用；节点 Drawer 查看多仓库、发起原有 Sync、关联最近任务；一个业务 Task 保存多个 Target 或逐包结果 |
| 运维闭环 | 隔离依赖预演、单任务批量删除、固定 Revision 的 TMS 安装与分发、脱敏日志包、规则诊断与 OCAI 只读分析 |

```text
Vue 3 / Pinia / TDesign
  → Footstone Repository API / Service
  → Task / Target / Mutation Lock / MySQL
  ↔ mTLS Repository Node / Existing Worker
  → Immutable Revision / repodata / Atomic Publish
  → Read-only HTTP → DNF / YUM
```

管理面保存模型、任务、包清单与日志索引，Repository Node 保存 RPM、元数据、staging、quarantine 和原始日志。复用现有 TMS、OCAI、Worker、Revision 和发布协议，不增加第二套任务、文件分发或远程执行框架；控制面与仓库节点可以同机或分机，不要求固定两个 Agent。

仓库当前内容大小来自 active Revision，节点实际占用来自文件系统观测，二者不混用。任务统计和节点集群汇总针对完整筛选集合计算，不按当前分页临时累加；定时触发、手动触发和目标级执行结果均可追溯。

Node RPM 本体进入普通私有 Repository，经校验、生成 repodata 后作为受保护的 `NODE_RPM` 安装源。Artifact 绑定项目、启用安装源、架构、包、immutable Revision 和 SHA-256；默认最新按 RPM EVR，允许选择仍有效的历史版本。前端选择在线 Agent 后，TMS 下发安装脚本与临时 Repo 配置，目标从内部不可变软件源执行 DNF 安装，保留实际 GPG 策略。安装后本地生成私钥/CSR，通过注册白名单、Enrollment 和一次性 Token 自动注册；私钥不上传管理面。

## 本次审查修复与界面收口

1. **首次 GPG 安装预览**：仅在临时 DNF 信任目录准备元数据，再对同一 immutable Revision 执行 `--assumeno`。真实验证正确/错误公钥，不修改宿主 RPM 公钥库，不使用 `--nogpgcheck`；Confirm 仍须用户确认。
2. **任务与上传生命周期**：相同直接父任务的在途 Retry 去重；区分上传对象缺失、不可读、长度/摘要不匹配。合法失败上传恢复继续校验原任务、身份、冻结对象和 lease/fencing，重复结果按既有幂等路径处理。
3. **断连与授权恢复**：独立维护过期任务、离线状态；Worker 首次心跳恢复前不领任务，失去执行权不发布，取消日志与任务终态一致。消费后的 Bootstrap Token 不重新授权；只有匹配持久化授权、CSR 与身份的精确重试才能恢复签发或取得原证书。
4. **安全与错误反馈**：sysdiagnose 补齐既有 TMS HMAC 签名，重试刷新 nonce，Compose 注入和运行健康检查保持严格校验。GPG、上传及系统安装源拒绝统一接入后端错误目录，保留英文 Code、中文原因/建议和技术原文。
5. **部署与可复现测试**：真实鉴权就绪后执行 MySQL 迁移；补齐工具路径、版本和独占测试数据库前提。GPG 夹具使用受控短临时目录，避免 Unix socket 路径限制，不改变产品安全策略。
6. **界面一致性**：查询区复用既有 SearchBox 风格，统一标签、控件高度、按钮和换行；Drawer 短状态标签按内容收缩，表头/横向滚动条可达。安装节点可搜索和筛选在线，分发目标横向展示；上传队列按仓库隔离，完成文件不关闭整个队列。命令助手重跑仅回填和预览，整机监控统一排除光盘容量假告警。

## 真实验收结果

2026-10-24 在 OpenCloudOS 9 对冻结候选实际运行完整发布入口，随后只进行文档、截图及发布隐私收口；不把截图更新冒充再次执行全部业务测试。

| 验证 | 结果 |
| --- | --- |
| `make -C manager repo-acceptance` | exit code = 0；11 个执行步骤全部退出 0 |
| 最终机器验收 | **152/152 PASS**；重复、缺失、意外、非 PASS、不完整证据项均为 0 |
| 核心/增强矩阵、Evidence Bundle | **31/31 PASS、9/9 PASS** |
| Repository 前端 | 20 文件、126 项测试通过；定向 Typecheck、ESLint、Stylelint 和正式构建通过 |
| 后端 | 53 个真实配置包、529 项通过；受影响包 vet/build 通过；默认入口外的 9 项 opt-in 另行实际执行 |
| 产品链路 | DNF Case A/B/C、GPG/Metadata Signing、恢复上传、批量删除/依赖预演、导入、双目标安装/分发、Node RPM 与自动注册、白名单安全负向、OCAI SSE、restart/redeploy/destroy-restore |
| 架构与页面 | x86_64/aarch64 真实节点；1440×900、1920×1080 浏览器检查；文档收口复核 1467 个非文档文件未改变 |

152 个预期 ID 固定由 `manager/acceptance/repository-acceptance-criteria.json` 定义，每项保留 implementation、tests、evidence；Markdown 只是展示层。2026-10-14 完整验收和 2026-10-22 前端增量作为历史记录保留，当前结论以本次完整候选结果为准。

## 部署、文档与公开材料

按部署说明准备 OC9、工具版本、PKI、数据库、数据目录及可访问发布地址，使用现有 deploy/compose 或 RPM/systemd 方式启动。测试文档逐项说明脚本用途、输入和前提；具备相应环境后从 Repository Root 执行：

```bash
make -C manager repo-acceptance
bash scripts/repository-release-check.sh
```

- [方案设计](https://gitee.com/shibuchou/ocmanager-repository/blob/feature/private-repository/docs/私有化软件仓库方案设计.md)：模块、模型、协议、存储、可信发布与五张架构图。
- [部署说明](https://gitee.com/shibuchou/ocmanager-repository/blob/feature/private-repository/docs/私有化软件仓库部署说明.md)：环境、工具、部署、安装源、白名单与恢复。
- [测试验收](https://gitee.com/shibuchou/ocmanager-repository/blob/feature/private-repository/docs/私有化软件仓库测试验收.md)：可复现步骤、正负向测试与证据边界。
- [结构化验收报告](https://gitee.com/shibuchou/ocmanager-repository/blob/feature/private-repository/docs/私有化软件仓库结构化验收报告.md)：最新操作图、历史实验与当前完整验收。
- [最终候选摘要](https://gitee.com/shibuchou/ocmanager-repository/blob/feature/private-repository/docs/evidence/repository-final-validation-20261024.json) · [152 项机器结果](https://gitee.com/shibuchou/ocmanager-repository/blob/feature/private-repository/docs/evidence/repository-acceptance-progress-20261024.json)。

发布材料只保留脱敏截图与校验摘要；OCAI Key、运行凭据、Token、私钥、本地 VM 地址、开发机路径和临时原始证据不进入本次提交。历史原图保留在本地，公开截图不替代原始实验记录。

## 保留边界

- 首个 Repository Node 需按文档初始化；目标机器需先安装并接入既有 TMS Agent。本 PR 自动安装的是 Repository Node RPM，没有新增 SSH 裸机引导安装 TMS。
- OCAI 只提供脱敏分析建议，不自动执行修复；缺少可选组件时对应能力明确不可用，不伪造成功任务。
- Repository 定向类型检查不等于全站历史 TypeScript 问题清零；遗漏删除确认等普通参数错误仍可能保留英文技术提示。
- 旧版本号 RPM 验证了 EVR 与页面选择，不宣称对运行节点实施历史代码降级；ZooKeeper 历史部署未启用认证，本次不扩展 SASL。评审环境应按文档重新生成证据。

类型	指派人员	状态
审查	cherrycao	进行中 (0/1人)
测试	cherrycao	进行中 (0/1人)

OpenCloudOS / OCManager .gitee-modal { width: 500px !important; }

搜索帮助

OpenCloudOS / OCManager