首页
/ Rancher Local Path Provisioner动态存储配置实践:基于节点亲和性的PVC挂载

Rancher Local Path Provisioner动态存储配置实践:基于节点亲和性的PVC挂载

2025-07-01 02:13:21作者:申梦珏Efrain

背景与问题场景

在使用Kubernetes集群时,动态存储供应是常见的需求。Rancher提供的local-path-provisioner作为轻量级本地存储方案,特别适合边缘计算或开发测试环境。但在实际使用中,当我们需要结合节点亲和性(Node Affinity)实现动态存储供应时,可能会遇到存储卷无法自动创建的典型问题。

核心问题分析

从问题描述中可以看到,用户尝试在k3s集群中实现以下目标:

  1. 通过节点标签(local-storage=enabled)选择特定节点
  2. 将节点的/tmp/blah目录通过动态供应的方式挂载到Pod中
  3. 使用StorageClass和PVC实现这一过程

但出现了Pod和PVC互相等待的"死锁"状态:

  • Pod状态为Pending,等待PVC绑定
  • PVC状态为Pending,等待PV创建

关键配置解析

1. StorageClass配置要点

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: local-storage-class
provisioner: rancher.io/local-path
parameters:
  fsType: ext4
reclaimPolicy: Retain
volumeBindingMode: WaitForFirstConsumer

这里有几个关键参数值得注意:

  • volumeBindingMode: WaitForFirstConsumer:这是实现节点亲和性的关键,它延迟了存储绑定直到Pod被调度
  • reclaimPolicy: Retain:确保PV删除后数据保留,适合生产环境

2. ConfigMap配置

local-path-provisioner通过ConfigMap定义节点路径映射:

data:
  config.json: |-
    {
      "nodePathMap":[
        {
          "node":"dell5000",
          "paths":["/tmp/blah"]
        }
      ]
    }

这里明确定义了特定节点(dell5000)上可用的存储路径。

3. PVC配置优化

原始配置中使用了ReadWriteOnce访问模式,但更精确的解决方案是使用ReadWriteOncePod

accessModes:
  - ReadWriteOncePod

这是Kubernetes 1.22+引入的新模式,确保卷只能被单个Pod独占访问,更符合本地存储的使用场景。

解决方案实现

1. 节点准备

首先确保目标节点有正确的标签:

kubectl label nodes dell5000 local-storage=enabled

2. 存储资源配置

创建包含以下关键元素的存储资源配置:

  • 正确的StorageClass定义
  • 精确的ConfigMap路径映射
  • 使用ReadWriteOncePod的PVC

3. 工作负载配置

在Deployment中需要明确指定节点亲和性:

affinity: 
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
      - matchExpressions:
        - key: local-storage
          operator: In
          values:
          - enabled

经验总结

  1. 访问模式选择:对于本地存储,ReadWriteOncePod比传统的ReadWriteOnce更精确,能避免潜在的访问冲突。

  2. 绑定时机控制WaitForFirstConsumer模式对于有节点亲和性要求的存储供应至关重要,它确保调度器先选择节点再创建存储。

  3. 路径权限管理:确保ConfigMap中指定的主机路径存在且有适当权限,否则provisioner可能无法创建卷。

  4. 调试技巧:当PVC处于Pending状态时,可通过kubectl describe pvc查看事件日志,通常会显示具体等待原因。

进阶建议

对于生产环境,还应考虑:

  1. 设置资源限制,防止单个Pod占用过多本地存储
  2. 实现存储监控,跟踪本地存储使用情况
  3. 考虑使用Local PersistentVolume替代方案,对于固定需求的场景可能更合适

通过以上配置和优化,可以可靠地在Rancher local-path-provisioner中实现基于节点亲和性的动态存储供应,满足特定业务场景的需求。

登录后查看全文

项目优选

收起
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
51
15
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
566
410
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
124
208
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
75
145
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
428
38
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
693
91
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
98
253
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
298
1.03 K
Dora-SSRDora-SSR
Dora SSR 是一款跨平台的游戏引擎,提供前沿或是具有探索性的游戏开发功能。它内置了Web IDE,提供了可以轻轻松松通过浏览器访问的快捷游戏开发环境,特别适合于在新兴市场如国产游戏掌机和其它移动电子设备上直接进行游戏开发和编程学习。
C++
20
4
CS-BooksCS-Books
🔥🔥超过1000本的计算机经典书籍、个人笔记资料以及本人在各平台发表文章中所涉及的资源等。书籍资源包括C/C++、Java、Python、Go语言、数据结构与算法、操作系统、后端架构、计算机系统知识、数据库、计算机网络、设计模式、前端、汇编以及校招社招各种面经~
96
13