容器与云原生 / 系统课时
控制默认 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 被标成默认,同时把创建时间列出来。这样既能发现“双默认”,也能判断在多默认窗口中哪个类会胜出。
kubectl get storageclass -o custom-columns='NAME:.metadata.name,DEFAULT:.metadata.annotations.storageclass\.kubernetes\.io/is-default-class,CREATED:.metadata.creationTimestamp'预期输出
NAME DEFAULT CREATED
<OLD_SC> true <TIME>
<TARGET_SC> <none> <TIME>实际名称和时间会不同。正常稳态应只有一个 DEFAULT=true;<none> 或 false 都表示该类不是默认类。
切换默认类
默认类切换本质上是修改注解。下面先取消旧默认,再启用目标默认,操作简单且不会留下长期双默认;两条命令之间存在短暂“无默认类”窗口,因此应连续执行,并避免在这段窗口批量创建未指定存储类的 PVC。
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预期输出
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 也可能是正常行为。
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'预期输出
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。