Kubernetes 1.29：用于卷修改的 VolumeAttributesClass

Kubernetes v1.29 版本引入了一个 Alpha 特性，支持通过更改为 PersistentVolumeClaim (PVC) 指定的 volumeAttributesClassName 来修改卷。启用该特性后，Kubernetes 可以处理容量以外的卷属性更新。允许更改卷属性而无需直接通过不同提供商的 API 进行管理，简化了当前的流程。

你可以在 Kubernetes 文档中阅读有关 VolumeAttributesClass 用法的详细信息，或者继续阅读以了解 Kubernetes 项目支持此特性的原因。

VolumeAttributesClass

新的 storage.k8s.io/v1alpha1 API 组提供了两种新类型：

VolumeAttributesClass

表示由 CSI 驱动程序定义的可变卷属性的规约。该类可以在 PersistentVolumeClaim 的动态制备期间指定，并在制备后在 PersistentVolumeClaim 的 spec 中进行更改。

ModifyVolumeStatus

表示 ControllerModifyVolume 操作的状态对象。

启用此 Alpha 特性后，PersistentVolumeClaim 的 spec 中定义了在 PVC 中使用的 VolumeAttributesClassName。在卷制备时，CreateVolume 操作将应用 VolumeAttributesClass 中的参数以及 StorageClass 中的参数。

当 PVC spec 中的 volumeAttributesClassName 发生变化时，external-resizer sidecar 将收到一个 informer 事件。根据配置的当前状态，resizer 将触发 CSI ControllerModifyVolume。更多细节可以在 KEP-3751 中找到。

如何使用它

如果你想在 Alpha 阶段测试该功能，你需要在 kube-controller-manager 和 kube-apiserver 中启用相关的特性门控。使用 --feature-gates 命令行参数：

--feature-gates="...,VolumeAttributesClass=true"

这还要求 CSI 驱动程序已实现 ModifyVolume API。

用户流程

如果你想看到该功能的实际效果并验证它在你的集群中是否正常工作，可以尝试以下操作：

1. 定义一个 StorageClass 和一个 VolumeAttributesClass

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: csi-sc-example
   provisioner: pd.csi.storage.gke.io
   parameters:
     type: "hyperdisk-balanced"
   volumeBindingMode: WaitForFirstConsumer
   

   apiVersion: storage.k8s.io/v1alpha1
   kind: VolumeAttributesClass
   metadata:
     name: silver
   driverName: pd.csi.storage.gke.io
   parameters:
     provisioned-iops: "3000"
     provisioned-throughput: "50"
   

2. 定义并创建 PersistentVolumeClaim

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: test-pv-claim
   spec:
     storageClassName: csi-sc-example
     volumeAttributesClassName: silver
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 64Gi
   

3. 使用以下命令验证 PersistentVolumeClaim 现在已正确制备：

   kubectl get pvc
   

4. 创建一个新的 VolumeAttributesClass `gold`

   apiVersion: storage.k8s.io/v1alpha1
   kind: VolumeAttributesClass
   metadata:
     name: gold
   driverName: pd.csi.storage.gke.io
   parameters:
     iops: "4000"
     throughput: "60"
   

5. 使用新的 VolumeAttributesClass 更新 PVC 并应用

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: test-pv-claim
   spec:
     storageClassName: csi-sc-example
     volumeAttributesClassName: gold
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 64Gi
   

6. 使用以下命令验证 PersistentVolumeClaim 是否已更新了 VolumeAttributesClass 参数：

   kubectl describe pvc <PVC_NAME>
   

后续步骤

• 有关设计的更多信息，请参阅 VolumeAttributesClass KEP
• 你可以在 VolumeAttributesClass 的项目看板上查看或发表评论
• 为了将此功能推向 Beta 版，我们需要社区的反馈，因此我们在此号召大家：为 CSI 驱动程序添加支持，试用此功能，考虑它如何帮助解决用户遇到的问题……

参与进来

我们始终欢迎新的贡献者。因此，如果你想参与其中，可以加入我们的 Kubernetes 存储特别兴趣小组 (SIG)。

如果你想分享反馈，可以在我们的公共 Slack 频道上进行。

特别感谢所有提供出色审查、分享宝贵见解并帮助实现此功能的贡献者（按字母顺序排列）：

• Baofa Fan (calory)
• Ben Swartzlander (bswartz)
• Connor Catlett (ConnorJC3)
• Hemant Kumar (gnufied)
• Jan Šafránek (jsafrane)
• Joe Betz (jpbetz)
• Jordan Liggitt (liggitt)
• Matthew Cary (mattcary)
• Michelle Au (msau42)
• Xing Yang (xing-yang)

• ←上一篇
• 下一篇→