Harbor 开源项目路线图全解析:从社区协作机制到未来技术方向
Harbor 开源项目路线图全解析:从社区协作机制到未来技术方向
本文以 ROADMAP.md 为骨架,系统梳理 Harbor 项目的路线图治理机制、当前规划中的核心功能(Edge 场景、镜像加速、CVE 报告导出、SBoM、IPv6/IPv6 双栈等)及其在仓库中的落地证据,帮助 Harbor 用户与贡献者理解项目走向,并为社区参与提供可操作指引。
路线图文档定位与价值
Harbor 作为开源的云原生制品仓库(registry),其长期规划通过 ROADMAP.md 对外公示。该文档的核心载体是 Harbor Project board(GitHub Projects 看板),它按 release 划分泳道(swim lanes),持续跟踪各版本 pipeline 中的条目。绝大多数条目来自社区反馈,或带有社区反馈闭环——这使路线图兼具「规划声明」与「协作契约」双重属性:
- 对 使用者 而言,路线图是判断「项目走向哪里、某项能力何时可用」的参考点;
- 对 贡献者 而言,路线图是判断「我的提案是否与长期计划冲突」的依据,避免重复劳动。
仓库中与规划配套的版本治理说明见 RELEASES.md:Harbor 采用 <major>.<minor>.<patch> 语义化版本,大/小版本从 main 分支切出 release-<major>.<minor>.0 分支,GA 时以 git tag -s v<major>.<minor>.<patch> 打签;次要版本发布节奏约为 3 个月,patch 版本面向近期 minor 版本为每月一次、面向更早版本则按问题严重程度按需发布。当前支持矩阵覆盖 v2.11.x、v2.12.x、v2.13.x,且升级策略只支持「最近两个 minor 版本直连升级」,例如 2.3.0 仅支持从 2.1.0/2.2.0 升级,2.0.0 需先升到 2.2.0 再升 2.3.0。
社区协作机制:如何参与路线图
ROADMAP.md 明确给出了三类参与路径:
- 讨论:路线图相关讨论可在 Issues 线程中进行,也可在社区例会(community meetings)上沟通;
- 建议与反馈:对路线图中某个条目有建议,直接打开并评论对应 Issue;
- 新增条目:任何路线图上的新倡议(通常由新功能请求驱动)都需要先开 Issue 跟踪,项目团队会依托社区聚焦改进方向。
文档同时强调:时间线与日期是「提案与目标」而非承诺,优先级会随社区反馈、技术路障、社区贡献等变化。若你依赖某个具体条目,官方建议参加社区例会获取最新状态,或直接通过贡献帮助该功能落地。
当前路线图核心主题逐项解读
以下表格完整继承自 ROADMAP.md(Last Updated: June 2022),并按仓库现状补充实现佐证。需要说明:表格中的 Timeline 为当时的规划目标,部分条目在后续版本已落地,本仓库即包含对应实现代码。
| Theme | Description | Timeline |
|---|---|---|
| Harbor for Edge | Optimize data transfer for substandard data center connectivity to edge nodes | 2022 H2 |
| Create a lightweight Harbor with reduced feature set for minimal footprint | 2022 H2 | |
| Deployment | Improve Kubernetes Operator for Harbor, enabling improved Day1 and Day2 operations including enterprise grade HA, faster deployments and upgrades, automate backups and restores, and sensible defaults | Future |
| Support Notary v2 to deliver persisting image signatures across image replications | Future | |
| Optimized Scalability & Performance | Introduce cache layer to improve performance | 2022 H2 |
| Image acceleration | Leverage Nydus to support image acceleration | Future |
| Regex Support | Add full Regex support to all modules within Harbor consistently including configuration of replication policies, retention policies, immutability policies and more | Future |
| ARM Harbor | release an ARM deployment of Harbor | Future |
| Backup & Restore | Leverage Project Velero to offer application-aware Harbor backup, including databases, Kubernetes objects and Persistent Volumes | 2022 H2 |
| Extended image support | Support WASM images | 2022 H2 |
| System artifact manager | 2022 H2 | |
| CVE reporting | Export CVE list at the repo level | Future |
| SBoM support | SBoM generation & attestation | Future |
| Networking | Support dual stack IPv6/IPv4 network for Harbor pods in a Kubernetes cluster | 2022 H2 |
Harbor for Edge:面向边缘节点的轻量化与传输优化
该主题包含两条线:一是针对「数据中心与边缘节点之间网络质量欠佳」的场景优化数据传输;二是打造功能裁剪、占用最小的轻量版 Harbor。边缘场景通常意味着弱网、间歇性连接与资源受限,这与「拉取缓存」「P2P 分发」等能力天然互补——详见下文「已完成条目」中 pull-through cache 与 Dragonfly/Kraken P2P 的落地。
Deployment:Kubernetes Operator 与 Notary v2
- Kubernetes Operator 增强:目标是在 Day1/Day2 运维上提供企业级高可用、更快的部署与升级、备份恢复自动化以及合理默认值。Harbor 的容器化部署骨架集中在 make 目录,其中 make/harbor.yml.tmpl 是安装配置模板,make/install.sh 与 make/prepare 负责生成编排配置,可作为理解 Operator 化前手工部署流程的参照。
- Notary v2 支持:目标是让镜像签名在复制(replication)后持久保留。仓库中与签名相关的能力已部分成型:签名以「accessory(附属制品)」的形式建模(见下文 SBoM 一节的源码分析),Cosign 签名类型定义于 src/pkg/accessory/model/cosign/cosign.go(
TypeCosignSignature,硬引用),Notation 签名类型定义于 src/pkg/accessory/model/notation/notation.go(TypeNotationSignature,硬引用)。两条路径均实现为model.Accessory,随主制品一同存储与 GC。
Optimized Scalability & Performance:缓存层
规划引入缓存层以提升性能。从代码结构看,src/pkg/cached 与 src/lib/q(查询抽象)已构成该方向的实现基础,src/controller/artifact 中的 artifact 查询链路(controller.go)为典型热点路径,缓存层正是在此类查询路径上降低数据库压力。可以推断,路线图中的「cache layer」即是对上述基础设施的进一步系统化。
Image acceleration:Nydus 镜像加速
规划依托 Nydus 实现镜像加速。Nydus 通过按需加载(on-demand)数据块避免全量拉取,显著改善冷启动与弱网体验,与边缘场景高度契合。仓库中该能力的落地证据包括:
- 附属制品类型常量
TypeNydusAccelerator = "accelerator.nydus"(src/pkg/accessory/model/accessory.go); - 具体模型实现于 src/pkg/accessory/model/nydus/nydus.go(含测试 nydus_test.go);
- 配套图标资源 icons/nydus.png 用于制品列表中的类型展示。
Regex Support:全模块正则统一
规划为复制策略、保留策略、不可变策略等所有模块提供一致、完整的正则支持。这意味着策略配置层将统一正则语法与校验逻辑,避免各模块实现差异。策略相关代码可参考 src/controller/replication/policy.go(复制策略)与 src/pkg/retention(保留策略),它们是未来正则能力统一的主要受益对象。
ARM Harbor:ARM 部署形态
规划发布 ARM 架构的 Harbor 部署。这与 make/photon 下的多组件镜像构建体系相关——各组件 Dockerfile(如 make/photon/core/Dockerfile、make/photon/registry/Dockerfile)均需具备跨架构构建能力,ARM 版本通常通过多架构 manifest 提供。
Backup & Restore:基于 Velero 的应用感知备份
规划依托 Project Velero 提供应用感知的 Harbor 备份,覆盖数据库、Kubernetes 对象与持久卷(PV)。这与仓库现有脚本化备份方案互补:非 Kubernetes 场景可参考 contrib/backup-restore 提供的 harbor-backup 与 harbor-restore 脚本(用法见 README)。
Extended image support:WASM 镜像与系统制品管理
- WASM 镜像:规划支持 WebAssembly 镜像。仓库中
TypeLocalReferrer/TypeProxyReferrer等 referrer 机制(src/pkg/accessory/model/accessory.go)为扩展新制品类型提供了统一挂载点,WASM 镜像类型常量DigestOfIconWASM已出现在 src/lib/icon/const.go 中,对应图标 icons/wasm.png 亦已入库。 - 系统制品管理器(System artifact manager):规划引入用于管理系统内部产生的制品的统一入口。src/controller/systemartifact 与 src/pkg/systemartifact 即该方向的实际实现:前者包含 execution.go 与回调(callback.go),后者提供存储与调度管理,表明「系统制品」已从规划进入工程实现。
CVE reporting:仓库级 CVE 列表导出
规划支持在 repo 级别导出 CVE 列表。现有扫描能力中,src/pkg/scan 提供报告模型与扫描执行,src/controller/scandataexport 已实现扫描数据导出执行器(execution.go,含 execution_test.go)——这正是「CVE 报告导出」从路线图走向产品的直接证据,导出粒度与维度随版本演进逐步扩展。
SBoM support:软件物料清单生成与证明
规划支持 SBoM(Software Bill of Materials)生成与 attestation(证明)。该能力在仓库中已有较完整落地:
- 附属制品类型
TypeHarborSBOM = "sbom.harbor"(src/pkg/accessory/model/accessory.go); - 模型实现 src/pkg/accessory/model/sbom/sbom.go(含 sbom_test.go),类型为硬引用(
RefHard); - 测试样例 tests/files/sbom_test.json 可直接用于验证 SBoM 制品接入;
- 对应图标 icons/sbom.png 已入库。
Networking:Kubernetes 环境 IPv4/IPv6 双栈
规划支持 Harbor Pod 在 Kubernetes 集群内使用 dual-stack IPv6/IPv4 网络。双栈网络要求各组件的监听地址、健康检查与反代配置(make/photon/nginx、make/photon/core/entrypoint.sh)对 IPv6 地址族友好,属于部署形态层面的系统性适配。
已完成条目:历史规划如何逐步兑现
ROADMAP.md 的 Completed Items 表格记录了 2020-2021 年间已交付的能力,可作为「规划→实现」的对照样本:
| Theme | Description | Timeline |
|---|---|---|
| Security Analysis | Leverage Sysdig Secure scanner to analyze container images | Aug 2020 |
| Image Distribution | Ability for Harbor registry to function as a pull-through cache for remote registry | Sep 2020 |
| Performance & Reliability | Non-blocking Garbage Collection | Sep 2020 |
| Image Distribution | Leverage P2P providers like Alibaba Dragonfly and Uber Kraken to geo-distribute artifacts at higher rates | Oct 2020 |
| Extensibility | Allow vendors to publish and share OCI artifacts like Machine Learning (Kubeflow) workloads generated datatypes on Harbor | Oct 2020 |
| Registry | Improve support for Windows containers layers | Oct 2020 |
| I&AM and RBAC | Improved Multi-tenancy through granular access and ability to manage teams of users and robot accounts through workspaces | Dec 2020 |
| Observability | Expose Harbor metrics through Prometheus Integration | Mar 2021 |
| Tracing | Leverage OpenTelemetry for enhanced tracing capabilities and identify bottlenecks and improve performance | Mar 2021 |
| Image Signing | Leverage Sigstore Cosign to deliver persistent image signatures across image replications | Apr 2021 |
以上条目均可在本仓库找到对应实现,形成「路线图—代码」闭环:
- Pull-through cache:远程仓库拉取缓存能力位于 src/controller/proxy(controller.go、local.go、remote.go),用于配置代理缓存项目的远端与本地存储;
- P2P 分发:预加热(preheat)与 P2P 集成位于 src/controller/p2p/preheat 与 src/pkg/p2p,支持对接 Dragonfly 等提供方;
- 非阻塞 GC:垃圾回收控制器位于 src/controller/gc,通过任务调度(src/controller/task)异步执行,避免阻塞常规读写;
- Prometheus 指标:指标暴露实现于 src/common/models/metric.go 与 src/pkg/exporter,Grafana 面板示例见 contrib/grafana-dashboard/metrics-example.json;
- OpenTelemetry 追踪:追踪基础设施位于 src/lib/trace,提供与 OpenTelemetry 对齐的 span/trace 注入;
- Cosign 签名持久化:正是上文提到的 src/pkg/accessory/model/cosign/cosign.go,配合复制(src/controller/replication)链路实现签名随镜像跨实例分发。
从路线图到代码:Accessory 扩展模型解读
多条路线图条目(Notary v2 签名、Nydus 加速、SBoM、WASM)都依赖同一套底层抽象——Accessory(附属制品)。理解它有助于预判 Harbor 未来的扩展方式。
src/pkg/accessory/model/accessory.go 定义了软/硬引用语义:
- Soft reference(软引用):附属制品不被主制品(subject)强绑定。主制品被删除时,仅解除关联,附属制品保留为独立制品;GC 时按普通制品对待;
- Hard reference(硬引用):附属制品与主制品强绑定。主制品删除时附属制品一并删除;GC 时作为主制品的附属内容被一同回收。
当前各类型全部采用硬引用:Cosign(Kind() 返回 model.RefHard)、Notation、Nydus、Harbor SBoM 均是如此(如 cosign.go 所示),并通过 model.Register(type, factory) 注册工厂、model.New(type, data) 按类型实例化。图标映射集中在 src/lib/icon/const.go,其中 DigestOfIconAcc* 系列即为各 accessory 的展示图标摘要(Cosign/Notation/Nydus/SBOM),与 icons 目录下的资源对应。
可以推断:后续新增的制品类型(如路线图中的 WASM 镜像、更细粒度的 SBoM attestation)大概率仍以「新增 Type* 常量 + 实现 Accessory 接口 + 注册工厂」的方式接入,这是 Harbor 扩展 OCI 制品生态的标准路径。
贡献者行动指南
结合 ROADMAP.md 与 CONTRIBUTING.md 的既有流程,参与路线图的推荐路径如下:
- 先查后提:在 Issues 与 Project board 中检索是否已有对应条目,避免重复;
- 以 Issue 驱动:为任何新功能/改进先开 Issue,描述场景、动机与大致方案,在社区例会或 Issue 线程中与维护者对齐优先级;
- 关注方向性条目:如「Regex Support」「CVE 报告导出」「ARM Harbor」等跨模块条目,贡献前先了解现有实现(本仓库对应路径如上文),确保改动与长期架构一致;
- 从文档与技术债入手:ROADMAP.md 明确表示社区始终需要帮助削减技术、自动化与文档债务,这类工作门槛低、反馈快,适合新贡献者起步;
- 对齐发布节奏:参考 RELEASES.md 的发布分支与支持矩阵规划合入时间,大特性应瞄准对应 minor 版本的 RC 分支创建时间点。
总结
ROADMAP.md 是一份「活文档」:它以 Project board 为实时载体,以本仓库为实现镜像。从 2020 年的 Sysdig 扫描器、pull-through cache、非阻塞 GC、P2P 分发,到 2021 年的 Prometheus 指标、OpenTelemetry 追踪与 Cosign 签名持久化,再到规划中的 Edge 场景、Nydus 加速、SBoM、WASM、双栈网络与 Velero 备份——每一条路线图条目都能在 src/ 目录中找到对应的工程落地或雏形。对于 Harbor 用户,它是判断依赖功能可用性的时间轴;对于贡献者,它是避开重复劳动、找准发力方向的路线图与协作契约。