Harbor 开源项目路线图全解析:从社区协作机制到未来技术方向

原创2026-09-09 16:14:321,454 阅读
文章标签:云原生镜像仓库后端

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 明确给出了三类参与路径:

  1. 讨论:路线图相关讨论可在 Issues 线程中进行,也可在社区例会(community meetings)上沟通;
  2. 建议与反馈:对路线图中某个条目有建议,直接打开并评论对应 Issue;
  3. 新增条目:任何路线图上的新倡议(通常由新功能请求驱动)都需要先开 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)数据块避免全量拉取,显著改善冷启动与弱网体验,与边缘场景高度契合。仓库中该能力的落地证据包括:

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 镜像与系统制品管理

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(证明)。该能力在仓库中已有较完整落地:

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

以上条目均可在本仓库找到对应实现,形成「路线图—代码」闭环:

从路线图到代码: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 的既有流程,参与路线图的推荐路径如下:

  1. 先查后提:在 Issues 与 Project board 中检索是否已有对应条目,避免重复;
  2. 以 Issue 驱动:为任何新功能/改进先开 Issue,描述场景、动机与大致方案,在社区例会或 Issue 线程中与维护者对齐优先级;
  3. 关注方向性条目:如「Regex Support」「CVE 报告导出」「ARM Harbor」等跨模块条目,贡献前先了解现有实现(本仓库对应路径如上文),确保改动与长期架构一致;
  4. 从文档与技术债入手:ROADMAP.md 明确表示社区始终需要帮助削减技术、自动化与文档债务,这类工作门槛低、反馈快,适合新贡献者起步;
  5. 对齐发布节奏:参考 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 用户,它是判断依赖功能可用性的时间轴;对于贡献者,它是避开重复劳动、找准发力方向的路线图与协作契约。

登录后查看全文
harbor