存储与持久化

了解 Node.js 业务数据的常见存储方式,理解 Volume、PV、PVC 的关系,并通过重建测试 Pod 验证持久化。

🎯 引言

前面部署的 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-files PVC。
  • 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 被重新创建后也能继续读取之前保存的文件。