发布日期: 2025-01-03
版本号: v1.6.4

Longhorn v1.6.4 版本发布，主要包含系统质量、弹性和稳定性的改进与问题修复。安装或升级前需确保 Kubernetes 集群版本为 v1.21 或更高。此版本支持通过 Rancher、Kubectl 和 Helm 等多种工具安装，仅允许从支持的旧版本升级。关键改进包括：支持 Longhorn 组件的 JSON 日志格式配置、优化实例管理器 Pod 删除原因日志记录、防止严格本地存储（strict-local）与 RWX 卷同时创建导致的冲突，以及修复卷调整大小卡顿问题。修复的重要问题涉及共享管理器 Pod 频繁重启、备份目标配置异常恢复、节点驱逐期间卷状态错误、NFS 断开后备份丢失、RWX PVC 文件系统扩容失败等。此外，还更新了基础镜像版本并修复了安全漏洞（CVE）。用户可参考文档了解升级路径、兼容性变更及已知问题详情。

更新内容 （中文）

Longhorn v1.6.4 版本说明

Longhorn 1.6.4 版本包含多项改进与缺陷修复，旨在提升系统质量、弹性与稳定性。

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

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

安装

[!IMPORTANT] 安装 Longhorn v1.6.4 前，请确保集群运行 Kubernetes v1.21 或更高版本。

您可通过 Rancher、Kubectl 和 Helm 等多种工具安装 Longhorn。有关安装方法与要求的详细信息，请参阅 Longhorn 文档中的快速安装指南。

升级

[!IMPORTANT] 从 Longhorn v1.5.x 或 v1.6.x（< v1.6.4）升级至 v1.6.4 前，请确保集群运行 Kubernetes v1.21 或更高版本。

Longhorn 仅支持从受控版本进行升级。有关升级路径与流程的详细信息，请参阅 Longhorn 文档中的升级指南。

弃用与兼容性变更

关于重要变更的信息（包括功能不兼容性、弃用与移除说明），请参阅 Longhorn 文档中的重要说明。

版本发布后已知问题

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

已解决问题

改进

  • [BACKPORT][v1.6.4][IMPROVEMENT] 为 Longhorn 组件（UI、驱动）添加 JSON 日志格式配置支持 10080 - @chriscchien
  • [BACKPORT][v1.6.4][IMPROVEMENT] 记录实例管理器 Pod 即将被删除的原因 9888 - @derekbit @chriscchien
  • [BACKPORT][v1.6.4][IMPROVEMENT] 在 /etc/nfsmount.conf 中检查 NFS 版本 9832 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.6.4][IMPROVEMENT] 防止卷扩容卡死 9913 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.6.4][IMPROVEMENT] 拒绝创建 strict-local + RWX 卷 9931 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.6.4][IMPROVEMENT] 通过 Longhorn Manager 设置配置其他系统及用户管理组件的日志级别 9618 - @yangchiu @james-munson
  • [BACKPORT][v1.6.4][IMPROVEMENT] 将误导性错误信息调整为警告级别 9918 - @yangchiu @derekbit
  • [BACKPORT][v1.6.4][IMPROVEMENT] 缩短 longhorn-manager 构建时间 9694 - @derekbit @chriscchien
  • [BACKPORT][v1.6.4][IMPROVEMENT] 移除 Longhorn 中镜像的 OpenShift 镜像 9599 - @derekbit @chriscchien

