发布日期: 2026-07-16
版本号: v1.12.1-rc1

请勿从任何RC/预览/测试版本升级至或从此版本升级，因该操作不受支持。本版本主要包含多项重要更新：正式支持v2数据引擎，并引入v2数据引擎分片及快速克隆功能；新增Kubernetes CPU管理器支持，允许配置持久化巨页及调整SPDK网络与通信设置；同时修复了大量问题，涉及卷扩容、备份恢复、加密卷操作、存储网络兼容性及系统稳定性等。本次更新汇集了众多贡献者的工作成果。

更新内容 （中文）

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

此版本中已解决的问题

亮点

  • [向后移植][v1.12.1][功能] V2 数据引擎分片 - 实验性 13176 - @c3y1huang @chriscchien
  • [功能] 支持 v2 数据引擎（正式发布） 6229 - @derekbit
  • [向后移植][v1.12.1][功能] V2 数据引擎快速克隆 13174 - @shuo-wu

功能

  • [向后移植][v1.12.1][功能] 支持 Kubernetes CPU Manager 用于 Longhorn V2 实例管理器 SPDK CPU 分配 13320 - @yangchiu @mantissahz @Copilot

改进

  • [向后移植][v1.12.1][改进] 允许使用 longhornctl 持久化大页数量 13535 - @bachmanity1
  • [向后移植][v1.12.1][改进] 将主机 RPS 从 SPDK 反应器核心引导开 13502 - @bachmanity1 @roger-ryao
  • [向后移植][v1.12.1][改进] 始终为内部通信设置 NetworkPolicy 13439 - @COLDTURNIP @roger-ryao
  • [向后移植][v1.12.1][改进] 即使方法未更改，updateBackupCompressionMethod 也可能写入卷 13480 - @yangchiu
  • [向后移植][v1.12.1][改进] 添加指标以收集有关 V2 数据引擎使用情况的信息 13262 - @derekbit @chriscchien
  • [向后移植][v1.12.1][改进] 提高卷附加失败的错误透明度 13431 - @derekbit @chriscchien
  • [向后移植][v1.12.1][改进] 允许配置 SPDK iobuf 大型池大小 13415 - @chriscchien @bachmanity1
  • [向后移植][v1.12.1][改进] V2 卷在迁移过程中移除副本时出现写 I/O 暂停（约 10 秒） 13310 - @hookak @chriscchien
  • [向后移植][v1.12.1][改进] 支持实例管理器中剩余 gRPC 服务的 mTLS 加密通信 13299 - @COLDTURNIP @yangchiu
  • [向后移植][v1.12.1][改进] 添加指标以收集有关 LONGHORN_DISTRO 的信息 13253 - @derekbit @chriscchien

缺陷

  • [向后移植][v1.12.1][缺陷] GUI 中的错误 Web 链接 13539 - @yangchiu @sushant-suse
  • [向后移植][v1.12.1][缺陷] 如果先前的备份已损坏，则无法从完整备份还原卷 13538 - @mantissahz
  • [向后移植][v1.12.1][缺陷] 加密的 V2 卷大小比声明的大小短 16MB 13175 - @mantissahz
  • [向后移植][v1.12.1][缺陷] V2 数据引擎：UBLK 在 Linux 内核 6.17.0 上因 EINVAL 失败 13274 - @chriscchien @carterli0407-cell
  • [向后移植][v1.12.1][缺陷] 在 Harvester 中启用 LH V2 后内核工作队列锁定和 RKE2 服务不稳定 13495 - @derekbit @chriscchien
  • [向后移植][v1.12.1][缺陷] V2 扩容可能报告成功，但引擎仍保持旧大小 13380 - @davidcheng0922 @chriscchien
  • [向后移植][v1.12.1][缺陷] 在内核 >= 6.12 上从未检测到 FilesystemReadOnly — ext4 报告 emergency_ro，而非 ro；只读自动重新挂载静默失效 13482 - @yangchiu
  • [向后移植][v1.12.1][缺陷] csi.ReplicaCount Helm 值在现有的 csi- 部署上静默无效（仅在首次创建时应用） 13465 - @roger-ryao
  • [向后移植][v1.12.1][缺陷] v2 卷在自动重新附加后可能再次崩溃 13337 - @shuo-wu @roger-ryao
  • [向后移植][v1.12.1][缺陷] 启用存储网络时无法附加 V2 卷 13490 - @c3y1huang
  • [向后移植][v1.12.1][缺陷] v2 卷重复副本重用失败 13336 - @shuo-wu @chriscchien
  • [向后移植][v1.12.1][缺陷] V2 加密卷还原失败 13365 - @mantissahz @roger-ryao
  • [向后移植][v1.12.1][缺陷] Longhorn 1.12.0：AWS 分块编码不支持 OCI S3 存储桶 13478 - @mantissahz
  • [向后移植][v1.12.1][缺陷] 无法使用 virtio-scsi BDF 路径添加 v2 块磁盘 13475 - @carterli0407-cell
  • [向后移植][v1.12.1][缺陷] V2 备份/快照可能导致 NVMe/TCP 前端或 dm 设备过期，导致附加卷上的 Pod EIO 13332 - @davidcheng0922 @chriscchien
  • [向后移植][v1.12.1][缺陷] (图表) 使用 Gateway API 时 ArgoCD OutOfSync 13446 - @yangchiu
  • [向后移植][v1.12.1][缺陷] 如果目标节点仍处于就绪转换中，迁移引擎可能被意外删除 13367 - @COLDTURNIP @yangchiu
  • [向后移植][v1.12.1][缺陷] 定期修剪作业因死锁而失败 13425 - @c3y1huang @roger-ryao
  • [向后移植][v1.12.1][缺陷] 卷扩容卡住 13368 - @shuo-wu @chriscchien
  • [向后移植][v1.12.1][缺陷] iscsid 重启后 PVC 调整大小失败 13412 - @yangchiu @shuo-wu
  • [向后移植][v1.12.1][缺陷] 扩展卷失败 13384 - @chriscchien
  • [向后移植][v1.12.1][缺陷] 测试用例 test_rwx_delete_share_manager_pod 失败，因为删除并重启后无法在共享管理器 Pod 中找到导出的卷 13226 - @davidcheng0922 @roger-ryao
  • [向后移植][v1.12.1][缺陷] 系统备份 RecurringJob 保留会修剪最新的 CR — 按 Status.CreatedAt 排序（对于 Error/竞态 CR 为零） 13209 - @roger-ryao
  • [向后移植][v1.12.1][缺陷] 升级期间 CSI 组件可能有 0 个运行副本 13348 - @yangchiu @carterli0407-cell
  • [向后移植][v1.12.1][缺陷] 节点更新强制完全重建 13357 - @mantissahz
  • [向后移植][v1.12.1][缺陷] 为 v2 卷创建备份可能失败 13191 - @mantissahz
  • [向后移植][v1.12.1][缺陷] 将备份上传到 S3 存储（NetApp 设备）时失败 13297 - @mantissahz
  • [向后移植][v1.12.1][缺陷] chart/values.yaml 中缺少 spdk 中断模式值 13269 - @yangchiu
  • [向后移植][v1.12.1][缺陷] 测试用例 test_best_effort_data_locality 失败，因为创建的卷没有副本 13225 - @carterli0407-cell

