43 lines
2.7 KiB
YAML
43 lines
2.7 KiB
YAML
# 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）
|
||
|