发布日期: 2025-09-22
版本号: v1.9.2-rc2

该文档是Longhorn 1.9.2版本的发布说明，明确警告用户切勿从或向任何RC/Preview/Sprint版本进行升级，此操作不受支持。本版本包含了多项功能改进和缺陷修复。在改进方面，主要增加了安装变体的使用指标、优化了日志信息以便于排查问题、改进了备份前的目标检查机制、并使部分组件参数（如实例管理器的活跃探针）可配置。在缺陷修复方面，解决了从快照创建的卷在调整大小时可能发生的数据损坏、支持包生成卡顿、无法禁用v2数据引擎、卷在节点磁盘空间写满时可能进入故障状态、以及各类组件崩溃或功能异常等问题。文档最后列出了为此版本做出贡献的开发者名单。

更新内容 （中文）

请勿从任何RC/预览版/冲刺版进行升级或升级到这些版本，此操作不被支持。

本版本已解决的问题

改进

  • [BACKPORT][v1.9.2][改进] 添加Longhorn安装变体的使用指标 11805 - @derekbit
  • [BACKPORT][v1.9.2][改进] SAST检测longhorn-manager中controller/volume_controller.go可能存在的空指针解引用 11782 - @c3y1huang
  • [BACKPORT][v1.9.2][改进] 在支持包中收集挂载表、进程状态和进程表 11726 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][改进] 重命名后备镜像管理器以减少CR名称冲突概率 11567 - @COLDTURNIP @chriscchien
  • [BACKPORT][v1.9.2][改进] 改进longhorn-engine、tgt和liblonghorn的日志消息以方便故障排查 11604 - @yangchiu @derekbit
  • [BACKPORT][v1.9.2][改进] 修正误导性日志消息 “Deleting orphans on evicted node …” 11501 - @yangchiu @derekbit
  • [BACKPORT][v1.9.2][改进] 在创建备份、后备镜像备份和系统备份前检查备份目标是否可用 11324 - @yangchiu @nzhan126
  • [BACKPORT][v1.9.2][改进] 调整后备镜像下载的硬编码超时限制 11310 - @COLDTURNIP @chriscchien
  • [BACKPORT][v1.9.2][改进] 改进longhorn-engine控制器日志消息 11508 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][改进] 使instance-manager Pod的存活性探针参数可配置 11506 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][改进] 后备镜像处理节点磁盘删除事件 11488 - @COLDTURNIP @chriscchien
  • [BACKPORT][v1.9.2][改进] 处理包含混合无效条件的凭证密钥 11327 - @yangchiu @nzhan16
  • [BACKPORT][v1.9.2][改进] 改进引擎镜像检查的条件消息 11193 - @derekbit @chriscchien

