Download Latest Version v1.0.0 source code.zip (875.3 kB) Google Add to Preferred Sources
Home / v1.0.0
Name Modified Size InfoDownloads / Week
Parent folder
clusternet_1.0.0_checksums.txt 2026-06-28 574 Bytes
0
clusternet_linux_amd64.tar.gz 2026-06-28 176.9 MB
0
clusternet_linux_s390x.tar.gz 2026-06-28 172.3 MB
0
clusternet_linux_386.tar.gz 2026-06-28 164.7 MB
0
clusternet_linux_arm64.tar.gz 2026-06-28 167.1 MB
0
clusternet_linux_arm.tar.gz 2026-06-28 162.5 MB
0
clusternet_linux_ppc64le.tar.gz 2026-06-28 165.6 MB
0
README.md 2026-05-10 8.1 kB
0
v1.0.0 source code.tar.gz 2026-05-10 446.2 kB
0
v1.0.0 source code.zip 2026-05-10 875.3 kB
0
Totals: 10 Items   1.0 GB 0

Clusternet v1.0.0 Release Notes

📌 版本概述

Clusternet v1.0.0 是一个重要的里程碑版本，标志着项目从 v0.x 系列向 v1.0 的升级。本版本在保持向后兼容性的基础上，引入了多项重要功能增强、性能优化和稳定性改进。主要亮点包括对 Kubernetes 1.32 的支持、Protobuf 序列化优化、新的字段补丁类型支持，以及多项关键缺陷修复。

🎉 重大特性 (Major Features)

字段补丁类型支持 (Field Patch Type) - #885

新增字段补丁类型支持，允许用户在多集群应用部署时进行更精细的资源字段级别的覆盖和修改。这个功能扩展了现有的 JSON Patch 和 Merge Patch 能力，在跨集群部署应用时可以针对特定字段进行精确修改，而无需修改整个资源对象。

Kubernetes 1.32 支持 - #886

升级 Kubernetes 依赖到 1.32 版本，确保 Clusternet 与最新的 Kubernetes 生态保持同步。此次升级涉及大量依赖更新和代码适配，使用户能够在最新的 Kubernetes 环境中运行 Clusternet，获得最新的安全补丁和性能优化。

Protobuf 序列化优化 - #888

生成使用 Protobuf 进行 API 请求的客户端集合，提升 API 通信的效率和性能。Protobuf 相比 JSON 具有更小的消息体积和更快的序列化/反序列化速度，在大规模多集群场景下可显著降低网络带宽消耗和 API 服务器的处理负载。

✨ 新增功能 (New Features / Enhancements)

Helm 纯 HTTP 支持 - #927

为 OCI 注册表添加纯 HTTP 支持，通过新增 plainHTTP 字段允许用户在不支持 HTTPS 的私有注册表中拉取 Helm Chart，适用于内部私有网络或开发环境。

Helm 目标命名空间回退修复 - #928

改进 Helm Release 的目标命名空间处理逻辑，确保在未明确指定命名空间时能够正确回退到默认命名空间。

Go 1.23 升级 - #873

升级项目使用的 Go 版本到 1.23，并进行相应的代码调整和 linter 修复，确保代码质量和性能。

🐛 缺陷修复 (Bug Fixes)

CRD Shadow API 空指针异常修复 - #920

修复在推送模式下通过 ShadowAPI 创建自定义资源对象时发生的空指针异常。问题根源在于 CRD 处理器的 addStorage 方法中缺少两个关键初始化：CRD 资源类型未注册到 Scheme，以及 RequestScope 结构体缺少 FieldManager 初始化（Kubernetes 1.30+ 要求）。

Post-start Hooks 阻塞 /readyz 修复 - #931

修复 Hub 组件的 post-start hooks 阻塞 /readyz 就绪检查的问题。通过将长时间运行的操作移至独立的 goroutine 中执行，改善了 Hub 组件的启动速度和就绪状态检测的准确性。

Base 生成幂等性修复 - #932

修复 Base 资源生成过程中的幂等性问题，确保多次执行相同的部署操作能够产生一致的结果，避免不必要的资源更新。

