发布日期: 2025-07-23
版本号: v1.9.1

Longhorn v1.9.1 发布包含多项改进和错误修复，旨在提升系统质量、韧性、稳定性和安全性。安装或从早期版本（如 v1.8.x 或 v1.9.x < v1.9.1）升级至 v1.9.1 之前，必须确保集群运行 Kubernetes v1.25 或更高版本。此版本解决了多项功能、改进和错误问题，涉及标准化的容器镜像覆盖与拉取密钥指定方式、多项日志与条件消息优化、系统备份与卷扩展错误修复、UI 问题修复以及节点恢复时的副本重建逻辑改进等。本次发布还感谢了多位贡献者的参与，其中包括新成员。

更新内容 （中文）

Longhorn v1.9.1 版本说明

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

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

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

安装

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

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

升级

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

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

发布后已知问题

有关此发布后识别的问题的信息，请参阅发布已知问题。

已解决的问题

功能

  • [向后移植][v1.9.1][功能] 标准化覆盖容器镜像仓库的方式 11068 - @marcosbc @roger-ryao
  • [向后移植][v1.9.1][功能] 标准化指定镜像拉取密钥的方式 11072 - @marcosbc @chriscchien

改进

  • [向后移植][v1.9.1][改进] 移除 CRD 的 preserveUnknownFields: false 补丁 11280 - @derekbit @chriscchien
  • [向后移植][v1.9.1][改进] 改进磁盘空间不可调度条件消息 11212 - @yangchiu @davidcheng0922
  • [向后移植][v1.9.1][改进] 改进引擎镜像检查的条件消息 11196 - @derekbit @chriscchien
  • [向后移植][v1.9.1][改进] 改进在同一备份目标上检测到同一卷的多个备份卷时的日志记录 11225 - @PhanLe1010 @chriscchien
  • [向后移植][v1.9.1][改进] 集群裂脑期间可能会创建额外的无效 BackupVolumeCR 11168 - @mantissahz @roger-ryao
  • [向后移植][v1.9.1][改进] 节点宕机一段时间后恢复时进行完整副本重建 11069 - @mantissahz
  • [向后移植][v1.9.1][改进] 为 longhorn-csi-plugin 尝试连接 longhorn-manager Pod 时添加重试逻辑 10914 - @PhanLe1010 @roger-ryao

错误

  • [向后移植][v1.9.1][错误] longhorn chart/values.yaml 中 remove-snapshots-during-filesystem-trim 的值不正确 11266 - @derekbit @chriscchien
  • [向后移植][v1.9.1][错误] 覆盖特定镜像仓库时 privateRegistry.registryUrl 不起作用 11258 - @marcosbc @chriscchien
  • [向后移植][v1.9.1][错误] 系统备份错误 11235 - @c3y1huang @roger-ryao
  • [向后移植][v1.9.1][错误] 卷扩展失败，提示“不支持的磁盘加密格式 ext4” 11184 - @COLDTURNIP @mantissahz @roger-ryao
  • [向后移植][v1.9.1][错误] Longhorn 文档中的备份 YAML 示例不起作用 11217 - @mantissahz @nzhan126
  • [向后移植][v1.9.1][错误] CSI 插件重启会触发可迁移 RWX 卷工作负载意外重启 11164 - @c3y1huang @roger-ryao
  • [向后移植][v1.9.1][错误] 在浏览器 UI 中：卷 -> 克隆卷会导致浏览器页面损坏 11180 - @houhoucoop @roger-ryao
  • [向后移植][v1.9.1][错误] 测试用例 test_engine_image_not_fully_deployed_perform_volume_operations 失败：无法分离卷 10917 - @mantissahz @chriscchien
  • [向后移植][v1.9.1][错误] 创建支持包时出现空指针异常崩溃 11170 - @c3y1huang @roger-ryao
  • [向后移植][v1.9.1][错误] 由于 CMAKE 兼容性问题，无法构建 Longhorn-Share-Manager 镜像 11162 - @derekbit @roger-ryao
  • [向后移植][v1.9.1][错误] 周期性作业分配给默认组时失败 11020 - @c3y1huang @chriscchien
  • [向后移植][v1.9.1][错误] SPDK API bdev_lvol_detach_parent 未按预期工作 11047 - @DamiaSan @roger-ryao
  • [向后移植][v1.9.1][错误] 节点驱逐后无法清理基础镜像卷副本 11056 - @COLDTURNIP @roger-ryao
  • [向后移植][v1.9.1][错误] 驱逐节点期间基础镜像卷副本出现空指异常崩溃 11035 - @COLDTURNIP @chriscchien

其他事项

  • [热修复] 为 longhorn-manager:v1.9.0 创建热修复镜像 11140 - @derekbit @chriscchien
  • [向后移植][v1.9.1][任务] 确保支持包构建使用已提交的依赖项 11118 - @yangchiu @c3y1huang

