Riferimento al driver CSI Managed Lustre

I seguenti manifest descrivono i campi del driver CSI supportati nelle risorse Storage Class e Persistent Volume.

Classe di archiviazione

Il seguente manifest include tutti i campi supportati in 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

Sostituisci i seguenti valori:

• network: facoltativo. La rete Virtual Private Cloud (VPC) in cui creare l'istanza Managed Lustre. Se questa proprietà non è specificata, viene utilizzata la rete predefinita.

  Per creare un'istanza Managed Lustre in una rete VPC condivisa, è necessario fornire il nome completo della rete. Ad esempio, projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME.

• filesystem: specifica il fsname per l'istanza Managed Lustre. Questo parametro viene utilizzato per il provisioning dinamico. fsname deve essere una stringa alfanumerica di massimo otto caratteri, che inizia con un carattere alfabetico. Se non fornisci un valore, il driver CSI genera un fsname con il formato "lfsNNNNN" (ad esempio, "lfs97603").

  Nota: se prevedi di montare più istanze di Managed Lustre sullo stesso nodo, avrai bisogno di una StorageClass separata per ogni istanza. Ognuna di queste StorageClass deve specificare un valore fsname univoco per evitare conflitti durante il montaggio sullo stesso nodo.

• labels: facoltativo. Managed Lustre supporta le etichette per istanza, come mappa di coppie chiave-valore. Il driver CSI Managed Lustre ti consente di collegare etichette fornite dall'utente all'istanza.

• description: facoltativo. Una descrizione dell'istanza. Deve avere una lunghezza massima di 2048 caratteri.

• perUnitStorageThroughput: specifica il throughput di archiviazione per unità (MB/s/TiB) per l'istanza. I valori supportati sono 125, 250, 500 e 1000. Il valore predefinito è 1000.

• allowTopologies: facoltativo. Le istanze Managed Lustre sono risorse zonali. Se questa proprietà non è specificata, l'istanza Managed Lustre viene creata nella stessa zona del pod del driver del controller CSI e la modalità di binding del volume è impostata su Immediate per impostazione predefinita.

  Se WaitForFirstConsumer è specificato, la topologia viene impostata sulla posizione in cui è pianificato il pod. Tuttavia, questa impostazione può causare il blocco dei pod durante l'attesa del provisioning di un volume.

  Il driver CSI Managed Lustre supporta la funzionalità di topologia per garantire che i volumi permanenti e i pod vengano posizionati nelle topologie consentite, in base alla topologia fornita in StorageClass.

• mountOptions: facoltativo. Specifica le opzioni di montaggio di mount.lustre. I volumi Managed Lustre ereditano queste opzioni di montaggio da StorageClass nel campo pv.spec.mountOptions.

Volume permanente

Il seguente manifest include tutti i campi supportati in 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

Sostituisci i seguenti valori:

• capacity.storage: la capacità dell'istanza Managed Lustre. Consulta la sezione Livelli di prestazioni per le capacità minime e massime delle istanze supportate.
• mountOptions: specifica le opzioni di montaggio di mount.lustre. Questo valore viene ereditato dal campo mountOptions in StorageClass.
• csi.volumeHandle: un identificatore esclusivo per un'istanza Managed Lustre. Deve utilizzare il seguente formato: PROJECT_ID/LOCATION/INSTANCE_NAME.
• csi.volumeAttributes.ip: l'indirizzo IP dell'istanza Managed Lustre, utilizzato per il montaggio.
• csi.volumeAttributes.filesystem: il nome del file system dell'istanza Managed Lustre, che è un identificatore di otto caratteri.