错误

  • [BACKPORT][v1.9.2][错误] 从快照创建的卷在调整大小过程中可能发生数据损坏 11788 - @yangchiu @PhanLe1010
  • [错误] [v1.9.x] 支持包卡在33%进度 11744 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][错误] 即使没有v2卷、后备镜像或孤立数据也无法禁用v2数据引擎 11639 - @shuo-wu @chriscchien
  • [BACKPORT][v1.9.2][错误] Longhorn PVC处于挂起状态 11722 - @yangchiu @derekbit
  • [错误] 文档中的失效链接 11729 - @consideRatio
  • [BACKPORT][v1.9.2][错误] longhornctl预检安装应加载并检查iscsi_tcp内核模块 11710 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][错误] 网络断开后后备镜像下载卡住 11624 - @COLDTURNIP
  • [BACKPORT][v1.9.2][错误] 卷的副本节点磁盘在写操作期间空间耗尽导致卷故障 11341 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][错误] 卷快速分离后引擎进程继续运行 11606 - @COLDTURNIP @yangchiu @chriscchien
  • [BACKPORT][v1.9.2][错误] 创建2Gi卷使用200Mi后备镜像时被拒绝，提示"卷大小应大于后备镜像大小" 11648 - @COLDTURNIP @yangchiu @chriscchien
  • [BACKPORT][v1.9.2][错误] longhorn-manager反复输出"No instance manager for node xxx for update instance state of orphan instance orphan-xxx.." 11599 - @COLDTURNIP @chriscchien
  • [BACKPORT][v1.9.2][错误] BackupBackingImage可能从未就绪的BackingImageManager创建 11692 - @WebberHuang1118 @roger-ryao
  • [BACKPORT][v1.9.2][错误] Longhorn在ARM平台无法创建后备镜像备份 11570 - @COLDTURNIP
  • [BACKPORT][v1.9.2][错误] 节点CR中残留未知的OS条件 11614 - @COLDTURNIP @roger-ryao
  • [BACKPORT][v1.9.2][错误] 卷变为只读时无法重新挂载 11584 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][错误] 实时迁移意外终止时卷状态悬挂 11590 - @PhanLe1010 @chriscchien
  • [BACKPORT][v1.9.2][错误] 在存储网络环境中无法设置备份目标：找不到节点的运行实例管理器 11482 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][错误] 测试用例test_recurring_jobs_when_volume_detached_unexpectedly失败：备份完成但进度未达100% 11476 - @yangchiu @mantissahz
  • [BACKPORT][v1.9.2][错误] 使用’default’组的周期性任务导致v1.9.1版本goroutine死锁（#11020的回归） 11494 - @c3y1huang
  • [BACKPORT][v1.9.2][错误] 测试用例test_replica_auto_balance_node_least_effort有时失败 11391 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][错误] 如果备份已存在则无法设置S3备份目标 11344 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][错误] longhorn-manager因SIGSEGV: segmentation violation崩溃 11422 - @derekbit @roger-ryao
  • [BACKPORT][v1.9.2][错误] 配置参数拼写错误：“offlineRelicaRebuilding"应为"offlineReplicaRebuilding” 11382 - @yangchiu

贡献者

  • @COLDTURNIP
  • @PhanLe1010
  • @WebberHuang1118
  • @c3y1huang
  • @chriscchien
  • @consideRatio
  • @derekbit
  • @innobead
  • @mantissahz
  • @nzhan126
  • @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

Improvement

  • [BACKPORT][v1.9.2][IMPROVEMENT] Add usage metrics for Longhorn installation variant 11805 - @derekbit
  • [BACKPORT][v1.9.2][IMPROVEMENT] SAST Potential dereference of the null pointer in controller/volume_controller.go in longhorn-manager 11782 - @c3y1huang
  • [BACKPORT][v1.9.2][IMPROVEMENT] Collect mount table, process status and process table in support bundle 11726 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][IMPROVEMENT] rename the backing image manager to reduce the probability of CR name collision 11567 - @COLDTURNIP @chriscchien
  • [BACKPORT][v1.9.2][IMPROVEMENT] Improve log messages of longhorn-engine, tgt and liblonghorn for troubleshooting 11604 - @yangchiu @derekbit
  • [BACKPORT][v1.9.2][IMPROVEMENT] Misleading log message Deleting orphans on evicted node ... 11501 - @yangchiu @derekbit
  • [BACKPORT][v1.9.2][IMPROVEMENT] Check if the backup target is available before creating a backup, backup backing image, and system backup 11324 - @yangchiu @nzhan126
  • [BACKPORT][v1.9.2][IMPROVEMENT] adjust the hardcoded timeout limitation for backing image downloading 11310 - @COLDTURNIP @chriscchien
  • [BACKPORT][v1.9.2][IMPROVEMENT] Improve longhorn-engine controller log messages 11508 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][IMPROVEMENT] Make liveness probe parameters of instance-manager pod configurable 11506 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][IMPROVEMENT] backing image handle node disk deleting events 11488 - @COLDTURNIP @chriscchien
  • [BACKPORT][v1.9.2][IMPROVEMENT] Handle credential secret containing mixed invalid conditions 11327 - @yangchiu @nzhan126
  • [BACKPORT][v1.9.2][IMPROVEMENT] Improve the condition message of engine image check 11193 - @derekbit @chriscchien

