云原生存储高可用容器编排【免费下载链接】longhornCloud-Native distributed storage built on and for Kubernetes项目地址https://gitcode.com/gh_mirrors/lo/longhorn点击查看免费下载导读本文围绕 Longhorn 1.5 系列的最新稳定版本 v1.5.4 展开系统梳理该版本的安装/升级要求、新增的「节点排空自动驱逐副本」能力以及十余项改善稳定性与韧性的改进与缺陷修复。读者将掌握 v1.5.4 的升级路径与前置条件、node-drain-policy五种策略的取舍与配置方式以及本版本修复的 CSI、备份、RWX、Backing Image 等核心模块问题的成因与规避手段并可结合本仓库的 Helm Chart 与增强文档enhancements/20230905-automatically-evict-replicas-while-draining.md深入理解底层实现。一、版本定位与发布背景Longhorn v1.5.4 是 Longhorn 1.5 系列的一个稳定补丁版本发布于 1.5 主线持续演进期间其定位是在不引入破坏性变更的前提下提升系统的整体质量quality、韧性resilience与稳定性stability。从变更清单的构成看绝大多数条目带有[BACKPORT]标记——即从后续主线分支如 1.6.x回移植到 1.5.x 分支的修复与改进这意味着 v1.5.4 承担着把主线已验证的稳定性成果同步给仍停留在 1.5 系列的用户的职责。本版本的变更覆盖了 Longhorn 的几大核心子系统调度与节点管理新增节点排空自动驱逐副本策略CSI 驱动启动探针调整、CSI 组件升级、mTLS 挂载修复备份/恢复链路备份目标清理、DR 卷激活、S3 客户端重试Backing Image下载方式优化、压缩存储、文件名规范RWX 卷share-manager 死锁、只读卷自动重挂载监控与运维快照指标、Prometheus ServiceMonitor、support-bundle 优化。二、安装与升级前提v1.5.4 对集群版本有硬性要求集群必须运行 Kubernetes v1.21 或更高版本这一约束同时适用于全新安装与从 v1.4.x 的升级场景。2.1 安装方式Longhorn 官方支持多种安装工具包括 Rancher、kubectl 与 HelmHelm使用本仓库的 chart 目录通过helm install longhorn ./chart部署其中 values.yaml 提供了全部可调参数kubectl / manifest直接应用 deploy/longhorn.yaml或 OpenShift 专用的 deploy/longhorn-okd.yamlRancher作为 Rancher 应用目录中的 Chart 一键安装。提示安装时若使用 Helm建议先核对 chart/questions.yaml 中的 UI 引导参数与 chart/README.md 中生成的默认值文档避免默认设置与预期不符。2.2 升级路径约束Longhorn只允许从受支持的版本升级。从 v1.4.x 升级到 v1.5.4 时需注意升级前集群必须为 Kubernetes v1.21且应遵循官方文档中的升级流程先升级 Longhorn Manager再按需自动升级引擎镜像与实例管理器。仓库中的 CHANGELOG 目录保留各版本说明可用于核对升级路径中的已知问题。一个与升级直接相关的修复是「绕过全新安装时的升级流程」issue 7283当检测到是全新部署而非升级时跳过不必要的升级检查逻辑从而缩短冷启动路径并减少误报风险。三、Highlight节点排空时自动驱逐副本本版本最核心的功能性更新是为node-drain-policy节点排空策略设置新增了两个选项使 Longhorn 能够在节点被 cordon封锁后自动驱逐副本而无需用户通过 UI 手动干预。该能力的设计细节完整记录于本仓库增强文档 enhancements/20230905-automatically-evict-replicas-while-draining.md。3.1 五种排空策略的完整语义策略行为数据保护代价block-if-contains-last-replica默认只要节点上存在某卷的最后一个健康副本instance-manager Pod 就禁止被排空高排空完成前每个卷必有健康副本可能需要用户手动在 UI 驱逐副本allow-if-replica-is-stopped仅当节点上有最后 RUNNING 副本时阻止排空中依赖节点会重新上线节点永不回归则数据丢失always-allow从不阻止 instance-manager Pod 排空低Longhorn 不介入保护排空期间冗余度可能骤降block-for-evictionv1.5.4 新增只要节点上有任何卷的副本就禁止排空且 cordon 后自动驱逐全部副本高排空完成前所有副本已完成迁移重建全程保持冗余排空慢、数据密集仅 cordon 不排空时会无谓重建block-for-eviction-if-contains-last-replicav1.5.4 新增仅当节点是某卷最后一个健康副本所在节点时禁止排空并自动驱逐这些副本高关键副本被迁移非关键副本不迁移卷在排空期间可能短暂 degraded新策略的可用选项已同步到 Helm Chart 的引导配置中见 chart/questions.yaml其枚举值为options: - block-for-eviction - block-for-eviction-if-contains-last-replica - block-if-contains-last-replica - allow-if-replica-is-stopped - always-allow default: block-if-contains-last-replica即默认值保持不变block-if-contains-last-replica两种自动驱逐策略均为用户显式选择后才生效的 opt-in 行为。3.2 典型使用场景增强文档中的用户故事给出了两个最具代表性的场景集群升级自动化使用 Rancher 管理 RKE2/K3s 集群时system-upgrade-controller 会在重启节点前尝试排空节点。若节点上恰有某卷的最后一个健康副本排空将永远无法完成。在升级前将策略切换为block-for-eviction升级过程虽然更耗时但无需任何人工介入即可完成。节点维护/移除当运维者不希望排空期间出现冗余度下降例如节点被移除后新副本重建期间可选用block-for-eviction确保排空完成时数据已全部迁移。3.3 底层实现机制从增强文档的设计章节可以梳理出自动驱逐的执行链路既有驱逐逻辑保持复用用户可在 node/disk 上设置spec.evictionRequestedtrue副本控制器据此设置副本的status.evictionRequestedtrue卷控制器据此触发替换副本的重建与旧副本删除。v1.5.4 的改动由节点控制器而非副本控制器负责设置replica.spec.evictionRequestedtrue触发条件包括节点/磁盘上的spec.evictionRequestedtrue或 Kubernetes 节点对象status.Unschedulabletrue且排空策略为block-for-eviction若策略为block-for-eviction-if-contains-last-replica则仅当该卷没有其他受 PDB 保护的副本时才设置。与此同时节点 CR 新增status.autoEvicting字段用于向用户与 UI 提示自动驱逐正在进行中。该字段已定义于本仓库 CRD 中见 chart/templates/crds.yaml 中NodeStatus的autoEvicting属性。原replica.status.evictionRequested字段被废弃迁移为replica.spec.evictionRequested使驱逐请求的来源更清晰由节点控制器统一驱动。需要说明的边界Longhorn 无法区分「正在排空」与「仅被 cordon」因此所有策略都在 cordon 时触发。若运维习惯频繁 cordon 而不排空自动驱逐策略会引发无意义的副本重建。四、Improvement稳定性与运维体验改善v1.5.4 包含一批不改变功能面、但显著改善运行体验与资源效率的改进项按其影响的子系统分类如下。4.1 备份与恢复链路备份目标清理issue 7145当backup-target设置被取消unset时instance-manager Pod 内的备份目标资源会被主动清理避免残留状态导致后续重新配置时行为异常。S3 客户端放宽重试间隔issue 7098针对被限流throttled的 S3 请求放宽客户端重试间隔降低备份操作在限流场景下的失败率。Backing Image 下载改为压缩存储issue 7397下载的 Backing Image 会被压缩且文件名使用 Backing Image 名称而非 UUID便于人工识别与运维管理。回退内容长度获取方式issue 7981获取 URL 资源的Content-Length由 GET 改为 HEAD 请求减少不必要的资源传输开销。4.2 挂载与卷生命周期只读 RWO 卷自动重挂载为读写issue 7500当 RWO 卷意外变为只读状态时自动触发重挂载恢复读写能力配套修复issue 7729确保只重启那些卷处于异常只读状态的 Pod避免无谓的全局 Pod 重启。16TiB 大卷与 ext4 的兼容性改善issue 7429改进对超大容量卷在 ext4 底层文件系统上的处理规避格式化与挂载阶段的边界问题。迁移引擎在 kubelet 重启时不崩溃issue 7328加固卷迁移live migration引擎对 kubelet 重启的耐受性。4.3 CSI 组件与网络移除 CSI 驱动启动探针issue 7933在 liveness probe 连接问题修复就绪后移除启动探针startup probe减少探测开销并简化探针状态机。升级 CSI 组件至最新补丁版本issue 7492csi-attacher、provisioner、resizer、snapshotter 等侧车容器统一升级本仓库当前 Chart 中已对应锁定为较新版本见 chart/values.yaml 的image.csi段落。mTLS 环境下卷无法挂载的修复issue 7789修复启用双向 TLS 后卷挂载失败的问题。Driver Deployer 不因 Kubernetes 版本变化而清理旧部署issue 7345避免集群版本升级触发驱动部署被误清理。4.4 监控、镜像与组件Prometheus ServiceMonitor 支持issue 7864允许通过 Longhorn Helm Chart 直接部署 ServiceMonitor将 Longhorn Manager 指标接入 Prometheus对应 Chart 参数见 chart/values.yaml 的metrics.serviceMonitor段落。快照指标扩展issue 7725卷的snapshot相关指标新增大小与**类型系统快照 vs 用户快照**维度便于容量审计与快照治理。组件基础镜像升级至 BCI 15.5issue 7134Longhorn 各组件的容器基础镜像迁移到 SUSE BCIBase Container Image15.5提升镜像供应链的安全基线。support-bundle-manager 镜像拉取策略改为IfNotPresentissue 7999减少离线/受限网络环境下 support bundle 收集时的镜像拉取失败风险support bundle kit 版本同步升级至 v0.0.33issue 7279。grpc.WithInsecure 弃用替换issue 7364将废弃的 gRPC 不安全连接选项替换为新 API消除后续 gRPC 版本升级的编译与告警问题。新增「禁用快照清理」设置issue 7265为运维排障场景提供disable-snapshot-purge开关已定义于 chart/values.yaml 的defaultSettings.disableSnapshotPurge可在需要时临时阻止快照 purge。4.5 其他改进全局默认 PriorityClass 的环境检查issue 7831environment_check脚本在受影响的版本中额外检查全局默认的 Kubernetes PriorityClass 是否存在。拒绝删除最后一个副本issue 7432若卷的spec.deletionTimestamp未设置则拒绝删除最后一个副本防止误删导致数据面完全丧失。移除 longhorn-manager 中未使用的进程管理器连接issue 7785精简内部组件间连接降低资源占用与潜在状态泄漏。简化 Longhorn 组件镜像构建issue 7162重构镜像构建流程降低维护成本。五、Bug 修复分类解读v1.5.4 修复了超过 40 个缺陷以下是按模块归纳的高价值修复供升级决策与问题排查参考。5.1 数据安全与恢复修复 salvaged 副本保留错误issue 7801此前 Longhorn 可能保留损坏的 salvaged 副本而丢弃健康副本该修复重排 salvage 决策逻辑确保恢复时优先采纳可用的副本。禁用 revision counter 时 salvage 异常issue 7732修复关闭修订计数器后卷 salvage 行为不符合预期的问题。DR 卷激活不含最新数据issue 7947修复激活的 DR灾备卷不包含最新备份数据的问题并修复最新备份被删除后 DR 卷无法激活的问题issue 7997。备份卷附件票据未清理issue 7604备份卷附件的票据在完成后可能残留本版补齐清理逻辑。5.2 卷迁移、重建与升级卷迁移与升级之间的死锁issue 7869Longhorn 升级后卷迁移与引擎升级可能互相等待形成死锁已解除。1.5.3 → 1.6.0 升级后卷卡在升级状态issue 7901修复升级后卷长期处于 upgrading 状态的问题。实时引擎升级中删除旧引擎副本导致卷永久 degradedissue 7334修复在线引擎升级期间删除旧引擎副本引发的降级问题。fstrim 与重建并发导致 IO 错误issue 7867执行文件系统 trim 的同时进行副本重建会引发 IO 错误本版将其串行化约束。引擎进程被杀后卷无法重挂载issue 7772修复引擎进程异常退出后卷无法重新挂载的问题。5.3 RWX 与共享卷share-manager Pod 出错导致 RWX 卷死锁issue 7186修复 RWX 卷在 share-manager Pod 出现错误时的死锁问题。只读卷自动重挂载在单节点集群失效issue 7844修复单节点集群上只读卷自动重挂载功能不生效的问题。5.4 Backing ImageURL 下载异常issue 7986 / 7822修复 Backing Image 在特定场景下无法正确下载的问题包括URL 携带查询参数时下载失败的问题。配置存储网络时下载 502issue 7239修复配置 Storage Network 后下载 Backing Image 返回 HTTP 502 的问题。Backing Image 卷导出数据不一致issue 7701修复从 Backing Image 卷导出时产生的数据不一致问题。下载服务器错误issue 7381修复 backing image download server 的错误处理。5.5 节点、调度与集群管理副本自动均衡在 zone 空间不足时持续触发issue 7306修复节点/zone 空间不足时副本自动均衡反复空转的问题。副本自动均衡向禁用节点复制副本issue 7275修复启用replica-auto-balance后向已禁用节点复制副本、刷屏日志与 UI 的问题。删除 Kubernetes 节点未移除node.longhorn.ioissue 7538修复节点删除后 Longhorn 节点 CR 残留的问题。备份目标资源被 cordoned 节点接管后无法列出备份issue 7621修复备份列表功能在备份目标 Pod 落到 cordoned 节点时不可用的问题。容器化 K3s 中 manager Pod 无法启动issue 7848适配容器化 K3s 环境下的启动问题。卸载作业在 Webhook 配置已删除时卡死issue 7658修复MutatingWebhookConfigurations/ValidatingWebhookConfigurations已被删除时卸载作业永久卡住的问题并修复卸载作业完成后部分 Longhorn 资源残留的问题issue 7663。5.6 CSI 与挂载集群重启后 CSI CrashLoopBackOffissue 7426修复集群重启后 CSI 组件因连接unix://csi/csi.sock失败而反复崩溃的问题。linkerd 网格下不部署 CSI 驱动issue 7391修复集成 linkerd 服务网格时 Longhorn-manager 不部署 CSI 驱动的问题。卷就绪状态异常issue 7314修复工作负载等待的 PV 长时间未就绪的问题。5.7 指标与 UItotalVolumeSize/totalVolumeActualSize指标受 v2 卷计数影响issue 7392修复 v2 数据引擎卷被错误计入总量指标导致数值偏大问题。卷条件未在 UI 展示issue 7242修复 v1.4.x 及更新版本中卷条件conditions未在 UI 呈现的问题。UI 在升级后展示 V2 卷的引擎升级选项issue 7863修复 v1.5.3 → v1.5.4-rc1 升级后 UI 错误展示 v2 卷引擎升级选项的问题。5.8 配置与环境适配Helm Chart 默认设置模板错误issue 7459修复 v1.5/v1.4 Chart 中default-setting.yaml模板的错误对应本仓库模板文件 chart/templates/default-setting.yaml。allow-collecting-longhorn-usage-metrics设置缺失issue 7250该设置此前未包含在 Chart 设置中本版补齐对应 chart/values.yaml 的defaultSettings.allowCollectingLonghornUsageMetrics。Helm2 安装失败issue 7435validate-psp-install.yaml中使用了 Helm2 不支持的lookup函数导致安装报错已修复。Rancher 导入 1.5 Chart 报 YAML 转换错误issue 7776修复 YAML 语法解析问题恢复 Rancher 侧导入能力。加密卷在 Amazon Linux 2 上不生效issue 7165修复卷加密在 Amazon Linux 2 发行版上的兼容性。StorageMinimalAvailablePercentage 默认值文档错误issue 7400修正该设置的默认值说明。六、升级评估与运维建议综合本版本变更给出如下实操建议升级前检查确认集群 Kubernetes ≥ v1.21若从 v1.4.x 升级先确认升级路径受支持并关注 CHANGELOG 中记录的已知问题。节点维护规划若经常需要无人工干预地排空节点如自动化集群升级可将defaultSettings.nodeDrainPolicy临时切换为block-for-eviction若希望仅在数据关键时迁移副本则选block-for-eviction-if-contains-last-replica。两者均为 opt-in默认值保持不变。快照与备份治理升级后可用新增的快照指标含 size 与 system/user 类型维度结合 Prometheus ServiceMonitor 建立容量告警如需排查快照 purge 相关问题可临时设置disableSnapshotPurge。Backing Image 运维升级后 Backing Image 下载将压缩存储且以名称命名文件若使用带查询参数的 URL本版本已修复下载失败问题可放心配置。卸载与清理若涉及卸载 Longhorn建议升级到本版本以规避 Webhook 配置已删除时卸载作业卡死的问题issue 7658。七、相关仓库资源版本说明原文CHANGELOG/CHANGELOG-1.5.4.md自动驱逐副本设计文档enhancements/20230905-automatically-evict-replicas-while-draining.mdHelm 安装与参数chart/values.yaml、chart/templates/default-setting.yaml、chart/questions.yaml直装清单deploy/longhorn.yaml、deploy/longhorn-okd.yaml其他版本说明CHANGELOG赞分享云原生存储高可用容器编排【免费下载链接】longhornCloud-Native distributed storage built on and for Kubernetes项目地址https://gitcode.com/gh_mirrors/lo/longhorn点击查看免费下载相关推荐django CMS 3.7.1 版本说明解析关键 Bug 修复与功能改进深度解读django CMS 3.7.1 版本说明解析关键 Bug 修复与功能改进深度解读 django CMS 3.7.1 是 3.7 系列的一个维护性小版本聚焦CMS后端Robot Framework 4.0.1 版本发布说明与关键修复深度解析Robot Framework 4.0.1 版本发布说明与关键修复深度解析 Robot Framework 4.0.1 是 4.0.x 系列的首个缺陷修复版本测试RPA接口测试NumPy 1.9.1 发布说明深度解读bugfix 版本的关键修复与迁移指引NumPy 1.9.1 发布说明深度解读bugfix 版本的关键修复与迁移指引 NumPy 1.9.1 是 1.9.x 系列中的一次纯缺陷修复bugfix科学计算数据分析上一篇SymPy 逻辑模块sympy.logic完全指南从布尔表达式构造到 SAT 求解下一篇Research: [Company or Person Name]创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考