各位 Rancher 社区的朋友们,大家好!
欢迎阅读本期 Rancher 社区双周报。近两周,Rancher 生态多个核心项目陆续发布正式版本:Rancher v2.15.3 集中修复安全问题并带来维护更新,Longhorn v1.12.2 聚焦稳定性与 V2 数据引擎修复,Harvester v1.9.1 更新安全补丁并推进多项功能正式可用;RKE2 和 K3s 也同步发布了覆盖多个 Kubernetes 分支的补丁版本。
Longhorn v1.12.2
Longhorn v1.12.2 是一个以稳定性、数据一致性和 V2 Data Engine 修复为主的维护版本。本次发布包含 V1/V2 数据引擎的重要修复,也对 V2 升级路径、备份建议和旧版 linked-clone 行为给出了明确说明。
升级与数据保护注意事项
- V2 Data Engine 不支持从 v1.12.2 直接在线升级到 v1.13.0:Release Notes 明确指出,v1.13.0 缺少 v1.12.2 和 v1.13.1 中包含的部分 V2 rebuild 与 live-upgrade 修复。若从 v1.12.2 升级到 v1.13.0,需要先 detach 所有 V2 volumes;升级到 v1.13.1 或更高版本时,才支持 V2 Data Engine live upgrade。
- 建议为 V2 volumes 配置周期性备份:如果 V2 Data Engine 在 snapshot 删除或 system-snapshot purge 过程中发生中断,可能导致 blobstore metadata 不一致,进而引发数据损坏、
spdk_tgtcrash 或 lvstore load failure。Release Notes 建议为 V2 volumes 配置周期性备份,并避免在 snapshot 删除或 purge 过程中重启 V2 instance-manager pod 或节点。
Breaking Changes
- 废弃 Legacy V2 Linked Clone Volumes:v1.12.0 或更早版本创建的 V2 linked-clone volumes 在 v1.12.1 及之后版本中会被标记为 legacy 并废弃。升级后,这类 legacy linked-clone volumes 只能 detach 或 delete,不能继续执行其他操作。需要替换时,应基于相同 source volume 创建新的 linked-clone volume。
V1 Data Engine 修复
- Backing Image 支持 IPv6 与 Dual-Stack:backing image manager 和 data source 现在会遵循 Longhorn 的 IP family selection 逻辑,根据集群或 storage network 使用 IPv4 或 IPv6 地址,支持 IPv4-first 和 IPv6-first dual-stack 集群。
- 修复 replica rebuild 期间并发非对齐写入导致的数据丢失问题:在 replica rebuild 过程中,对同一 4 KiB sector 的小于 4 KiB 并发写入可能出现 read-modify-write 未加锁导致的数据覆盖。v1.12.2 通过 range lock 串行化此类写入。
- 修复 replica rebuild 中 gRPC TCP keepalive 丢失导致的随机失败:sync-agent 现在使用操作系统默认 keepalive 参数,避免单次 keepalive 丢包导致连接在 20 秒后终止。
V2 Data Engine 修复与优化
- SPDK admin reactor 独占 CPU core:SPDK CPU mask 的第一个 core 现在只运行 admin reactor,其余 core 用于 I/O pollers,减少 I/O 负载对管理路径的影响。Release Notes 建议 V2 Data Engine 至少配置 2 个 CPU cores。
- 新增 NVMe-TCP Initiator I/O queue 数量配置:可以通过全局
default-nvme-tcp-nr-io-queues或 volume 级别nvmeTcpNrIoQueues限制 NVMe-TCP I/O queue 数量,降低高核数节点上的内存消耗。 - 修复多类
spdk_tgtcrash 场景:包括 replica rebuild 完成时仍有 I/O、rebuild 过程中的 double free、large-block reads interrupt mode 下的 flush retry、expanded volume snapshot 删除后的 SPDK metadata 问题等。 - 修复 rebuild destination failure 导致整个 engine fault 的问题:现在 destination replica 失败时只会将该 replica 标记为
ERR,保留 engine、frontend 和 I/O。 - 修复 arm64 上 erasure-coded volume write stall:解决 SPDK erasure-coding bdev 中 lost wakeup 导致写入停滞的问题。
安装与升级要求
- 安装或升级到 Longhorn v1.12.2 前,集群需要运行 Kubernetes v1.25 或更高版本。
- Longhorn 仍然只允许从受支持版本进行升级。
如需详细了解完整更新内容,请查阅:
Harvester v1.9.1
Harvester v1.9.1 包含安全修复、升级行为调整,以及多个功能从实验或预览状态进入 GA。本次发布重点涉及 SUSE Linux Micro 安全补丁、eMudhra CA 信任链处理、Bare-Metal Workloads、LVM CSI Driver、Virtual Machine Auto Balance,以及 Rancher on Harvester 的新 add-on 路径。
安全修复
- SUSE Linux Micro BaseOS 安全更新:Harvester 节点基础系统更新了 SUSE 安全补丁,修复 Linux kernel IPv4 网络相关漏洞。
- 处理 eMudhra CA compromise:
ca-certificates-mozilla已更新,使 Harvester 节点不再信任受影响的 root certificates。- Harvester 组件使用 Go 1.26.10 重新构建,Go 证书校验逻辑会拒绝受影响的中间证书。
- 如果此前应用过相关 workaround,升级后需要删除
emudhra-blocklistCloudInit resource 并重启节点。
升级行为变更
- 虚拟机 live migration 失败时不再默认关机:从 v1.7.0 开始,Harvester 在节点升级 pre-drain 阶段,如果 VM 无法 live migrate,可能会自动关闭 VM 以继续升级。v1.9.1 新增
shutdownVMOnMigrationFailure字段控制该行为。false:默认值。VM 继续运行,升级等待 live migration 成功,或由管理员手动停止 VM。true:恢复旧行为,即在 live migration 失败时关闭 VM 以继续升级。
- 当前 Harvester UI 尚未提供该字段配置,需要通过
kubectl edit settings.harvesterhci.io upgrade-config修改。
核心特性
- Bare-Metal Workloads GA:通过 Rancher 中的
harvester-baremetal-container-workloadfeature flag,可以将托管的 Harvester 集群作为标准 downstream Kubernetes cluster 暴露在 Rancher UI 中,让容器化应用直接运行在 bare-metal 节点上,并与虚拟机工作负载并存。 - K3k 与 rancher-k3k Add-On:
rancher-k3kadd-on 支持在 Harvester 集群上运行 Rancher,并替代已废弃的rancher-vclusteradd-on。启用后,Harvester 会部署嵌套 K3s 集群并自动创建 Rancher 实例,用于管理底层 Harvester 集群。 - LVM CSI Driver GA:
harvester-csi-driver-lvmadd-on 进入 GA,可提供 node-local LVM volumes。使用 node-local LVM volumes 的虚拟机不支持 live migration。升级到 GA 前,需要备份关键数据,并删除使用 pre-GA driver 创建的 LVM volumes;pre-GA volumes 与 GA driver 不兼容。 - Virtual Machine Auto Balance GA:该 add-on 基于 Kubernetes Descheduler 自动平衡虚拟机工作负载,可根据管理员定义的策略在节点之间迁移适合迁移的 VM,避免资源倾斜。该版本提供生产可用默认配置、add-on 生命周期管理、节点利用率阈值配置,以及单节点集群保护逻辑。
废弃与移除
- LVM CSI Driver 的
stripedvolume type 废弃:该类型缺少 CSI workflow 所需的 snapshot、clone 和 restore 能力。后续 LVM storage 需要使用dm-thinStorageClass,且不支持原地转换。 rancher-vclusteradd-on 废弃:Harvester v1.9.1 起废弃,并计划在 v1.10.0 移除。需要在 Harvester 集群上运行 Rancher 时,应使用rancher-k3kadd-on。
如需详细了解完整更新内容,请查阅:
Rancher v2.15.3
Rancher v2.15.3 是 Rancher v2.15 系列的最新补丁版本,主要包含安全修复、维护更新和缺陷修复。该版本属于 Community 版本;
安全修复
本次 Rancher v2.15.3 修复了多项 Rancher 与 Fleet 相关安全问题:
- 修复 Rancher meta proxy allowlist 校验位置问题:此前 destination allowlist 的校验位置无法阻止请求继续转发,已认证用户可能让 Rancher server 向 allowlist 本应阻止的内部服务发送请求并接收响应。现在 allowlist 在 request handler 中执行,在建立连接前拒绝不允许的目标。
- 修复 GlobalRole RBAC 校验中的权限提升问题:
GlobalRole的inheritedNamespacedRules字段此前未按权限提升规则校验。拥有管理 global roles 和 global role bindings 委派权限的用户,可能授予超过自身权限范围的 downstream cluster 权限。现在GlobalRole与GlobalRoleBindingadmission webhooks 会像校验其他权限字段一样校验该字段。 - 修复 Rancher Manager meta proxy 凭据转发问题:在部分请求路径中,调用者自身的 Rancher credentials 没有被稳定移除,可能在 provisioning views 的常规使用中被发送到第三方 cloud provider host。现在 proxy 会在所有请求路径上移除调用者凭据。
- 修复 local cluster shell 授权检查覆盖不完整问题:此前保护 local cluster shell 的授权检查没有覆盖所有可到达该能力的 API route,导致任意已认证用户即使没有 local cluster 权限,也可能在 management cluster 获得低权限 shell pod。现在所有请求形式都会一致执行授权检查。
- 修复 Fleet agent management controller 权限提升问题:普通用户创建的 Fleet cluster object 此前可能引用 Rancher management(local)cluster 的管理凭据,从而获得 management cluster 以及所有 managed clusters 的 cluster-admin 权限。现在 Fleet 只接受带有目标 namespace 使用标签的跨 namespace kubeconfig secret,并且只会把 agent 部署到自身 system clusters 对应的 management cluster。
- 修复 Fleet cluster registration 身份绑定问题:此前 cluster registration 中声明的 cluster identity 没有和 registration token 绑定。持有有效 workspace registration token 的用户如果知道另一个 cluster 的 client identifier,可能获取该 cluster 的 Fleet management namespace 凭据并干扰合法 agent。现在 Fleet 会记录 cluster 使用的 registration token,并拒绝同一 cluster identity 搭配不同 token 的注册请求。
Rancher 与集群生命周期修复
- Rancher settings 环境变量回退修复:修复使用环境变量配置的 Rancher settings 在环境变量移除后仍保留旧值和
source: env属性的问题。现在环境变量移除后,Rancher 会在启动时清除存储的 environment source 和 value,使 setting 回到默认值。 - Imported cluster 升级后不可用问题修复:修复 Rancher 升级后,如果 cluster agent 在 registration token 迁移前被重新部署,可能拿到空 token 并导致 imported cluster 不可用的问题。
- S3 etcd snapshot 集群删除卡住问题修复:修复 provisioned clusters 使用 S3 etcd snapshots 时,删除过程可能长期卡住的问题。
如需详细了解完整更新内容,请查阅:
RKE2 11 月补丁版本
RKE2 本期发布了多个正式补丁版本,覆盖 Kubernetes v1.34、v1.35、v1.36、v1.37 分支:
- v1.37.2+rke2r1
- v1.36.6+rke2r1
- v1.35.10+rke2r1
- v1.34.13+rke2r1
这些版本主要更新 Kubernetes patch 版本,并同步更新 containerd、Traefik、CNI、vSphere CSI/CPI、Harvester CSI Driver、snapshot-controller 等组件。
Kubernetes 版本更新
- v1.37.2+rke2r1:Kubernetes 更新至 v1.37.2。
- v1.36.6+rke2r1:Kubernetes 更新至 v1.36.6。
- v1.35.10+rke2r1:Kubernetes 更新至 v1.35.10。
- v1.34.13+rke2r1:Kubernetes 更新至 v1.34.13。
重要兼容性说明
- v1.36 分支中的 ingress-nginx 到 Traefik 迁移:由于 upstream
ingress-nginx已在 2026 年 3 月 retired,RKE2 v1.36 起新集群默认使用 Traefik。已有集群升级时会保留现有 ingress,以避免破坏性变更。- Air-gapped 环境中,
rke2-images-coretarball 现在包含 Traefik images,而不再单独提供rke2-images-traefiktarball。 - 需要继续使用
ingress-nginx的用户,需要手动提供rke2-images-ingress-nginxtarball。 - 社区用户在 v1.37 中不再保留
ingress-nginxchart。
- Air-gapped 环境中,
- Traefik chart v40.x 的 breaking change:部分版本说明中明确指出,Traefik chart 升级到 v40.x 后,ingress-nginx migration 的 provider name 从
kubernetesIngressNginx改为kubernetesIngressNGINX。
组件升级
- Containerd:
- v1.37.2 与 v1.36.6 使用 containerd v2.3.7-k3s1。
- v1.35.10 与 v1.34.13 使用 containerd v2.2.10-k3s1。
- Runc:RKE2 packaged component 中使用 runc v1.4.3。
- CoreDNS:更新至 v1.14.7。
- Metrics Server:更新至 v0.9.0。
- Traefik:
- v1.37.2 使用 chart 42.1.301。
- v1.36.6、v1.35.10、v1.34.13 使用 chart 40.1.022。
- CNI:
- Cilium chart 更新到 1.20.400。
- Canal 使用 Flannel v0.28.10 与 Calico v3.32.2。
- Calico 更新到 v3.32.2。
- Multus 更新到 v4.3.1。
- ingress-nginx:chart 更新到 4.15.115,image 更新到 v1.15.1-prime18。
- Harvester CSI Driver:更新到 v0.2.11,chart 版本为 0.1.33,并使用 Go 1.26.10 重新构建。
- vSphere CSI/CPI:vSphere 相关 chart 更新到新版本。
- snapshot-controller / klipper-helm / HCP:均包含对应版本 bump。
修复与维护项
- 修复或改进了 external cloud controller 默认行为。
- 同步 RKE2 uninstall script。
- 在 killall script 中加入 canal blackhole route cleanup。
- 更新 CNIs、hardened runtime images、hardened containerd、crictl、etcd images。
- 多个分支同步引入 Go 1.26.10 构建更新。
如需详细了解完整更新内容,请查阅:
- RKE2 v1.37.2+rke2r1 Release Notes
- RKE2 v1.36.6+rke2r1 Release Notes
- RKE2 v1.35.10+rke2r1 Release Notes
- RKE2 v1.34.13+rke2r1 Release Notes
K3s 11 月补丁版本
K3s 本期同样发布了多个正式补丁版本,覆盖 Kubernetes v1.34、v1.35、v1.36、v1.37 分支:
- v1.37.2+k3s1
- v1.36.6+k3s1
- v1.35.10+k3s1
- v1.34.13+k3s1
这些版本主要同步 Kubernetes patch 版本,并包含 containerd、Traefik、Flannel、CoreDNS、Helm Controller 等组件更新,以及一批 2026 年 10 月 backports。
Kubernetes 版本更新
- v1.37.2+k3s1:Kubernetes 更新至 v1.37.2。
- v1.36.6+k3s1:Kubernetes 更新至 v1.36.6。
- v1.35.10+k3s1:Kubernetes 更新至 v1.35.10。
- v1.34.13+k3s1:Kubernetes 更新至 v1.34.13。
重要兼容性说明
- Traefik chart v40.x breaking change:v1.35.10 与 v1.34.13 的 Release Notes 中提示,Traefik chart 升级到 v40.x 后,ingress-nginx migration 的 provider name 从
kubernetesIngressNginx改为kubernetesIngressNGINX。使用相关迁移配置的用户需要检查配置名称。
组件升级
- Containerd:
- v1.37.2 使用 containerd v2.3.7-k3s1。
- v1.36.6 使用 containerd v2.3.7-k3s1.36。
- v1.35.10 与 v1.34.13 使用 containerd v2.2.10-k3s1。
- Runc:使用 v1.4.2。
- Flannel:更新至 v0.28.10。
- Metrics Server:更新至 v0.9.0。
- Traefik:更新至 v3.7.15。
- CoreDNS:更新至 v1.14.7。
- Local Path Provisioner:更新至 v0.0.37。
- Helm Controller:
- v1.37.2、v1.36.6、v1.35.10 使用 v0.17.9。
- v1.34.13 使用 v0.16.27。
- Gateway API CRD:v1.37.2 中包含 Kubernetes Gateway API CRD 1.6.301。
修复与 Backports
本轮 K3s 补丁版本包含多项 backports 和维护修复:
- 在没有 default route 时,systemd restart loop 通过等待 default route 出现来避免反复重启。
- apiserver readiness check 排除
kms-providers。 - 改进 etcd local 与 S3 snapshot retention flag 的帮助信息。
- 节点地址变化时更新 ServiceLB status。
- 使用
service-account-signing-endpoint时不再传入默认 SA key flags。 - 修复 SELinux enforcing 场景下 local-path PV 删除问题。
- 加入 etcd snapshot restrictions 相关修复。
- 预拉取镜像时报告 image list 读取错误。
- 修复 etcd disabled 的既有 server 上 etcd member removal 问题。
- 修复 proxy 中的 goroutine leak。
- 对 snapshot restore 测试、Docker/GHCR CI、Gateway API 测试等维护项进行了同步更新。
如需详细了解完整更新内容,请查阅:
- K3s v1.37.2+k3s1 Release Notes
- K3s v1.36.6+k3s1 Release Notes
- K3s v1.35.10+k3s1 Release Notes
- K3s v1.34.13+k3s1 Release Notes
写在最后
本期更新既包含 Rancher 与 Harvester 的安全修复和维护改进,也涵盖 Longhorn V2 数据引擎、RKE2 与 K3s 多个 Kubernetes 分支的持续演进。升级前,建议结合自身环境仔细阅读对应 Release Notes,重点确认版本兼容性及升级注意事项;使用 Longhorn V2 的用户还应特别关注数据保护建议和升级路径要求。
感谢 Rancher 社区开发者、用户与贡献者的持续支持。欢迎通过 GitHub Issue/PR 和社区交流分享使用反馈,与我们共同推动 Rancher 生态不断完善。
我们下期双周报再见!