Bug

  • [BACKPORT][v1.9.2][BUG] Potential Data Corruption During Volume Resizing When Created from Snapshot 11788 - @yangchiu @PhanLe1010
  • [BUG] [v1.9.x] support bundle stuck at 33% 11744 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][BUG] Unable to disable v2-data-engine even though there is no v2 volumes, backing images or orphaned data 11639 - @shuo-wu @chriscchien
  • [BACKPORT][v1.9.2][BUG] Longhorn pvcs are in pending state. 11722 - @yangchiu @derekbit
  • [BUG] Broken link in documentation 11729 - @consideRatio
  • [BACKPORT][v1.9.2][BUG] longhornctl preflight install should load and chec iscsi_tcp kernel module. 11710 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][BUG] Backing image download gets stuck after network disconnection 11624 - @COLDTURNIP
  • [BACKPORT][v1.9.2][BUG] Volume becomes faulted when its replica node disks run out of space during a write operation 11341 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][BUG] Engine process continues running after rapid volume detachment 11606 - @COLDTURNIP @yangchiu @chriscchien
  • [BACKPORT][v1.9.2][BUG] Creating a 2 Gi volume with a 200 Mi backing image is rejected with “volume size should be larger than the backing image size” 11648 - @COLDTURNIP @yangchiu @chriscchien
  • [BACKPORT][v1.9.2][BUG] longhorn-manager repeatedly emits No instance manager for node xxx for update instance state of orphan instance orphan-xxx.. 11599 - @COLDTURNIP @chriscchien
  • [BACKPORT][v1.9.2][BUG] BackupBackingImage may be created from an unready BackingImageManager 11692 - @WebberHuang1118 @roger-ryao
  • [BACKPORT][v1.9.2][BUG] Longhorn fails to create Backing Image Backup on ARM platform 11570 - @COLDTURNIP
  • [BACKPORT][v1.9.2][BUG] remaining unknown OS condition in node CR 11614 - @COLDTURNIP @roger-ryao
  • [BACKPORT][v1.9.2][BUG] Volumes fails to remount when they go read-only 11584 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][BUG] Dangling Volume State When Live Migration Terminates Unexpectedly 11590 - @PhanLe1010 @chriscchien
  • [BACKPORT][v1.9.2][BUG] Unable to setup backup target in storage network environment: cannot find a running instance manager for node 11482 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][BUG] Test case test_recurring_jobs_when_volume_detached_unexpectedly failed: backup completed but progress did not reach 100% 11476 - @yangchiu @mantissahz
  • [BACKPORT][v1.9.2][BUG] Recurring Job with ‘default’ group causes goroutine deadlock on v1.9.1 (Regression of #11020) 11494 - @c3y1huang
  • [BACKPORT][v1.9.2][BUG] Test Case test_replica_auto_balance_node_least_effort Is Sometimes Failed 11391 - @derekbit @chriscchien
  • [BACKPORT][v1.9.2][BUG] Unable to set up S3 backup target if backups already exist 11344 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.2][BUG] longhorn-manager is crashed due to SIGSEGV: segmentation violation 11422 - @derekbit @roger-ryao
  • [BACKPORT][v1.9.2][BUG] Typo in configuration parameter: “offlineRelicaRebuilding” should be “offlineReplicaRebuilding” 11382 - @yangchiu

Contributors

  • @COLDTURNIP
  • @PhanLe1010
  • @WebberHuang1118
  • @c3y1huang
  • @chriscchien
  • @consideRatio
  • @derekbit
  • @innobead
  • @mantissahz
  • @nzhan126
  • @roger-ryao
  • @shuo-wu
  • @yangchiu

下载链接