Job 同步错误修复 - #915

修复 Batch Job 资源同步时的标签处理问题。在 Kubernetes 1.30+ 中，Job 控制器引入了新的标签字段 batch.kubernetes.io/controller-uid 和 batch.kubernetes.io/job-name，需要在 Shadow API 中正确处理这些字段以避免同步冲突。

Leader Election 丢失重连修复 - #905

改进 Agent、Controller Manager 和 Scheduler 组件的 leader election 处理，当失去 leader 身份时能够正确重新连接，确保高可用性。

Agent 注册验证修复 - #896

修复多个 Agent 同时与父集群注册时的验证问题，确保注册过程的正确性和一致性。

Manifest Protobuf 编码修复 - #890

修复 v1alpha1.Manifest 资源无法实现 Protobuf 编码接口的问题，确保 Manifest 资源能够正确序列化为 Protobuf 格式。

EffectiveVersion 空值修复 - #889

修复 Hub 服务器配置中 EffectiveVersion 为空的问题，确保 API 服务器能够正确报告其有效的 Kubernetes 版本。

ValidatingAdmissionPolicy 依赖移除 - #884

移除对 ValidatingAdmissionPolicy 的依赖，确保 Clusternet 与不同 Kubernetes 版本的兼容性。

♻️ 重构与改进 (Refactoring & Improvements)

  • Apimachinery Protobuf 序列化器修复: 改进 Kubernetes apimachinery 的 Protobuf 序列化器集成，提升 API 通信的可靠性
  • 代码质量改进: 升级 Go 版本到 1.23，应用最新的 linter 规则和代码风格检查，修复多个代码质量问题

📦 依赖升级 (Dependency Upgrades)

核心依赖

安全依赖更新

CI/CD 工具升级

  • Codecov Action 升级到 6、Goreleaser Action 升级到 7、FOSSA Action 升级到 1.9.0

⚠️ 破坏性变更 (Breaking Changes)

  • Kubernetes 版本要求: 最低要求 Kubernetes 1.30+，不再支持 Kubernetes 1.28 及以下版本
  • API 变更: 移除对已弃用 ValidatingAdmissionPolicy 的依赖可能影响某些自定义配置

📖 升级指南 (Upgrade Notes)

升级前检查清单

  1. 确保所有 Kubernetes 集群版本 >= 1.30
  2. 备份现有的 Clusternet 配置和自定义资源
  3. 在测试环境中先行验证升级过程

升级步骤

  1. 更新 Clusternet 镜像到 v1.0.0
  2. 更新 CRD 定义（特别是 HelmChart 和 HelmRelease，新增 plainHTTP 字段）
  3. 重启 Clusternet 组件（Agent、Hub、Controller Manager、Scheduler）
  4. 验证所有组件正常运行

新功能启用

  • 字段补丁: 在 Localization 和 Globalization 资源中使用新的 fieldPatch 类型
  • Helm 纯 HTTP: 在 HelmChart 和 HelmRelease 中设置 plainHTTP: true 以支持非 HTTPS 仓库

注意事项

  • 升级后，请确保所有 Agent 都能正确连接到 Hub
  • 如果使用自定义的 Helm Chart 仓库，请根据需要配置 plainHTTP 字段
  • 建议在升级后运行完整的集群健康检查

🙏 贡献者致谢 (Contributors)

感谢以下贡献者为 v1.0.0 版本做出的贡献：

  • @dixudx - 项目维护者，主导 Kubernetes 1.32 升级和多项关键修复
  • @silenceper - Helm 功能增强和修复
  • @abstractmj - 字段补丁类型实现、Protobuf 优化和多项修复
  • @zhenkuang - Post-start hooks 修复和 Base 生成幂等性修复
  • @officialasishkumar - CRD Shadow API 空指针异常修复
  • @chxcode - Agent 注册验证修复
  • @luc99hen - 文档更新
  • @akhilmukkara - 文档改进

以及所有通过 GitHub Actions 和依赖更新做出贡献的社区成员。

🔗 完整变更链接

Source: README.md, updated 2026-05-10