03-06-k3s local-path PVC 本地持久化

K3s 自带的 local-path-provisioner：通过 PVC 自动创建本地 PersistentVolume，适用于单副本应用、缓存、日志等，无需 NFS 或 Longhorn。

与 NFS / Longhorn 的区别

方式	共享	适用场景
local-path（本页）	否，单节点	单副本应用（Traefik acme.json、单机数据库等），Pod 固定调度到同一节点
NFS（`03-08`）	是，多节点读写	多副本共享目录、需跨节点访问
Longhorn（`03-09`）	块存储，CSI	重状态系统、快照/备份、生产推荐

前置条件

K3s 已安装（local-path-provisioner 默认启用）
无额外组件，kubectl get storageclass 可见 local-path（通常为默认）

操作步骤

1. 清单（PVC + Deployment）

唯一真源：ansible/files/local-path-demo/local-path-pvc-demo.yaml（含 PVC local-pvc-demo 与 nginx-local-pvc-demo Deployment；storageClassName 可省略，K3s 默认多为 local-path）。

2. 应用与验证

kubectl apply -f ansible/files/local-path-demo/local-path-pvc-demo.yaml

kubectl get pv,pvc
kubectl get pod -o wide
kubectl exec deploy/nginx-local-pvc-demo -- sh -c 'echo hello > /usr/share/nginx/html/test.txt'
kubectl delete pod -l app=nginx-local-pvc-demo
kubectl exec deploy/nginx-local-pvc-demo -- cat /usr/share/nginx/html/test.txt  # 应仍为 hello

注意事项

绑定到节点：PV 创建在 Pod 首次调度到的节点上，Pod 重建后仍会调度到该节点（provisioner 会打 nodeAffinity）
单副本：ReadWriteOnce，同一 PVC 只能被同一节点上的一个 Pod 挂载；多副本需 NFS 或 Longhorn
数据路径：默认在 K3s --data-dir 下的 storage，如 /var/lib/rancher/k3s/storage 或 /storage
回收策略：Delete，删除 PVC 时 PV 及本地目录会被清理

Traefik acme.json 示例

若希望 Traefik 的 ACME 证书走 local-path PVC，需在 HelmChartConfig 的 values 中为 Traefik 配置 volume 与 volumeMount（见 03-02-k3s-traefik-acme.md 可选配置）。多数场景下，配合 nodeSelector 固定 Traefik 到同一节点，再用 hostPath 或 local-path 均可；无 hostPath 时 K3s 默认会为 Traefik 挂 emptyDir 或默认卷。

下一步

03-06-k3s-使用nfs存储.md：需多节点共享时
03-07-k3s-longhorn-持久化存储.md：重状态、快照、备份

2.5 KiB Raw Blame History Unescape Escape