Kubernetes 1.29：用于卷修改的 VolumeAttributesClass

作者：Sunny Song (Google) |

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

您可以在 Kubernetes 文档中阅读有关 VolumeAttributesClass 用法的详细信息，或者继续阅读以了解 Kubernetes 项目为何支持此功能。

VolumeAttributesClass

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

VolumeAttributesClass

表示 CSI 驱动程序定义的可变卷属性的规范。可以在动态配置 PersistentVolumeClaims 期间指定该类，并在配置后在 PersistentVolumeClaim 规范中更改。

ModifyVolumeStatus

表示 ControllerModifyVolume 操作的状态对象。

启用此 alpha 功能后，PersistentVolumeClaim 的规范定义了 PVC 中使用的 VolumeAttributesClassName。在卷配置时，CreateVolume 操作将应用 VolumeAttributesClass 中的参数以及 StorageClass 中的参数。

当 PVC 规范中的 volumeAttributesClassName 发生更改时，external-resizer sidecar 将收到一个 informer 事件。根据配置的当前状态，调整器将触发 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. 使用以下命令验证 PersistentVolumeClaims 是否具有更新的 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)