存储与持久化
🎯 引言
前面部署的 Node.js 订单服务有两个 Pod,它们可能因为更新或故障而被替换。订单数据已经保存在 MySQL 中;如果以后增加上传图片、附件的功能,通常也会交给 对象存储(如 OSS、COS、S3),而不是保存在某个订单 Pod 内。
那么,Kubernetes 为什么还要提供持久化存储?因为有些程序确实需要把文件写到一个目录里,并且希望 Pod 被删除、重新创建后,文件仍然存在。例如,在集群内运行的数据库或其他需要保存文件的服务。
本篇先分清业务数据通常存在哪里、什么时候需要 PVC,再使用 独立的测试 Pod 完成一次文件保留实验。我们不会修改现有订单服务,也不会把“给订单 Pod 挂 PVC”当作上传文件的默认方案。
🧱 为什么 Pod 里的文件可能丢失?
容器可以创建文件,但写在容器可写层里的数据,不会随着容器的重新创建自动保留。例如,旧 Pod 被删除后,新 Pod 即使使用同一个镜像,也不会自动继承旧 Pod 写入的文件。
Kubernetes 可以通过 Volume(卷) 把存储挂载到容器目录。不过,不是所有 Volume 都能长期保存数据:
| 文件存放位置 | 数据能够保留多久? |
|---|---|
| 容器自己的可写层 | 容器被重新创建后,原先写入的数据可能丢失 |
emptyDir 临时卷 | 同一个 Pod 内的容器重启后仍能保留;Pod 被删除后会丢失 |
| 持久卷(通过 PVC 使用) | 在底层存储及 PVC 仍然可用的情况下,可以跨 Pod 删除与重建保留 |
第三种情况就是本篇要亲自验证的:让需要保存的文件独立于 Pod 的生命周期。
📦 实际项目的数据一般保存在哪里?
对于普通 Node.js 业务服务,常见做法是把不同数据交给合适的存储系统,而不是全部写进 Pod:
| 数据 | 常见保存方式 | 订单 Pod 通常需要 PVC 吗? |
|---|---|---|
| 订单、用户等业务记录 | MySQL、PostgreSQL 等数据库 | 不需要 |
| 图片、附件、视频 | 对象存储,如 OSS、COS、S3 | 通常不需要 |
| 应用日志 | 输出到标准输出,由日志系统采集 | 通常不需要 |
| 临时处理文件 | 容器临时目录或 emptyDir | 不需要持久 PVC |
| 集群内需要保存文件的服务 | 根据场景使用持久卷和 PVC | 可能需要 |
这里说的“不需要”,是指 订单服务的 Pod 本身通常不需要挂载 PVC。例如,MySQL 如果也部署在 Kubernetes 内部,它自己的 Pod 仍可能需要 PVC 来保存数据库文件。
因此,我们接下来的 PVC 实验是为了理解 Kubernetes 如何管理持久存储,不是教你把订单附件直接保存在 PVC 中作为生产方案。
🧩 Volume、PV、PVC 是怎么配合的?
假设一个测试 Pod 需要把文件保存在 /app/uploads。我们不用在 Pod 里指定某块硬盘的位置,而是先提交一份存储申请,再让 Pod 使用它。
测试 Pod 怎样获得持久存储?
这是 PVC 工作原理实验,不代表订单服务上传文件的生产方案。
测试 Pod
/app/uploads
通过 Volume 将存储挂载成容器目录
PVC
orders-files · 1Gi
声明需要的容量和访问方式
PV
绑定 PVC 的存储资源
文件保存在 PV 对应的底层存储中
StorageClass 可以决定如何动态创建 PV。示意图展示 Pod、PVC 和 PV 的关系,不代表文件一定存放在独立的物理硬盘上。
| 名称 | 在这个例子中负责什么? |
|---|---|
| Volume | 在 Pod 配置中声明要挂载的存储,并让容器通过 /app/uploads 访问 |
| PVC(PersistentVolumeClaim) | 申请一块满足容量和访问方式要求的存储 |
| PV(PersistentVolume) | 集群中满足 PVC 申请、与其绑定的存储资源 |
| StorageClass | 指定一类存储的提供方式;集群支持时,可以按 PVC 自动创建 PV |
记住它们的关系就够了: Pod 通过 Volume 引用 PVC,PVC 绑定 PV,文件实际保存在 PV 对应的底层存储中。
接下来我们只操作这个独立测试 Pod,不修改正在运行的两个 orders 副本。
🛠 创建一份存储申请
1. 先查看集群能否提供存储
继续使用前面课程的 node-course kind 集群,执行:
kubectl get storageclass
在常见的 kind 环境中,可能看到类似结果:
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE
standard (default) rancher.io/local-path Delete WaitForFirstConsumer
其中 standard (default) 表示这是默认 StorageClass。WaitForFirstConsumer 表示 集群可能要等到使用 PVC 的 Pod 创建后,才会分配和绑定存储。
不同环境的输出可能不同。如果没有可用的默认 StorageClass,也没有预先创建的合适 PV,下面的 PVC 就可能无法完成绑定,需要先为集群配置存储提供方式。不要把 Pending 一律理解为配置出错。
2. 创建 PVC
新建 pvc.yaml:
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: orders-files
namespace: course
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gi
这里只有三个重点:
orders-files:练习用的 PVC 名称,稍后测试 Pod 会通过它找到存储。storage: 1Gi:申请约 1 GiB 的存储容量。ReadWriteOnce:简称 RWO,通常表示卷可以由一个节点以读写方式挂载,不等于只能有一个 Pod 使用。
执行:
kubectl apply -f pvc.yaml
kubectl get pvc -n course
如果此时看到 Pending,先不用急着排错。我们刚才已经看到,某些 StorageClass 要等使用这份 PVC 的 Pod 出现后才会完成绑定。
📦 将存储挂载到测试 Pod
新建 storage-test.yaml,内容如下。这里使用一个轻量的 BusyBox 容器专门做文件验证,不需要修改订单服务代码。
apiVersion: v1
kind: Pod
metadata:
name: orders-storage-test
namespace: course
spec:
containers:
- name: test
image: busybox:1.36
command: ["sh", "-c", "sleep 3600"]
volumeMounts:
- name: files
mountPath: /app/uploads
volumes:
- name: files
persistentVolumeClaim:
claimName: orders-files
先看两处关键配置:
volumes:告诉 Pod,名叫files的卷来自我们刚创建的orders-filesPVC。volumeMounts:把这个卷挂载到容器里的/app/uploads。之后写入这个目录的文件,就会写入对应存储。
执行:
kubectl apply -f storage-test.yaml
kubectl wait --for=condition=Ready pod/orders-storage-test -n course --timeout=120s
kubectl get pvc -n course
模拟输出(实际卷名称会不同):
pod/orders-storage-test created
pod/orders-storage-test condition met
NAME STATUS VOLUME CAPACITY ACCESS MODES
orders-files Bound pvc-12345678-aaaa-bbbb-cccc-123456789abc 1Gi RWO
看到 Bound,说明 PVC 已经成功绑定存储资源;测试 Pod 也已就绪。接着查看集群中的 PV:
kubectl get pv
模拟输出(仅展示关键列,实际卷名称会不同):
NAME STATUS CLAIM STORAGECLASS
pvc-12345678-aaaa-bbbb-cccc-123456789abc Bound course/orders-files standard
我们只创建了 PVC,没有手动创建 PV。这里的 CLAIM 表示这个 PV 已经与 course 命名空间中的 orders-files PVC 绑定;在当前示例中,PV 由 StorageClass 对应的存储供应程序动态创建。
如果 Pod 一直无法启动,先执行 kubectl describe pod orders-storage-test -n course 查看事件,例如存储绑定失败或容器镜像无法拉取,而不是直接跳过。
🔎 删除并重建 Pod,文件还在吗?
现在做这篇文章最重要的实验。
1. 写入文件
使用 kubectl exec 在测试容器内执行一条命令,把内容写入刚才挂载的目录:
kubectl exec -n course orders-storage-test -- \
sh -c 'echo "hello kubernetes" > /app/uploads/hello.txt'
再读取文件:
kubectl exec -n course orders-storage-test -- \
cat /app/uploads/hello.txt
输出:
hello kubernetes
这证明文件已经写入挂载目录,但还不能证明它能在 Pod 消失后保留。
2. 删除旧 Pod,再创建新 Pod
先删除测试 Pod,不要删除 PVC,然后使用同一份 YAML 创建新的测试 Pod:
kubectl delete pod orders-storage-test -n course
kubectl apply -f storage-test.yaml
kubectl wait --for=condition=Ready pod/orders-storage-test -n course --timeout=120s
注意:新 Pod 与旧 Pod 的名称一样,但它是重新创建的 Pod,不是刚才那个 Pod 恢复运行。
3. 重新读取文件
kubectl exec -n course orders-storage-test -- \
cat /app/uploads/hello.txt
预期输出:
hello kubernetes
旧 Pod 已经删除,文件却仍然能被读取。 因为我们保留了 PVC,新 Pod 再次挂载了它绑定的存储,而不是使用旧容器的可写层。
这里验证的是 Pod 删除与重建后,数据能够保留;并不是说任何硬盘故障或整个集群被删除后,数据都一定存在。
⚠️ PVC 不等于永远不会丢数据
本篇还有两个实际使用时需要知道的边界。
第一,多个 Pod 不一定能把同一个 PVC 当作共享盘。 例如 ReadWriteOnce(RWO)通常限制卷只能由一个节点以读写方式挂载,不能直接当作跨节点共享盘。
第二,持久化不等于备份。 PVC 的数据是否能承受节点损坏、集群删除或误删 PVC,取决于底层存储和回收策略。kind 的本地存储适合学习,不能当成生产环境的数据保障方案。MySQL 等有稳定身份和持久化需求的应用,还可能需要 StatefulSet 等机制,但本篇不展开数据库部署。
练习结束后,可以删除测试 Pod:
kubectl delete pod orders-storage-test -n course
如果确认不再需要刚才的练习文件,再删除 PVC:
kubectl delete pvc orders-files -n course
注意:删除 PVC 可能使底层卷及文件被删除,具体取决于 PV 的回收策略。 不要把这条清理命令用于真正保存业务数据的 PVC。
❓ 知识问答
Q:为什么删除测试 Pod 后,文件还在?
因为文件保存在 PVC 绑定的存储中,而不是旧容器的可写层。删除 Pod 不会自动删除它使用的 PVC,新 Pod 重新挂载后就能读取之前的文件。
Q:PVC 刚创建时显示 Pending,就是坏了吗?
不一定。某些 StorageClass 使用 WaitForFirstConsumer,要等使用 PVC 的 Pod 创建后才绑定;如果创建 Pod 后仍未绑定,再查看 StorageClass 和 Pod、PVC 的事件。
Q:有了 PVC,还需要备份吗?
需要。PVC 解决的是 Pod 如何使用持久存储,不保证底层存储永远不会损坏或被误删。
🧪 小练习
独立完成一次文件保留验证:创建测试 Pod 后,在 /app/uploads 中写入一个 order-001.txt 文件,内容自定;然后删除并重新创建这个 Pod,检查文件是否还在。
验收标准: 不仅能重新读取文件,还能解释为什么 删除 Pod 后仍能读取,而删除 PVC 可能导致数据丢失。
🎉 恭喜你!现在你不仅知道普通 Node.js 服务的数据通常应该保存在哪里,也理解了 Volume、PV 和 PVC 的关系,并亲手验证:只要底层存储和 PVC 仍然可用,Pod 被重新创建后也能继续读取之前保存的文件。
