发布日期: 2026-01-22
版本号: v1.10.2-rc1

本次发布的Longhorn v1.10.2版本重点修复了多个重要问题并进行了功能优化。版本发布说明明确警告，不支持从任何RC/预览/测试版本进行升级或降级操作。主要更新内容包括：在快速故障转移模式下为长喉共享管理器继承命名空间的特性，以及计划迁移已终止支持的AWS SDK v1版本的依赖项；改进了由VolumeAttachment Webhook阻塞导致的V2卷CSI克隆速度缓慢的问题。该版本修复了大量Bug，涵盖了副本重建与克隆流量错误、健康副本误删、数据本地化卷副本移除失败、系统备份创建或删除异常、配置文件设置错误、自动平衡导致的副本删除重建循环、单副本卷在节点重启后卡在附加/分离循环、实例管理器客户端上下文泄漏、快照代理请求路由错误、节点条件未正确清理、RWX卷在节点排空后不可用、未使用的V2卷被不必要重建、测试用例失败、CSI节点挂载错误处理、加密卷无法在线扩容、自动生成的BackingImage Pod名称问题、克隆卷无法挂载、块模式卷迁移卡住、副本自动平衡磁盘压力阈值问题、短名称模式异常、引擎升级过程中副本累积、BackingImageManager客户端连接泄漏、自动平衡忽略副本节点软反亲和性规则、空指针解引用错误以及Web界面在OIDC认证下请求头或Cookie过大等问题。感谢所有贡献者的努力。

更新内容 （中文）

不要从/到任何RC/Preview/Sprint版本进行升级，因为此操作不受支持。

本版本已解决的问题

功能

  • [BACKPORT][v1.10.2][FEATURE] 在快速故障转移模式下为 longhorn-share-manager 继承命名空间 12245 - @yangchiu
  • [BACKPORT][v1.10.2][FEATURE] [依赖项] aws-sdk-go v1.55.7 将于2025年7月31日终止支持——是否计划迁移至 v2？ 12181 - @mantissahz @roger-ryao

改进

  • [BACKPORT][v1.10.2][IMPROVEMENT] 修复由 VolumeAttachment Webhook 阻塞导致的 V2 卷 CSI 克隆缓慢问题 12329 - @PhanLe1010 @roger-ryao

缺陷

  • [BACKPORT] 副本重建、克隆和恢复失败，流量被发送至HTTP代理 12518 - @yangchiu @derekbit
  • [BACKPORT][v1.10.2][BUG] 减少卷的副本数量后，健康的副本可能被意外删除 12512 - @yangchiu @shuo-wu
  • [BACKPORT][v1.10.2][BUG] 在减少numberOfReplicas后，启用了数据局部性的卷无法移除已存在的运行副本 12509 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] 系统备份可能无法创建或删除 12479 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] questions.yaml中的一些默认设置放置不正确。 12222 - @derekbit @roger-ryao
  • [BACKPORT][v1.10.2][BUG] 自动平衡功能可能导致卷陷入副本删除-重建循环 12482 - @shuo-wu @roger-ryao
  • [BACKPORT][v1.10.2][BUG] 副本节点重启后，单副本卷可能陷入附加/分离循环 12494 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] 潜在的实例管理器客户端上下文泄露 12200 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] SnapshotBack代理请求可能被发送到错误的实例管理器Pod 12476 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] 升级过程中节点CR中未知的操作系统状态未被正确移除 12451 - @COLDTURNIP @roger-ryao
  • [BACKPORT][v1.10.2][BUG] 清空节点后，RWX卷变得不可用 12231 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] 如果卷从未被使用过，则不应重建v2卷。 12239 - @mantissahz
  • [BACKPORT][v1.10.2][BUG] 测试用例 test_recurring_jobs_when_volume_detached_unexpectedly 失败：备份已完成但进度未达到100% 12156 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] CSI节点发布卷期间挂载错误未被正确处理 12382 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] 加密卷无法在线扩展 12368 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] 自动生成的后端镜像Pod名称被kubelet报错 12357 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] tests.test_cloning.test_cloning_basic 在 master-head 上失败 12342 - @c3y1huang
  • [BACKPORT][v1.10.2][Bug] 克隆的卷无法附加到工作负载 12208 - @yangchiu @PhanLe1010
  • [BACKPORT][v1.10.2][BUG] 块模式卷迁移卡住 12312 - @COLDTURNIP @yangchiu @shuo-wu
  • [BACKPORT][v1.10.2][BUG] 副本自动平衡磁盘压力阈值在已停止的卷上停滞 12334 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] 强制启用短名称模式，但镜像名称longhornio/longhorn-manager:v1.10. │ │ 0 返回模糊列表 12270 - @yangchiu
  • [BACKPORT][v1.10.2][BUG] 引擎升级期间副本累积 12115 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] 潜在的 BackingImageManagerClient 连接和上下文泄露 12195 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] 当自动平衡设置为 best-effort 时，Longhorn 忽略 副本节点级别软反亲和性 12251 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] 无效的内存地址或空指针解引用（再次） 12234 - @chriscchien @bachmanity1
  • [BACKPORT][v1.10.2][BUG] 使用OIDC认证时，Web UI中出现请求头或Cookie过大的错误 12213 - @chriscchien @houhoucoop

