Managed Lustre CSI 驱动程序参考

以下清单介绍了存储类别和永久性卷资源中受支持的 CSI 驱动程序字段。

存储类别

以下清单包含存储类别中所有受支持的字段。

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: lustre-csi-example-storage-class
provisioner: lustre.csi.storage.gke.io
parameters:
  network: VPC_NETWORK # optional
  filesystem: LUSTRE_FILESYSTEM_NAME # optional
  labels: KEY_1=VALUE_1,KEY_2=VALUE_2,...,KEY_N=VALUE_N # optional
  description: DESCRIPTION # optional
  perUnitStorageThroughput: 125 | 250 | 500 | 1000  # required
volumeBindingMode: WaitForFirstConsumer | Immediate # default is Immediate
allowedTopologies:
- matchLabelExpressions:
  - key: topology.gke.io/zone
    values:
    - ZONE_1
    - ZONE_2
mountOptions:
  - LUSTRE_MOUNT_OPTIONS

替换以下值：

  • network：可选。要在其中创建 Managed Lustre 实例的虚拟私有云 (VPC) 网络。 如果未指定此属性，则系统会使用默认网络。

    如需在共享 VPC 网络中创建 Managed Lustre 实例，必须提供网络的完整名称。例如，projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME。

  • filesystem：为 Managed Lustre 实例指定 fsname。此参数用于动态预配。 fsname 必须是最多包含 8 个字符的字母数字字符串，且以字母字符开头。如果您未 提供值，CSI 驱动程序会生成格式为 "lfsNNNNN"（例如 "lfs97603"）的 fsname。

  • labels：可选。 Managed Lustre 支持为每个实例添加标签，以键值对映射的形式呈现。借助 Managed Lustre CSI 驱动程序，您可以将用户提供的标签附加到实例。

  • description：可选。实例的说明。必须不超过 2,048 个字符。

  • perUnitStorageThroughput：为实例指定每单位存储吞吐量 (MB/s/TiB)。支持的值包括 125、250、500 和 1000。默认值为 1000。

  • allowTopologies：可选。Managed Lustre 实例是可用区级资源。如果未指定此属性，则系统会在与 CSI 控制器驱动程序 Pod 相同的可用区中创建 Managed Lustre 实例，并且卷绑定模式默认为 Immediate。

    如果指定了 WaitForFirstConsumer，则拓扑将设置为 Pod 的调度位置。不过，此设置可能会导致 Pod 在等待卷预配时被阻止。

    Managed Lustre CSI 驱动程序支持 拓扑功能，以确保根据 StorageClass 中提供的拓扑，将永久性卷和 Pod 放置 在允许的拓扑中。

  • mountOptions：可选。指定 mount.lustre 装载选项。Managed Lustre 卷会从 pv.spec.mountOptions 字段中的 StorageClass 继承这些装载选项。

永久性卷

以下清单包含永久性卷中所有受支持的字段。

apiVersion: v1
kind: PersistentVolume
metadata:
 name: preprov-pv
 annotations:
   pv.kubernetes.io/provisioned-by: lustre.csi.storage.gke.io
spec:
 mountOptions:
   - LUSTRE_MOUNT_OPTIONS
   ...
 storageClassName: ""
 capacity:
   storage: CAPACITY
 accessModes:
   - ReadWriteMany
 persistentVolumeReclaimPolicy: Retain
 volumeMode: Filesystem
 csi:
   driver: lustre.csi.storage.gke.io
   volumeHandle: EXISTING_LUSTRE_INSTANCE_NAME
   volumeAttributes:
     ip: EXISTING_LUSTRE_IP_ADDRESS
     filesystem: EXISTING_LUSTRE_FSNAME

替换以下值：

  • capacity.storage：Managed Lustre 实例的容量。 如需了解支持的实例容量下限和上限，请参阅性能层级 。
  • mountOptions：指定 mount.lustre 装载选项。此值继承自 StorageClass 中的 mountOptions 字段。
  • csi.volumeHandle：Managed Lustre 实例的专属标识符。必须使用以下 格式：PROJECT_ID/LOCATION/INSTANCE_NAME。
  • csi.volumeAttributes.ip：Managed Lustre 实例的 IP 地址，用于装载。
  • csi.volumeAttributes.filesystem：Managed Lustre 实例的文件系统名称，这是一个包含 8 个字符的标识符。