缺陷修复

  • [BUG][v1.6.x-head] 共享管理器 Pod 持续重启 10096 - @c3y1huang @chriscchien
  • [BACKPORT][v1.6.4][BUG] Webhook 服务器初始化阻塞 longhorn-manager 运行 10067 - @c3y1huang
  • [BACKPORT][v1.6.4][BUG] 从备份列表恢复多个文件时 API 请求缺少 fromBackup 参数 10065 - @a110605 @chriscchien
  • [BACKPORT][v1.6.4][BUG] 突发 ISCSI 连接错误及实例管理器 Pod 重启导致 Longhorn 卷断开 9890 - @yangchiu @ChanYiLin @chriscchien
  • [BACKPORT][v1.6.4][BUG] 带选项的 NFS 备份目标 URL 无法检查备份基础镜像信息 9704 - @yangchiu @mantissahz @chriscchien
  • [BACKPORT][v1.6.4][BUG] 卷备份详情页显示错误通知 10070 - @a110605 @houhoucoop
  • [BACKPORT][v1.6.4][BUG][v1.8.x] 节点删除并重新添加后无法添加块设备 10041 -
  • [BACKPORT][v1.6.4][BUG] 节点驱逐期间分离的卷卡在已挂载状态 9809 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.6.4][BUG] 备份进度不应将上传失败的块计入成功计数 9792 - @yangchiu @derekbit
  • [BACKPORT][v1.6.4][BUG] S3 备份目标随机回退至先前值 9589 - @c3y1huang
  • [BACKPORT][v1.6.4][BUG] 超时后旧备份未被清理 9730 - @yangchiu @mantissahz
  • [BACKPORT][v1.6.4][BUG] 共享管理器在停止/错误状态永久卡住导致 RWX PVC 无法挂载至新节点 9855 - @yangchiu @PhanLe1010
  • [BACKPORT][v1.6.4][BUG] 测试用例 test_node_eviction_multiple_volume 在卷分离后无法重新调度副本 9867 - @yangchiu @c3y1huang
  • [BACKPORT][v1.6.4][BUG] 增量恢复期间节点停止启动后 DR 卷重挂失败并进入故障状态 9802 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.6.4][BUG] 文件系统扩容阶段 RWX PVC 扩容失败 9737 - @james-munson
  • [BACKPORT][v1.6.4][BUG] 测试用例 Stopped replicas on deleted nodes should not be counted as healthy replicas when draining nodes 失败 9625 - @yangchiu @derekbit
  • [BACKPORT][v1.6.4][BUG] 升级前 Pod 应记录失败原因事件 9644 - @yangchiu @james-munson
  • [BACKPORT][v1.6.4][BUG] NFS 服务断开重连后备份目标中所有备份丢失 9543 - @yangchiu @mantissahz
  • [BACKPORT][v1.6.4][BUG] kubectl drain node 被异常残留引擎进程阻塞 9443 - @ejweber

其他

  • [TASK] 修复 v1.6.4 的 CVE 问题 9898 - @c3y1huang
  • [TASK] 为 v1.6.4 更新基础镜像版本至 15.6 10073 - @c3y1huang
  • [BACKPORT][v1.6.4][TASK] 构建时安装最新 grpc_health_probe 9716 - @yangchiu @c3y1huang

贡献者

  • @COLDTURNIP
  • @ChanYiLin
  • @PhanLe1010
  • @a110605
  • @c3y1huang
  • @chriscchien
  • @derekbit
  • @ejweber
  • @houhoucoop
  • @innobead
  • @james-munson
  • @mantissahz
  • @roger-ryao
  • @yangchiu
  • @jillian-maroket
  • @jhkrug
  • @rebeccazzzz
  • @forbesguthrie
  • @asettle

更新内容 （原始）

Longhorn v1.6.4 Release Notes

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

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.21 or later before installing Longhorn v1.6.4.

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.21 or later before upgrading from Longhorn v1.5.x or v1.6.x (< v1.6.4) to v1.6.4.

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

Deprecation & Incompatibilities

For information about important changes, including feature incompatibility, deprecation, and removal, see Important Notes 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.6.4][IMPROVEMENT] Add support for JSON log format configuration in Longhorn components (UI, driver) 10080 - @chriscchien
  • [BACKPORT][v1.6.4][IMPROVEMENT] Logging the reason why the instance manager pod is going to be deleted. 9888 - @derekbit @chriscchien
  • [BACKPORT][v1.6.4][IMPROVEMENT] Check NFS versions in /etc/nfsmount.conf instead 9832 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.6.4][IMPROVEMENT] Prevent Volume Resize Stuck 9913 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.6.4][IMPROVEMENT] Reject strict-local + RWX volume creation 9931 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.6.4][IMPROVEMENT] Configure the log level of other system and user managed components via longhorn manager setting 9618 - @yangchiu @james-munson
  • [BACKPORT][v1.6.4][IMPROVEMENT] Change misleading error message to warning level 9918 - @yangchiu @derekbit
  • [BACKPORT][v1.6.4][IMPROVEMENT] Building longhorn-manager takes long time 9694 - @derekbit @chriscchien
  • [BACKPORT][v1.6.4][IMPROVEMENT] Remove mirrored openshift image from Longhorn 9599 - @derekbit @chriscchien

