容器与云原生 / 系统课时

控制默认 StorageClass 行为

控制默认 StorageClass 行为

默认 StorageClass 影响的是“没有指定存储类”的 PVC,而不是所有 PVC。本课用三个请求方式拆清默认选择规则,并通过 kubectl 检查和切换默认类,避免显式空值、多默认类和默认类迁移造成错误供给。

学习目标

  • 区分省略 storageClassName、显式空字符串和显式类名三种请求语义。
  • 检查并切换默认 StorageClass,识别多默认类的选择规则。
  • 用 PVC 实验验证默认赋值与“不使用存储类”的差异。

默认选择发生在哪

StorageClass 是否为默认类由注解 storageclass.kubernetes.io/is-default-class: "true" 标记。PVC 的 spec.storageClassName 决定控制面是否可以应用这个默认值,三种写法必须分开理解。

  • 省略 storageClassName:表示没有指定存储类。存在默认 StorageClass 时,PVC 会得到默认类;当前没有默认类时,它可以先保持未设置,之后默认类出现时再被补上。
  • 显式写 storageClassName: "":表示明确要求“不使用 StorageClass”。它不会被默认类覆盖,也不会因为后来出现默认类而改写,只会与同样没有存储类的合适 PV 匹配。
  • 显式写类名:例如 storageClassName: fast-csi,PVC 固定请求该类,集群默认类如何变化都不参与选择。

如果同时存在多个默认 StorageClass,未指定类的 PVC 会使用创建时间最新的默认类,而不是最近被打上默认注解的类。因此多默认状态只适合短暂迁移,不应作为长期配置。

默认 StorageClass 的 PVC 选择路径

检查当前默认类

先看集群里哪些 StorageClass 被标成默认,同时把创建时间列出来。这样既能发现“双默认”,也能判断在多默认窗口中哪个类会胜出。

bash
kubectl get storageclass -o custom-columns='NAME:.metadata.name,DEFAULT:.metadata.annotations.storageclass\.kubernetes\.io/is-default-class,CREATED:.metadata.creationTimestamp'

预期输出

text
NAME           DEFAULT   CREATED
<OLD_SC>       true      <TIME>
<TARGET_SC>    <none>    <TIME>

实际名称和时间会不同。正常稳态应只有一个 DEFAULT=true;<none> 或 false 都表示该类不是默认类。

切换默认类

默认类切换本质上是修改注解。下面先取消旧默认,再启用目标默认,操作简单且不会留下长期双默认;两条命令之间存在短暂“无默认类”窗口,因此应连续执行,并避免在这段窗口批量创建未指定存储类的 PVC。

bash
kubectl patch storageclass <OLD_SC> --type=merge -p '{"metadata":{"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

kubectl patch storageclass <TARGET_SC> --type=merge -p '{"metadata":{"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

kubectl get storageclass

预期输出

text
storageclass.storage.k8s.io/<OLD_SC> patched
storageclass.storage.k8s.io/<TARGET_SC> patched
NAME          PROVISIONER        RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
<OLD_SC>      <VALUE>            <VALUE>         <VALUE>                <VALUE>                <VALUE>
<TARGET_SC> (default) <VALUE>    <VALUE>         <VALUE>                <VALUE>                <VALUE>

kubectl get storageclass 的列宽和字段可能因版本而略有不同,关键验收点是只剩 <TARGET_SC> 带 (default)。已经明确写入某个 storageClassName 的 PVC 不会因为这次切换而改到新类。

验证省略与显式空值

在确认集群恰好有一个默认类后,可以创建两个 PVC:一个省略字段,一个明确写空字符串。这个实验只验证类选择,不要求 PVC 最终一定 Bound;若默认类使用 WaitForFirstConsumer,没有 Pod 消费时 PVC 保持 Pending 也可能是正常行为。

bash
kubectl create namespace sc-default-demo --dry-run=client -o yaml | kubectl apply -f -

kubectl apply -n sc-default-demo -f - <<'YAML'
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: pvc-default
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: pvc-no-class
spec:
  storageClassName: ""
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
YAML

kubectl get pvc -n sc-default-demo -o custom-columns='NAME:.metadata.name,CLASS:.spec.storageClassName,PHASE:.status.phase'

预期输出

text
namespace/sc-default-demo created
persistentvolumeclaim/pvc-default created
persistentvolumeclaim/pvc-no-class created
NAME           CLASS          PHASE
pvc-default    <DEFAULT_SC>   <VALUE>
pvc-no-class   <none>         <VALUE>

重复执行时命名空间可能显示 unchanged,PVC 也可能显示 unchanged。真正需要核对的是 pvc-default 得到默认类,而 pvc-no-class 的类仍为空。若前者没有得到类,应先回到 StorageClass 注解和多默认状态排查,而不是直接怀疑 CSI provisioner。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

控制默认 StorageClass 行为

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通