新贡献者

  • @davidcheng0922
  • @marcosbc
  • @nzhan126

贡献者

  • @COLDTURNIP
  • @DamiaSan
  • @PhanLe1010
  • @c3y1huang
  • @chriscchien
  • @derekbit
  • @houhoucoop
  • @innobead
  • @mantissahz
  • @roger-ryao
  • @yangchiu
  • @sushant-suse
  • @rebeccazzzz
  • @forbesguthrie
  • @asettle

更新内容 （原始）

Longhorn v1.9.1 Release Notes

Longhorn 1.9.1 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.1.

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.1) to v1.9.1.

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

Feature

  • [BACKPORT][v1.9.1][FEATURE] Standardized way to override container image registry 11068 - @marcosbc @roger-ryao
  • [BACKPORT][v1.9.1][FEATURE] Standardized way to specify image pull secrets 11072 - @marcosbc @chriscchien

Improvement

  • [BACKPORT][v1.9.1][IMPROVEMENT] Remove the Patch preserveUnknownFields: false for CRDs 11280 - @derekbit @chriscchien
  • [BACKPORT][v1.9.1][IMPROVEMENT] Improve the disk space un-schedulable condition message 11212 - @yangchiu @davidcheng0922
  • [BACKPORT][v1.9.1][IMPROVEMENT] Improve the condition message of engine image check 11196 - @derekbit @chriscchien
  • [BACKPORT][v1.9.1][IMPROVEMENT] Improve the logging when detecting multiple backup volumes of the same volume on the same backup target 11225 - @PhanLe1010 @chriscchien
  • [BACKPORT][v1.9.1][IMPROVEMENT] extra invalid BackupVolumeCR may be created during cluster split-brain 11168 - @mantissahz @roger-ryao
  • [BACKPORT][v1.9.1][IMPROVEMENT] Full replica rebuilding when a node goes down for a while and then comes back 11069 - @mantissahz
  • [BACKPORT][v1.9.1][IMPROVEMENT] Adding retry logic for longhorn-csi-plugin when it trying to contact the longhorn-manager pods 10914 - @PhanLe1010 @roger-ryao

Bug

  • [BACKPORT][v1.9.1][BUG] Incorrect value of remove-snapshots-during-filesystem-trim in longhorn chart/values.yaml 11266 - @derekbit @chriscchien
  • [BACKPORT][v1.9.1][BUG] privateRegistry.registryUrl does not work when overriding specific image registries 11258 - @marcosbc @chriscchien
  • [BACKPORT][v1.9.1][BUG] system backup error 11235 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.9.1][BUG] Volume expansion fails with “unsupported disk encryption format ext4” 11184 - @COLDTURNIP @mantissahz @roger-ryao
  • [BACKPORT][v1.9.1][BUG] The Backup YAML example in the Longhorn doc does not work 11217 - @mantissahz @nzhan126
  • [BACKPORT][v1.9.1][BUG] CSI Plugin restart triggers unintended restart of migratable RWX volume workloads 11164 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.9.1][BUG] in the browser UI: Volume -> Clone Volume results in the broken browser page 11180 - @houhoucoop @roger-ryao
  • [BACKPORT][v1.9.1][BUG] Test case test_engine_image_not_fully_deployed_perform_volume_operations failed: unable to detach a volume 10917 - @mantissahz @chriscchien
  • [BACKPORT][v1.9.1][BUG] Creating support-bundle panic NPE 11170 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.9.1][BUG] Unable to Build Longhorn-Share-Manager Image Due to CMAKE Compatibility 11162 - @derekbit @roger-ryao
  • [BACKPORT][v1.9.1][BUG] Recurring jobs fail when assigned to default group 11020 - @c3y1huang @chriscchien
  • [BACKPORT][v1.9.1][BUG] SPDK API bdev_lvol_detach_parent does not work as expected 11047 - @DamiaSan @roger-ryao
  • [BACKPORT][v1.9.1][BUG] unable to clean up the backing image volume replica after node eviction 11056 - @COLDTURNIP @roger-ryao
  • [BACKPORT][v1.9.1][BUG] backing image volume replica NPE crash during evicting node 11035 - @COLDTURNIP @chriscchien

Misc

  • [HOTFIX] Create hotfixed image for longhorn-manager:v1.9.0 11140 - @derekbit @chriscchien
  • [BACKPORT][v1.9.1][TASK] Ensure support-bundle-kit builds use vendored dependencies 11118 - @yangchiu @c3y1huang

New Contributors

  • @davidcheng0922
  • @marcosbc
  • @nzhan126

Contributors

  • @COLDTURNIP
  • @DamiaSan
  • @PhanLe1010
  • @c3y1huang
  • @chriscchien
  • @derekbit
  • @houhoucoop
  • @innobead
  • @mantissahz
  • @roger-ryao
  • @yangchiu
  • @sushant-suse
  • @rebeccazzzz
  • @forbesguthrie
  • @asettle

下载链接