云原生存储高可用容器编排【免费下载链接】longhornCloud-Native distributed storage built on and for Kubernetes项目地址https://gitcode.com/gh_mirrors/lo/longhorn点击查看免费下载本文围绕 Longhorn 官方 v1.10.1 发布说明CHANGELOG-1.10.1.md展开逐项解析该补丁版本聚焦的系统质量、韧性、稳定性与安全改进并深入 V2 数据引擎中断模式Interrupt Mode在仓库中的设计与实现落点。读完本文你将掌握 v1.10.1 的关键修复内容、升级前置条件Kubernetes v1.25、变更清单以及如何结合仓库源码与 Helm 配置理解并规避这些已知问题。版本定位1.10 系列的首个补丁版本Longhorn v1.10.1 是 v1.10.0 大版本该版本集中引入了 V2 数据引擎中断模式、卷克隆、副本重建 QoS、卷扩容、无大页运行等能力见 CHANGELOG-1.10.0.md之后的补丁版本。根据仓库根目录 README.md 中的版本表1.10 系列当前维护版本即为 1.10.2而本仓库 support-versions.txt 显示当前处于活跃支持期的版本线已推进到 1.11/1.12——阅读本文时可将 v1.10.1 视为 1.10 系列稳定化过程中的一个关键节点。官方定位上v1.10.1 的核心诉求是改善系统的质量、韧性、稳定性与安全性。具体而言它包含 4 项重点修复、7 项改进、28 项缺陷修复与 2 项杂项变更。重点修复详解发布说明中的 Important Fixes 节明确指出本版本包含若干关键稳定性与性能改进以下逐项展开。V2 数据引擎实例管理器 Goroutine 泄漏Issue #11962修复了使用 V2 数据引擎时实例管理器Instance Manager中的 goroutine 泄漏问题。该问题若长期存在会导致内存占用持续增长进而引发潜在的稳定性故障。从架构上看V2 数据引擎基于 SPDK 实现对应设计文档 20221213-reimplement-longhorn-engine-with-SPDK.md而实例管理器负责控制器/副本实例的生命周期管理见 README.md 组件表。goroutine 泄漏通常发生在 SPDK 进程与实例管理器之间的长连接、轮询或请求处理协程未正确退出的场景长期累积会侵蚀节点内存属于慢病型稳定性缺陷正适合在补丁版本中集中收敛。V2 卷在中断模式下挂载失败补齐 NVMe 磁盘支持Issue #11816 / #11976这是 v1.10.1 中最值得关注的能力变化在 v1.10.0 中中断模式Interrupt Mode仅支持 AIO 磁盘自 v1.10.1 起中断模式正式支持 NVMe 磁盘。修复前使用中断模式且搭配 NVMe 磁盘的 V2 卷可能无法完成挂载流程导致卷无限期停留在attaching状态。仓库中与中断模式相关的完整设计与配置证据如下设计文档20250721-v2-engine-interrupt-mode.md 详细描述了混合实现方案——NVMe-oFtarget使用epoll等待 socket 就绪事件NVMe-oFinitiator则以固定周期轮询bdev_nvme_poll冲刷 I/O 完成事件未来迭代计划探索epolleventfd的完全事件驱动模型。全局设置项Phase 1data-engine-interrupt-mode-enabled布尔类型默认false默认仍为轮询模式全局设置项Phase 2data-engine-nvme-ioq-poll-period-us整数范围 1默认100微秒CRD 状态字段InstanceManager.status.dataEngineStatus.v2.interruptModeEnabled用于指示 V2 数据引擎当前运行于中断模式true还是轮询模式false由 Longhorn Manager 维护、对用户只读。与本次修复同批收敛的 V2/NVMe 相关缺陷还包括Issue问题描述#12029V2 数据引擎中找不到 NVMe 磁盘failed to find device for BDF#12000重新启用 V2 数据引擎后无法按 BDF 重新添加块类型磁盘#12026Talos 节点上 V2 卷创建失败#11801打上disable-v2-data-enginetrue标签后无法分离 V2 卷#11970修复 SPDK v25.05 的 CVE 安全漏洞UI 在仅启用 IPv4 的节点上部署失败Issue #11875修复了 v1.10.0 引入的一个回归在仅启用 IPv4 的节点上Longhorn UI 无法完成部署。修复后 UI 无需 IPv6 即可正确支持纯 IPv4 配置。这一点对于禁用 IPv6 的 Kubernetes 集群例如部分合规或受限网络环境尤为重要涉及清单位于 deployment-ui.yaml相关配置副本数、亲和性、PDB可参考 values.yaml 中的longhornUI段。Share Manager 内存异常占用RWX 卷Issue #12043修复了 RWXReadWriteMany卷场景下 Share Manager 组件内存消耗过高的问题修复后组件在正常运行状态下维持稳定内存使用。Share Manager 本质上是将 Longhorn 卷以 NFS 形式暴露为 ReadWriteMany 卷的组件见 README.md 组件表其内存异常通常与句柄泄漏、缓存未回收或文件系统事件堆积相关。同批还修复了RWX volume causes process uninterruptible sleepIssue #11958进程进入不可中断睡眠 D 状态的问题两者共同提升了 RWX 卷的长稳表现。安装与升级前置条件发布说明用两个高优先级提示[!IMPORTANT]框定了安装与升级的硬性门槛安装集群必须运行Kubernetes v1.25 或更高版本方可安装 Longhorn v1.10.1升级从 Longhorn v1.9.x 升级到 v1.10.1 同样要求Kubernetes v1.25 及以上升级路径约束Longhorn 仅允许从受支持的版本升级升级路径与流程以官方 Upgrade 文档为准。本仓库为部署与卸载提供了现成清单使用 kubectl 安装时可基于 deploy/longhorn.yaml及 deploy/longhorn-okd.yaml 等变体使用 Helm 时可参考 Chart.yaml 与 values.yaml卸载流程见 uninstall/uninstall.yaml。升级路径上值得特别留意的背景是v1.10.0 已经移除了longhorn.io/v1beta1API详见 CHANGELOG-1.10.0.md。v1.10.1 修复了由此衍生的一批升级问题Issue问题描述#11886从 1.9.1 升级到 1.10.0 失败因为旧资源仍处于 v1beta1#11865从 1.9.2 升级到 1.10.0 后 longhorn-manager 无法启动#11895活跃副本数大于volume.spec.numberOfReplicas时卷无法升级#11964因残留的 BackupTarget 导致无法完成卸载本次引入的改进v1.10.1 通过 backport 收编了 7 项改进覆盖控制器行为、调度容量、可观测性与配置易用性Issue改进内容仓库中的对应证据#12125auto-delete-pod-when-volume-detached-unexpectedly仅聚焦 Kubernetes 内置工作负载values.yaml 中autoDeletePodWhenVolumeDetachedUnexpectedly及其黑名单blacklistForAutoDeletePodWhenVolumeDetachedUnexpectedly设置项#12036CSIStorageCapacity对象必须展示可调度可分配容量values.yaml 中csiStorageCapacityTracking设置项#12033改进 CSI node publish volume 阶段挂载失败的错误日志CSI 插件相关清单 deployment-driver.yaml#12020改进 Helm ChartdefaultSettings处理自动引号与多类型支持default-setting.yaml 中大量使用include longhorn.multiTypeSetting渲染 JSON 形式的多数据引擎取值#11945迁移期间存在副本不可用时避免重复重启引擎引擎控制器相关代码路径#11968调大GuaranteedInstanceManagerCPU的上限values.yaml 中guaranteedInstanceManagerCPU设置项#11795为 Longhorn 安装变体增加用量指标values.yaml 中allowCollectingLonghornUsageMetricsupgrade_responder_server/chart-values.yaml 中已有longhornV2DataEngineInterruptModeEnabled等指标维度其中 #12020 与本文主题强相关v1.10 起 Longhorn 设置统一采用单一值适用于所有数据引擎 / JSON 对象按数据引擎区分的新格式如{v1:value1,v2:value2}见 CHANGELOG-1.10.0.mdHelm 模板的自动引号与多类型渲染正是为了适配data-engine-interrupt-mode-enabled、data-engine-hugepage-enabled这类{v2: ...}形态的取值避免布尔值/数值在 YAML 渲染过程中被错误转义。其余缺陷修复分类梳理除重点修复外v1.10.1 还通过 backport 修复了一批分散在 V2 引擎、备份、CSI、卷状态机与磁盘管理等模块的缺陷V2 数据引擎与 SPDK 相关#11901longhorn-engine 的 UI 组件 panic#12088 / #11942空指针解引用invalid memory address or nil pointer dereference其中 #12088 定位于 longhorn-engine 控制器 control.go:218 附近#11998附加节点上的引擎镜像被删除后DR 卷卡在unknown状态#11996引擎镜像未部署到全部节点时卷卡在attaching状态。备份、恢复与周期任务#12089备份目标Backup Target指标损坏#11926周期任务执行期间的 NPE 错误#12005test_system_backup_and_restore测试用例失败#11964残留 BackupTarget 阻塞卸载已在升级部分列出。CSI 与挂载#12008CSI node publish volume 阶段的挂载错误未被妥善处理#11918dataEngine参数缺失时csi-provisioner 静默创建 CSIStorageCapacity 失败。磁盘、节点与网络#12018同一节点并发添加多个磁盘时偶发失败#11954块磁盘删除失败且无错误消息#12094网络断开后 backing image 下载卡住#11970SPDK v25.05 的 CVE 修复已在重点修复部分列出。杂项Misc#11992为 UI 组件增加 SAST 静态安全扫描检查重构项#11951为longhorn-manager:v1.10.0创建 hotfix 镜像热修复项。源码佐证中断模式在仓库中的完整落点由于NVMe 磁盘中断模式支持是 v1.10.1 最有技术含量的一项变更以下沿仓库文件链完整梳理其实现落点便于读者按图索骥设计文档20250721-v2-engine-interrupt-mode.md混合模式设计target 端epoll等待 socket 就绪 initiator 端周期轮询bdev_nvme_poll阶段划分Phase 1 固定nvme_ioq_poll_period_us 100微秒并提供开关Phase 2 将该参数外部化依赖要求 SPDK v25.xLonghorn 的 SPDK fork 需 rebase 到 v25.x并移除event_iscsi以避免不必要的 iSCSI 子系统初始化文中给出的基准数据AWS SLES 15 SP7、k3s v1.32、t2.2xlarge表明中断模式在空闲/低 I/O 场景下显著降低 CPU 消耗100ms轮询周期在读延迟与 IOPS 之间取得较好平衡。Helm 默认设置values.yamldefaultSettings.dataEngineInterruptModeEnabled注释明确仅适用于 V2 数据引擎控制 SPDK target 守护进程运行于中断模式还是默认轮询模式默认值{v2:false}。模板渲染default-setting.yaml将dataEngineInterruptModeEnabled通过include longhorn.multiTypeSetting渲染为data-engine-interrupt-mode-enabled配置项该文件同时渲染data-engine-cpu-isolation-enabled、data-engine-memory-size等 V2 专属设置。CRD 定义crds.yamlInstanceManager.status.dataEngineStatus.v2.interruptModeEnabled字段枚举值/true/false描述明确标注由 Longhorn Manager 设置用户只读。Rancher 问答questions.yaml为defaultSettings.dataEngineInterruptModeEnabled提供了 UI 层的描述与默认值{v2:false}归入 Longhorn V2 Data Engine Settings 分组。升级与使用建议基于 v1.10.1 的变更内容给出如下实操建议升级前自查确认集群版本不低于 Kubernetes v1.25若从 1.9.x 升级先核对是否存在遗留的 v1beta1 资源v1.10 系列已移除该 API 版本避免触发 #11886、#11865 一类升级失败中断模式按需开启中断模式是 opt-in 特性默认关闭无需迁移。若集群存在大量空闲或低 I/O 的 V2 卷且对 CPU 利用率敏感可通过data-engine-interrupt-mode-enabled开启自 v1.10.1 起 NVMe 磁盘同样受支持RWX 与 UI 场景1.10.1 已修复 Share Manager 内存异常与纯 IPv4 节点 UI 部署问题升级后可重点观察这两个组件的稳定性安全项SPDK v25.05 CVE#11970已在本版本修复建议及时升级以消除该安全隐患发布后已知问题官方在版本发布后仍会持续跟踪并维护已知问题清单Release-Known-Issues 页面升级前可先查阅该页面确认是否存在影响自身部署环境的新发现。致谢与贡献者本版本由 15 位贡献者共同完成COLDTURNIP、PhanLe1010、bachmanity1、c3y1huang、chriscchien、davidcheng0922、derekbit、forbesguthrie、innobea、mantissahz、rebeccazzzz、roger-ryao、sushant-suse、shuo-wu、yangchiu。Longhorn 欢迎社区反馈与贡献以持续改进贡献指引见 CONTRIBUTING.md。赞分享云原生存储高可用容器编排【免费下载链接】longhornCloud-Native distributed storage built on and for Kubernetes项目地址https://gitcode.com/gh_mirrors/lo/longhorn点击查看免费下载相关推荐Longhorn v1.6.2 补丁版本解读稳定性修复、升级路径与部署实践Longhorn v1.6.2 补丁版本解读稳定性修复、升级路径与部署实践 Longhorn v1.6.2 是 v1.6 系列的一个补丁patch版本聚云原生存储高可用容器编排Longhorn v1.11.3 补丁版本深度解读稳定性修复、升级约束与源码印证Longhorn v1.11.3 补丁版本深度解读稳定性修复、升级约束与源码印证 Longhorn 1.11.3 是面向 v1.11 系列的一个补丁发布pa云原生存储高可用容器编排Longhorn v1.8.1 发布深度解析升级路径、稳定性修复与备份/V2 数据引擎问题清单Longhorn v1.8.1 发布深度解析升级路径、稳定性修复与备份/V2 数据引擎问题清单 Longhorn v1.8.1 是 Longhorn 1.8云原生存储高可用容器编排创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
