AKS 1.26.6环境下StatefulSet持久卷扩容操作疑问求助

问题背景 #

在Azure Kubernetes Service（AKS）1.26.6版本环境中，尝试为StatefulSet关联的持久卷扩容，该持久卷由默认类型的Storage Class创建。

根据Kubernetes官方文档，只需更新StatefulSet的PVC规格字段并重新部署，即可无停机扩容持久卷。但尝试此操作时，遇到报错：

Error: UPGRADE FAILED: cannot patch "grafana-loki-querier" with kind StatefulSet: StatefulSet.apps "grafana-loki-querier" is invalid: spec: Forbidden: updates to statefulset spec for fields other than 'replicas', 'ordinals', 'template', 'updateStrategy', 'persistentVolumeClaimRetentionPolicy' and 'minReadySeconds' are forbidden

随后通过删除重建StatefulSet，成功用Helm部署了扩容后的PVC。

疑问解答 #

1. 是否误解了Kubernetes官方文档的内容？

没有误解文档核心，但忽略了StatefulSet的字段更新限制。Kubernetes官方提到的“更新StatefulSet的PVC规格”，实际指的是直接修改已创建的PVC对象的spec.resources.requests.storage字段，而非修改StatefulSet模板中的volumeClaimTemplates定义。StatefulSet的volumeClaimTemplates属于不可更新的核心字段（仅官方列出的少数字段允许修改），因此直接通过Helm修改该字段会触发报错。

2. 既然可通过kubectl edit pvc直接修改PVC规格扩容，为何Kubernetes限制通过Helm部署更新PVC大小？

Kubernetes并未限制Helm更新PVC，限制的是修改StatefulSet的volumeClaimTemplates字段。Helm默认会尝试Patch StatefulSet对象，而该字段不在允许更新的范围内，因此报错。直接编辑PVC是操作独立的PVC资源，这属于Kubernetes允许的操作（前提是StorageClass支持扩容），与StatefulSet模板的修改完全无关。

3. 为何该扩容流程未整合到Helm部署中？

Helm的核心是维护资源的期望状态，而StatefulSet的volumeClaimTemplates创建后，对应的PVC是独立存在的（每个Pod对应一个专属PVC）。如果Helm强制修改StatefulSet模板中的PVC大小，会与已存在的PVC实际状态冲突，同时违反Kubernetes对StatefulSet字段的更新规则。此外，PVC扩容是针对已有资源的调整操作，不属于StatefulSet模板的初始化定义范畴，因此Helm没有默认整合该流程，需要用户手动操作或通过自定义脚本实现。

4. 为何需要删除重建StatefulSet才能完成扩容？

删除重建StatefulSet的目的是让Helm重新生成包含新PVC大小的StatefulSet模板，但实际扩容的核心是PVC本身的修改。删除StatefulSet时，只要PVC的保留策略为默认的Retain或Delete（Delete策略不会删除已绑定的PVC），已有的PVC不会被删除。重建后的StatefulSet会继续使用已扩容的PVC，同时新模板会记录新的规格（方便后续新Pod创建时应用新的存储大小）。如果仅需扩容现有PVC，无需删除StatefulSet，直接编辑PVC即可；删除重建只是为了让StatefulSet模板同步新的PVC规格。

内容的提问来源于stack exchange，提问作者Kiran Hegde