Referensi driver CSI Managed Lustre

Manifes berikut menjelaskan kolom driver CSI yang didukung di resource StorageClass dan Persistent Volume.

Kelas Penyimpanan

Manifes berikut mencakup semua kolom yang didukung di Storage Class.

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

Ganti nilai berikut:

  • network: optional. Jaringan Virtual Private Cloud (VPC) tempat instance Managed Lustre akan dibuat. Jika properti ini tidak ditentukan, jaringan default akan digunakan.

    Untuk membuat instance Managed Lustre di jaringan VPC bersama, nama lengkap jaringan harus diberikan. Misalnya, projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME.

  • filesystem: menentukan fsname untuk instance Managed Lustre. Parameter ini digunakan untuk penyediaan dinamis. fsname harus berupa string alfanumerik hingga delapan karakter, yang diawali dengan karakter alfabet. Jika Anda tidak memberikan nilai, driver CSI akan membuat fsname dengan format "lfsNNNNN" (misalnya, "lfs97603").

  • labels: optional. Managed Lustre mendukung label per instance, sebagai peta pasangan key-value. Driver CSI Managed Lustre memungkinkan Anda melampirkan label yang disediakan pengguna ke instance.

  • description: optional. Deskripsi instance. Harus terdiri dari 2.048 karakter atau kurang.

  • perUnitStorageThroughput: menentukan throughput penyimpanan per unit (MB/dtk/TiB) untuk instance. Nilai yang didukung adalah 125, 250, 500, dan 1000. Defaultnya adalah 1000.

  • allowTopologies: optional. Instance Managed Lustre adalah resource zonal. Jika properti ini tidak ditentukan, instance Managed Lustre akan dibuat di zona yang sama dengan Pod Driver pengontrol CSI, dan mode pengikatan volume akan ditetapkan secara default ke Immediate.

    Jika WaitForFirstConsumer ditentukan, topologi akan ditetapkan ke tempat Pod dijadwalkan. Namun, setelan ini dapat menyebabkan Pod diblokir saat menunggu volume disediakan.

    Driver CSI Managed Lustre mendukung fitur topologi untuk memastikan volume persisten dan Pod ditempatkan dalam topologi yang diizinkan, berdasarkan topologi yang disediakan di StorageClass.

  • mountOptions: optional. Menentukan opsi pemasangan mount.lustre. Volume Managed Lustre mewarisi opsi pemasangan ini dari StorageClass di kolom pv.spec.mountOptions.

Volume Persisten

Manifes berikut mencakup semua kolom yang didukung di Persistent Volume.

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

Ganti nilai berikut:

  • capacity.storage: kapasitas instance Managed Lustre. Lihat Tingkatan performa untuk kapasitas instance minimum dan maksimum yang didukung.
  • mountOptions: Menentukan opsi pemasangan mount.lustre. Nilai ini diwarisi dari kolom mountOptions di StorageClass.
  • csi.volumeHandle: ID eksklusif untuk instance Managed Lustre. Harus menggunakan format berikut: PROJECT_ID/LOCATION/INSTANCE_NAME.
  • csi.volumeAttributes.ip: alamat IP instance Managed Lustre, yang digunakan untuk pemasangan.
  • csi.volumeAttributes.filesystem: nama sistem file instance Managed Lustre, yang merupakan ID delapan karakter.