首页/云/Kubernetes 速查/local 卷与本地 PV
本包目录(307 条)
kubectl 基础56 条工作负载36 条网络与服务55 条
配置与存储54 条
调度与资源52 条集群运维与排障54 条

local 卷与本地 PV

把节点本地磁盘以 local 卷暴露,配合 nodeAffinity 固定调度;吞吐与延迟占优,但不具备跨节点冗余,节点故障时数据不可用。

Kubernetes 速查云更新于 2026-10-12

local PV 片段

local PV 片段
apiVersion: v1
kind: PersistentVolume
metadata:
  name: local-pv-node1
spec:
  capacity:
    storage: 500Gi
  accessModes:
    - ReadWriteOnce
  persistentVolumeReclaimPolicy: Retain
  storageClassName: local-ssd
  local:
    path: /mnt/disks/ssd1
  nodeAffinity:
    required:
      nodeSelectorTerms:
        - matchExpressions:
            - key: kubernetes.io/hostname
              operator: In
              values:
                - node1
本地卷通常配合 static provisioner(如 sig-storage 的 local-volume-provisioner)批量创建;回收策略建议 Retain。

易错点

  • 漏配 nodeAffinity 时调度器可能把 Pod 放到没有该磁盘的节点,卷挂载失败
  • local PV 的路径需要在节点上预先创建并格式化,kubelet 不会替你准备

数据来源与参考

  • Kubernetes 官方文档 · local 卷
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