Installazione di un driver Container Storage Interface

Questa pagina spiega come installare un driver di archiviazione Container Storage Interface (CSI) nei cluster Google Distributed Cloud.

Panoramica

CSI è un'API standard aperta che consente a Kubernetes di esporre sistemi di archiviazione arbitrari ai carichi di lavoro containerizzati. Quando esegui il deployment di un driver di archiviazione compatibile con CSI in un cluster GKE su VMware, il cluster può connettersi direttamente a un dispositivo di archiviazione compatibile senza dover utilizzare l'archiviazione vSphere.

I volumi Kubernetes sono gestiti da driver di archiviazione specifici del fornitore, che storicamente sono stati compilati nei programmi binari di Kubernetes. In precedenza, non era possibile utilizzare un driver di archiviazione non incluso in Kubernetes. L'installazione di un driver CSI aggiunge il supporto per un sistema di archiviazione non supportato in modo nativo da Kubernetes. Inoltre, CSI consente di usare funzionalità di archiviazione moderne, come snapshot e ridimensionamento.

Per utilizzare un driver CSI, devi creare un oggetto StorageClass di Kubernetes. Imposta il driver CSI come provisioner per StorageClass. Quindi, puoi impostare StorageClass come predefinito del cluster o configurare i tuoi carichi di lavoro per l'utilizzo di StorageClass (esempio StatefulSet).

Prima di iniziare

Per impostazione predefinita, GKE su VMware utilizza i datastore vSphere tramite il driver vsphereVolume integrato. Inoltre, i driver integrati per NFS e iSCSI possono collegare e montare i volumi esistenti sui tuoi carichi di lavoro.

Installazione del driver CSI di un fornitore

I fornitori di servizi di archiviazione sviluppano i propri driver CSI, a cui sono responsabili di fornire istruzioni di installazione. In casi semplici, l'installazione potrebbe riguardare solo il deployment di manifest nei tuoi cluster. Consulta l'elenco dei driver CSI nella documentazione CSI.

Verifica dell'installazione di un driver

Dopo aver installato un driver CSI, puoi verificare l'installazione eseguendo questo comando:

kubectl get csidrivers --kubeconfig KUBECONFIG

Utilizzo di un driver CSI

Per utilizzare un driver CSI:

  1. Crea un oggetto StorageClass di Kubernetes che fa riferimento al driver nel suo campo provisioner.

  2. Per eseguire il provisioning dello spazio di archiviazione, puoi:

Considerazioni sulle classi di archiviazione supportate da un driver CSI

Quando crei un oggetto StorageClass, considera quanto segue:

  • La documentazione del driver CSI deve includere i parametri specifici del driver forniti a StorageClass, incluso il nome del provisioner.
  • Devi assegnare un nome all'oggetto StorageClass in base alle relative proprietà, anziché in base al nome dell'appliance o del driver specifico. L'assegnazione di un nome a StorageClass in base alle sue proprietà consente di creare StorageClass con lo stesso nome in più cluster e ambienti e consente alle applicazioni di ottenere spazio di archiviazione con le stesse proprietà in tutti i cluster.

Esempio: fare riferimento a StorageClass in un StatefulSet

L'esempio seguente modella come definire un driver CSI in un oggetto StorageClass per poi fare riferimento a StorageClass in un carico di lavoro StatefulSet. L'esempio presuppone che il driver sia già stato installato nel cluster.

Di seguito è riportato un semplice oggetto StorageClass denominato premium-rwo che utilizza un driver CSI fittizio, csi.example.com, come provisioner:

fast-sc.yaml

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: premium-rwo
provisioner: csi.example.com # CSI driver
parameters: # You provide vendor-specific parameters to this specification
  type: example-parameter # Be sure to follow the vendor's instructions
  datastore: my-datastore
reclaimPolicy: Retain
allowVolumeExpansion: true

Fai riferimento all'oggetto StorageClass nella specifica volumeClaimTemplates di uno StatefulSet.

Quando fai riferimento a un oggetto StorageClass nella specifica volumeClaimTemplates di uno StatefulSet, Kubernetes fornisce uno spazio di archiviazione stabile tramite oggetti PersistentVolume (PV). Kubernetes chiama il provisioner definito in StorageClass per creare un nuovo volume di archiviazione. In questo caso, Kubernetes chiama il provider csi.example.com fittizio, che effettua una chiamata all'API del provider, per creare un volume. Dopo aver eseguito il provisioning del volume, Kubernetes crea automaticamente un volume permanente per rappresentare l'archiviazione.

Ecco un semplice StatefulSet che fa riferimento a StorageClass:

statefulset.yaml

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: web
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: registry.k8s.io/nginx-slim:0.8
        volumeMounts:
        - name: www
          mountPath: /usr/share/nginx/html
  volumeClaimTemplates: # This is the specification in which you reference the StorageClass
  - metadata:
      name: www
    spec:
      accessModes: [ "ReadWriteOnce" ]
      resources:
        requests:
          storage: 1Gi
      storageClassName: fast # This field references the existing StorageClass

Passaggi successivi