# docs/03-05-k3s-local-path-pvc.md
apiVersion: v1 # PVC：Kubernetes 核心 API
kind: PersistentVolumeClaim # 持久卷声明（你“申请要用的存储”）
metadata: # PVC 的元信息（名称/命名空间/其它元数据）
  name: local-pvc-demo # PVC 名称（Deployment 里会引用）
  namespace: default # PVC 所在命名空间
spec: # PVC 的期望状态（访问模式/存储类/容量请求）
  accessModes: # 访问模式：RWO 表示同一时刻只能被一个节点上的一个 Pod 以读写方式挂载
    - ReadWriteOnce # 读写模式：单节点可读写
  storageClassName: local-path # 指定存储类：使用 K3s 的 local-path-provisioner（动态创建本地 PV）
  resources: # 资源请求（本例只关心 storage 容量）
    requests: # 容量配额请求（与 requests.storage 对应）
      storage: 1Gi # 申请容量大小（K8s quantity：常见后缀 Ki/Mi/Gi/Ti/…，示例：512Mi、1024Mi、1Gi、1G；也可写字节值）
---
apiVersion: apps/v1 # Deployment：apps API
kind: Deployment # 部署器：管理 Pod 副本、滚动更新等
metadata: # Deployment 的元信息
  name: nginx-local-pvc-demo # Deployment 名称
  namespace: default # 部署到的命名空间（Deployment 里引用 PVC 时也必须同 namespace）
spec: # Deployment 的期望状态（副本数、选择器、Pod 模板等）
  replicas: 1 # Pod 副本数（用于验证持久化，保持单副本更直观）
  selector: # Deployment 选择器：用于匹配/管理模板 Pod
    matchLabels: # 标签匹配集合（必须与 template.metadata.labels 对上）
      app: nginx-local-pvc-demo # Deployment 用该 label 选择/管理自己的 Pod
  template: # Pod 模板（Deployment 用它创建/更新 Pod）
    metadata: # Pod 元信息
      labels: # Pod 标签：必须与 selector.matchLabels 对齐
        app: nginx-local-pvc-demo # Pod 模板 label：必须与 selector.matchLabels 对上
    spec: # Pod 规范
      nodeSelector: # 指定调度节点（本地盘绑定节点；请按实际节点主机名修改）
        kubernetes.io/hostname: ylc61 # 仅调度到主机名为 ylc61 的节点
      containers: # 容器列表
        - name: nginx # 容器名
          image: nginx:alpine # nginx 镜像
          volumeMounts: # 容器内挂载点（把卷挂到 mountPath）
            - name: data # 与下方 volumes[].name 对应：挂载哪个卷
              mountPath: /usr/share/nginx/html # 挂载点：写入此目录会落到 PVC/PV 上
      volumes: # Pod 内定义的卷列表
        - name: data # Pod 内的卷名（给 volumeMounts 用）
          persistentVolumeClaim: # 使用 PVC 作为卷来源
            claimName: local-pvc-demo # 绑定到哪个 PVC（必须与上面 PVC metadata.name 且同 namespace）