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

Longhorn v1.9.2 版本发布了一系列改进和错误修复，旨在提升系统的整体质量、恢复能力、稳定性和安全性。安装或升级此版本前，请确保您的 Kubernetes 集群版本为 v1.25 或更高。具体的安装方法与升级路径可参考官方文档。此版本包含多项改进，例如增强了日志信息、改进了备份检查机制、优化了名称管理等，并修复了可能涉及数据损坏、服务挂起、兼容性问题等在内的多个关键缺陷。详细的已知问题、解决方案以及完整的改进和修复列表，请查阅官方的发布说明与问题跟踪页面。

更新内容 （中文）

Longhorn v1.9.2 发行说明

Longhorn 1.9.2 引入了多项改进和错误修复，旨在提升系统质量、弹性、稳定性和安全性。

Longhorn 团队感谢您的贡献，并期待收到关于此版本的反馈。

[!NOTE] 有关发布相关术语的更多信息，请参阅 发布版本。

安装

[!IMPORTANT] 安装 Longhorn v1.9.2 前，请确保您的集群运行的是 Kubernetes v1.25 或更高版本。

您可以使用多种工具安装 Longhorn，包括 Rancher、Kubectl 和 Helm。有关安装方法和要求的更多信息，请参阅 Longhorn 文档中的 快速安装。

升级

[!IMPORTANT] 从 Longhorn v1.8.x 或 v1.9.x (< v1.9.2) 升级到 v1.9.2 前，请确保您的集群运行的是 Kubernetes v1.25 或更高版本。

Longhorn 仅支持从受支持的版本进行升级。有关升级路径和流程的更多信息，请参阅 Longhorn 文档中的 升级。

发布后已知问题

有关此版本发布后发现的问题，请参阅 发布已知问题。

已修复问题

改进

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

错误

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

新贡献者

  • @consideRatio

贡献者

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

更新内容 （原始）

Longhorn v1.9.2 Release Notes

Longhorn 1.9.2 introduces several improvements and bug fixes that are intended to improve system quality, resilience, stability and security.

The Longhorn team appreciates your contributions and expects to receive feedback regarding this release.

[!NOTE] For more information about release-related terminology, see Releases.

Installation

[!IMPORTANT] Ensure that your cluster is running Kubernetes v1.25 or later before installing Longhorn v1.9.2.

You can install Longhorn using a variety of tools, including Rancher, Kubectl, and Helm. For more information about installation methods and requirements, see Quick Installation in the Longhorn documentation.

Upgrade

[!IMPORTANT] Ensure that your cluster is running Kubernetes v1.25 or later before upgrading from Longhorn v1.8.x or v1.9.x (< v1.9.2) to v1.9.2.

Longhorn only allows upgrades from supported versions. For more information about upgrade paths and procedures, see Upgrade in the Longhorn documentation.

Post-Release Known Issues

For information about issues identified after this release, see Release-Known-Issues.

Resolved Issues

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 check 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
  • [BUG][UI][v1.9.2-rc2] Unable to Retrieve Volume’s Backup List in the Operation 11841 - @houhouhoucoop @roger-ryao

New Contributors

  • @consideRatio

Contributors

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

下载链接