杂项

  • [向后移植][v1.12.1][缺陷] 启用存储网络时 v2 卷卡在 attaching，因为 EngineFrontend 目标使用引擎 Pod IP 而不是 StorageIP 13353 - @yangchiu @c3y1huang

贡献者

  • @COLDTURNIP
  • @Copilot
  • @bachmanity1
  • @c3y1huang
  • @carterli0407-cell
  • @chriscchien
  • @davidcheng0922
  • @derekbit
  • @github-actions[bot]
  • @hookak
  • @innobead
  • @mantissahz
  • @roger-ryao
  • @shuo-wu
  • @sushant-suse
  • @yangchiu

更新内容 （原始）

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

Resolved Issues in this release

Highlight

  • [BACKPORT][v1.12.1][FEATURE] V2 Data Engine Sharding - Experimental 13176 - @c3y1huang @chriscchien
  • [FEATURE] Support v2 Data Engine (GA) 6229 - @derekbit
  • [BACKPORT][v1.12.1][FEATURE] V2 Data Engine Fast Cloning 13174 - @shuo-wu

Feature

  • [BACKPORT][v1.12.1][FEATURE] Support Kubernetes CPU Manager for Longhorn V2 instance-manager SPDK CPU assignment 13320 - @yangchiu @mantissahz @Copilot

Improvement

  • [BACKPORT][v1.12.1][IMPROVEMENT] Allow persisting number of hugepages using longhornctl 13535 - @bachmanity1
  • [BACKPORT][v1.12.1][IMPROVEMENT] Steer host RPS away from SPDK reactor cores 13502 - @bachmanity1 @roger-ryao
  • [BACKPORT][v1.12.1][IMPROVEMENT] always setup NetworkPolicy for the internal communication 13439 - @COLDTURNIP @roger-ryao
  • [BACKPORT][v1.12.1][IMPROVEMENT] updateBackupCompressionMethod may write the Volume even when the method is unchanged 13480 - @yangchiu
  • [BACKPORT][v1.12.1][IMPROVEMENT] Add metrics to collect information about V2 data engine usage 13262 - @derekbit @chriscchien
  • [BACKPORT][v1.12.1][IMPROVEMENT] Improving error transparency for volume attachment failure 13431 - @derekbit @chriscchien
  • [BACKPORT][v1.12.1][IMPROVEMENT] Allow configuring SPDK iobuf large pool size 13415 - @chriscchien @bachmanity1
  • [BACKPORT][v1.12.1][IMPROVEMENT] V2 volume write I/O stalls(~10s) when a replica is removed during migration 13310 - @hookak @chriscchien
  • [BACKPORT][v1.12.1][IMPROVEMENT] Support mTLS encrypted communication for remaining gRPC services in instance manager 13299 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.12.1][IMPROVEMENT] Add metrics to collect information about LONGHORN_DISTRO 13253 - @derekbit @chriscchien