贡献者

  • @COLDTURNIP
  • @PhanLe1010
  • @bachmanity1
  • @c3y1huang
  • @chriscchien
  • @derekbit
  • @houhoucoop
  • @innobead
  • @mantissahz
  • @roger-ryao
  • @shuo-wu
  • @yangchiu

更新内容 （原始）

DON’T UPGRADE from/to any RC/Preview/Sprint releases because the operation is not supported.

Resolved Issues in this release

Feature

  • [BACKPORT][v1.10.2][FEATURE] Inherit namespace for longhorn-share-manager in FastFailover mode 12245 - @yangchiu
  • [BACKPORT][v1.10.2][FEATURE] [Dependency] aws-sdk-go v1.55.7 is EOL as of 2025-07-31 — plan to migrate to v2? 12181 - @mantissahz @roger-ryao

Improvement

  • [BACKPORT][v1.10.2][IMPROVEMENT] Fix V2 Volume CSI Clone Slowness Caused by VolumeAttachment Webhook Blocking 12329 - @PhanLe1010 @roger-ryao

Bug

  • [BACKPORT] Replica rebuild, clone and restore fail, traffic being sent to HTTP proxy 12518 - @yangchiu @derekbit
  • [BACKPORT][v1.10.2][BUG] Healthy replica could be deleted unexpectedly after reducing volume’s number of replicas 12512 - @yangchiu @shuo-wu
  • [BACKPORT][v1.10.2][BUG] Data locality enabled volume fails to remove an existing running replica after numberOfReplicas reduced 12509 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] System backup may fail to be created or deleted 12479 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] Some default settings in questions.yaml are placed incorrectly. 12222 - @derekbit @roger-ryao
  • [BACKPORT][v1.10.2][BUG] Auto balance feature may lead to volumes falling into a replica deletion-recreation loop 12482 - @shuo-wu @roger-ryao
  • [BACKPORT][v1.10.2][BUG] Single replica volume could get stuck in attaching/detaching loop after the replica node rebooted 12494 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] Potential Instance Manager Client Context Leak 12200 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] SnapshotBack proxy request might be sent to incorrect instance-manager pod 12476 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] unknown OS condition in node CR is not properly removed during upgrade 12451 - @COLDTURNIP @roger-ryao
  • [BACKPORT][v1.10.2][BUG] RWX volume becomes unavailable after drain node 12231 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] Should not rebuild the v2 volume if this volume never be used. 12239 - @mantissahz
  • [BACKPORT][v1.10.2][BUG] Test case test_recurring_jobs_when_volume_detached_unexpectedly failed: backup completed but progress did not reach 100% 12156 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] mounting error is not properly hanedled during CSI node publish volume 12382 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] Encrypted Volume Cannot Be Expanded Online 12368 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] The auo generated backing image pod name is complained by kubelet 12357 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] tests.test_cloning.test_cloning_basic fails at msater-head 12342 - @c3y1huang
  • [BACKPORT][v1.10.2][Bug] A cloned volume cannot be attached to a workload 12208 - @yangchiu @PhanLe1010
  • [BACKPORT][v1.10.2][BUG] Block Mode Volume Migration Stuck 12312 - @COLDTURNIP @yangchiu @shuo-wu
  • [BACKPORT][v1.10.2][BUG] Replica auto balance disk pressure threshold stalled with stopped volumes 12334 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] short name mode is enforcing, but image name longhornio/longhorn-manager:v1.10. │ │ 0 returns ambiguous list 12270 - @yangchiu
  • [BACKPORT][v1.10.2][BUG] Replicas accumulate during engine upgrade 12115 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] Potential BackingImageManagerClient Connection and Context Leak 12195 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] Longhorn ignores Replica Node Level Soft Anti-Affinity when auto balance is set to best-effort 12251 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] invalid memory address or nil pointer dereference (again) 12234 - @chriscchien @bachmanity1
  • [BACKPORT][v1.10.2][BUG] Request Header Or Cookie Too Large in Web UI with OIDC auth 12213 - @chriscchien @houhoucoop

Contributors

  • @COLDTURNIP
  • @PhanLe1010
  • @bachmanity1
  • @c3y1huang
  • @chriscchien
  • @derekbit
  • @houhoucoop
  • @innobead
  • @mantissahz
  • @roger-ryao
  • @shuo-wu
  • @yangchiu

下载链接