Bug

  • [BUG][v1.6.x-head] Share manager pod kept restarting 10096 - @c3y1huang @chriscchien
  • [BACKPORT][v1.6.4][BUG] Webhook servers initialization blocks longhorn-manager from running 10067 - @c3y1huang
  • [BACKPORT][v1.6.4][BUG] Missing fromBackup Parameter in API Request When Restoring Multiple Files from Backup List 10065 - @a110605 @chriscchien
  • [BACKPORT][v1.6.4][BUG] Busrt ISCSI Connection Errors, and IM Pod Restarting to make LH Volume disconnection 9890 - @yangchiu @ChanYiLin @chriscchien
  • [BACKPORT][v1.6.4][BUG] Failed to inspect the backup backing image information if NFS backup target URL with options 9704 - @yangchiu @mantissahz @chriscchien
  • [BACKPORT][v1.6.4][BUG] Error notification appears on the volume backup details page 10070 - @a110605 @houhoucoop
  • [BACKPORT][v1.6.4][BUG][v1.8.x] Unable to add block disk after node deleted and added back 10041 -
  • [BACKPORT][v1.6.4][BUG] Detached Volume Stuck in Attached State During Node Eviction 9809 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.6.4][BUG] Backup progress should not add block failed to upload to successful count 9792 - @yangchiu @derekbit
  • [BACKPORT][v1.6.4][BUG] S3 Backup target reverts randomly to previous value 9589 - @c3y1huang
  • [BACKPORT][v1.6.4][BUG] Old backups are not cleaned up after timeout 9730 - @yangchiu @mantissahz
  • [BACKPORT][v1.6.4][BUG] Share manager is permanently stuck in stopping/error if we shutdown the node of share manager pod. This makes RWX PVC cannot attach to any new node 9855 - @yangchiu @PhanLe1010
  • [BACKPORT][v1.6.4][BUG] Test case test_node_eviction_multiple_volume failed to reschedule replicas after volume detached 9867 - @yangchiu @c3y1huang
  • [BACKPORT][v1.6.4][BUG] DR volume fails to reattach and faulted after node stop and start during incremental restore 9802 - @c3y1huang @roger-ryao
  • [BACKPORT][v1.6.4][BUG] Fail to resize RWX PVC at filesystem resizing step 9737 - @james-munson
  • [BACKPORT][v1.6.4][BUG] Test case Stopped replicas on deleted nodes should not be counted as healthy replicas when draining nodes fails 9625 - @yangchiu @derekbit
  • [BACKPORT][v1.6.4][BUG] Pre-upgrade pod should event the reason for any failures. 9644 - @yangchiu @james-munson
  • [BACKPORT][v1.6.4][BUG] All Backups are lost in the Backup Target if the NFS Service Disconnects and Reconnects again 9543 - @yangchiu @mantissahz
  • [BACKPORT][v1.6.4][BUG] kubectl drain node is blocked by unexpected orphan engine processes 9443 - @ejweber

Misc

  • [TASK] Fix CVE issues for v1.6.4 9898 - @c3y1huang
  • [TASK] Update base image version to 15.6 for v1.6.4 10073 - @c3y1huang
  • [BACKPORT][v1.6.4][TASK] Install the latest grpc_health_probe at build time 9716 - @yangchiu @c3y1huang

Contributors

  • @COLDTURNIP
  • @ChanYiLin
  • @PhanLe1010
  • @a110605
  • @c3y1huang
  • @chriscchien
  • @derekbit
  • @ejweber
  • @houhoucoop
  • @innobead
  • @james-munson
  • @mantissahz
  • @roger-ryao
  • @yangchiu
  • @jillian-maroket
  • @jhkrug
  • @rebeccazzzz
  • @forbesguthrie
  • @asettle

下载链接