Bug

  • [BACKPORT][v1.12.1][BUG] Incorrect Web Link in GUI 13539 - @yangchiu @sushant-suse
  • [BACKPORT][v1.12.1][BUG] Fail to restore a volume from a full backup if a previous backup is corrupted 13538 - @mantissahz
  • [BACKPORT][v1.12.1][BUG] Encrypted V2 volume size is 16MB short of the claimed size 13175 - @mantissahz
  • [BACKPORT][v1.12.1][BUG] V2 Data Engine: UBLK fails with EINVAL on Linux kernel 6.17.0 13274 - @chriscchien @carterli0407-cell
  • [BACKPORT][v1.12.1][BUG] Kernel Workqueue Lockup and Unstable RKE2 Service After Enabling LH V2 in Harvester 13495 - @derekbit @chriscchien
  • [BACKPORT][v1.12.1][BUG] V2 expansion can report success while the engine remains at the old size 13380 - @davidcheng0922 @chriscchien
  • [BACKPORT][v1.12.1][BUG] FilesystemReadOnly never detected on kernel >= 6.12 — ext4 reports emergency_ro, not ro; read-only auto-remount silently inoperative 13482 - @yangchiu
  • [BACKPORT][v1.12.1][BUG] csi.ReplicaCount Helm values silently no-op on existing csi- deployments (only applied at first creation) 13465 - @roger-ryao
  • [BACKPORT][v1.12.1][BUG] v2 volume may crash again after the auto reattachment 13337 - @shuo-wu @roger-ryao
  • [BACKPORT][v1.12.1][BUG] V2 Volume Cannot Be Attached When the Storage Network Is Enabled 13490 - @c3y1huang
  • [BACKPORT][v1.12.1][BUG] v2 volume repeated replica reuse failure 13336 - @shuo-wu @chriscchien
  • [BACKPORT][v1.12.1][BUG] V2 Encrypted Volume Restore Fails 13365 - @mantissahz @roger-ryao
  • [BACKPORT][v1.12.1][BUG] Longhorn 1.12.0: AWS chunked encoding not supported with OCI S3 buckets 13478 - @mantissahz
  • [BACKPORT][v1.12.1][BUG] Failed to add v2 block disk with virtio-scsi BDF path 13475 - @carterli0407-cell
  • [BACKPORT][v1.12.1][BUG] V2 backup/snapshot can leave NVMe/TCP frontend or dm device stale, causing pod EIO on attached volumes 13332 - @davidcheng0922 @chriscchien
  • [BACKPORT][v1.12.1][BUG] (chart) ArgoCD OutOfSync when using Gateway API 13446 - @yangchiu
  • [BACKPORT][v1.12.1][BUG] Migration Engine Can Be Unexpectedly Deleted If the Target Node Is Still in Readiness Transition 13367 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.12.1][BUG] Recurring trim job fails with deadlock 13425 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.12.1][BUG] volume expansion stuck 13368 - @shuo-wu @chriscchien
  • [BACKPORT][v1.12.1][BUG] pvc resize fails after iscsid restart 13412 - @yangchiu @shuo-wu
  • [BACKPORT][v1.12.1][BUG] expanding the volume fails 13384 - @chriscchien
  • [BACKPORT][v1.12.1][BUG] Test case test_rwx_delete_share_manager_pod fails because it’s unable to find the exported volume in share manager pod after it’s deleted and restarted 13226 - @davidcheng0922 @roger-ryao
  • [BACKPORT][v1.12.1][BUG] System Backup RecurringJob retention prunes newest CR — sorts by Status.CreatedAt (zero for Error/racing CRs) 13209 - @roger-ryao
  • [BACKPORT][v1.12.1][BUG] CSI components may have 0 running replica during upgrade 13348 - @yangchiu @carterli0407-cell
  • [BACKPORT][v1.12.1][BUG] Node update forces a complete rebuild 13357 - @mantissahz
  • [BACKPORT][v1.12.1][BUG] Creating backup for a v2 volume may fail 13191 - @mantissahz
  • [BACKPORT][v1.12.1][BUG] when uploading backup to S3 storage (NetApp appliance) it fails 13297 - @mantissahz
  • [BACKPORT][v1.12.1][BUG] spdk interrupt mode value is missing in chart/values.yaml 13269 - @yangchiu
  • [BACKPORT][v1.12.1][BUG] Test case test_best_effort_data_locality fails because there is no replica for the created volume 13225 - @carterli0407-cell

Misc

  • [BACKPORT][v1.12.1][BUG] v2 volume stuck attaching with Storage Network enabled because the EngineFrontend target uses the engine pod IP instead of StorageIP 13353 - @yangchiu @c3y1huang

Contributors

  • @COLDTURNIP
  • @Copilot
  • @bachmanity1
  • @c3y1huang
  • @carterli0407-cell
  • @chriscchien
  • @davidcheng0922
  • @derekbit
  • @github-actions[bot]
  • @hookak
  • @innobead
  • @mantissahz
  • @roger-ryao
  • @shuo-wu
  • @sushant-suse
  • @yangchiu

下载链接