Ottimizza lo spazio di archiviazione con Filestore Multishares per GKE

Questa guida mostra come utilizzare i multishare Filestore per Google Kubernetes Engine con il driver CSI Filestore di GKE.

Prima di iniziare

  1. Prima di iniziare, completa i passaggi di configurazione necessari per utilizzare Filestore.

  2. Abilita il driver CSI Filestore GKE, versione 1.23 o successiva:

    • Le versioni del driver da 1.23 a 1.26 supportano fino a 10 condivisioni per istanza.

    • Le versioni del driver 1.27 o successive supportano fino a 80 condivisioni per istanza.

    Per i requisiti più recenti del driver CSI Filestore di GKE, consulta Accedere alle istanze Filestore con il driver CSI Filestore.

Utilizzare i multishare Filestore con più applicazioni

Questa sezione mostra come eseguire il deployment di due applicazioni, un deployment e un Statefulset, ciascuna che utilizza un StorageClass Filestore con più condivisioni. Vedrai anche come GKE esegue il pacchettizzazione dei pacchetti (un processo per impacchettare in modo efficiente le applicazioni nei nodi GKE) di tutti i volumi nella stessa istanza Filestore Enterprise sottostante.

  1. Utilizza enterprise-multishare-rwx, lo StorageClass fornito da GKE, per creare istanze che supportano fino a 10 condivisioni.

    • Se vuoi creare istanze che supportano fino a 80 condivisioni, dovrai creare un StorageClass personalizzato. Ai fini di questa guida, utilizzerai una classe di archiviazione con un limite di dieci azioni per istanza.

    Dopo aver attivato il driver CSI Filestore di GKE, gli utenti possono accedere allo StorageClass multishare fornito da GKE enterprise-multishare-rwx con la seguente configurazione. Facendo riferimento a questa StorageClass, il driver CSI Filestore di GKE utilizza il provisioning dei volumi dinamico per creare automaticamente volumi permanenti (PV) per nuove richieste di volumi permanenti (PVC) in base alle esigenze del carico di lavoro GKE:

    kubectl describe sc enterprise-multishare-rwx
Name:                  enterprise-multishare-rwx
IsDefaultClass:        No
Annotations:           components.gke.io/component-name=filestorecsi,components.gke.io/component-version=0.7.2,components.gke.io/layer=addon
Provisioner:           filestore.csi.storage.gke.io
Parameters:            instance-storageclass-label=enterprise-multishare-rwx,multishare=true,tier=enterprise
AllowVolumeExpansion:  True
MountOptions:          <none>
ReclaimPolicy:         Delete
VolumeBindingMode:     WaitForFirstConsumer
Events:                <none>

Creare una classe StorageClass personalizzata

Se vuoi sfruttare il limite di capacità più recente di massimo 80 condivisioni per istanza Filestore, crea un StorageClass personalizzato in base al seguente modello:

  apiVersion: storage.k8s.io/v1
  kind: StorageClass
  metadata:
    name: csi-filestore-multishare-128
  provisioner: filestore.csi.storage.gke.io
  parameters:
    tier: enterprise
    multishare: "true"
    max-volume-size: "128Gi"
    network: default
  allowVolumeExpansion: true

Quando rinomini StorageClass, tieni presente i seguenti requisiti:

  • Il nome StorageClass deve essere un nome di sottodominio DNS valido.

  • Il nome della classe di archiviazione multishare viene utilizzato anche come etichetta dell'istanza e deve seguire le linee guida per la denominazione delle etichette.

  • Se la tua applicazione richiede il provisioning immediato del volume, includi la modalità di associazione del volume Immediate:

    volumeBindingMode: Immediate

    Utilizza questa specifica, ad esempio, se non vuoi che il provisioning dei volumi sia dipendente dalla creazione del pod nel cluster GKE.

  • A partire dalla versione 1.27 del driver, se vuoi assegnare più di 10 sparti per istanza, includi il parametro max-volume-size e assegna uno dei valori accettati della prima colonna:

    Dimensione massima del volume (dimensione della condivisione) Numero massimo di azioni per istanza
    128 GiB 80
    256 GiB 40
    512 GiB 20
    1024 GiB 10

    Ad esempio, l'aggiunta della coppia chiave-valore max-volume-size: "128Gi" garantisce che StorageClass mappi fino a 80 condivisioni, ciascuna di dimensioni comprese tra 10 e 128 GB, a una singola istanza di livello Enterprise da 10 TiB.

    • Questa funzionalità è compatibile con le versioni precedenti delle istanze Filestore create dal driver CSI Filestore di GKE 1.23-1.26.

    • Le istanze esistenti possono creare nuovi PVC o nuove quote con la dimensione minima della quota estesa di 10 GB.

    • Il driver CSI Filestore di GKE versione 1.27 o successive riconosce le istanze enterprise precedenti e assegna loro una dimensione massima predefinita della condivisione di 1024 GiB (1 TiB). Di conseguenza, le istanze precedenti sono limitate a un numero massimo di 10 condivisioni per istanza.

    Per ulteriori informazioni, consulta Filestore Multishares per GKE.

  1. Crea un deployment con più repliche di pod utilizzando un'unica PVC.

    Crea un file di configurazione YAML simile al seguente:

    cat <<EOF | kubectl apply -f -

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-server-multishare
  labels:
    app: nginx
spec:
  replicas: 5
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx
        volumeMounts:
        - mountPath: /usr/share/nginx/html
          name: mypvc
      volumes:
      - name: mypvc
        persistentVolumeClaim:
          claimName: test-pvc-fs
---
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: test-pvc-fs
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: enterprise-multishare-rwx
  resources:
    requests:
      storage: 100Gi

EOF

  2. Controlla le repliche del pod.

    a. Dalla riga di comando, esegui il seguente comando per controllare lo stato della PVC:

    kubectl get pvc

    Dovresti visualizzare una risposta simile alla seguente:

    NAME          STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
test-pvc-fs   Bound    pvc-056d769d-a709-4bb2-b6d3-0361871b27a2   100Gi      RWX            enterprise-multishare-rwx  35m

    b. Dalla riga di comando, esegui il seguente comando per controllare lo stato del pod:

    kubectl get pod

    Dovresti visualizzare una risposta simile alla seguente:

    NAME                                     READY   STATUS    RESTARTS   AGE
web-server-multishare-76c9ffb4b5-2dhml   1/1     Running   0          35m
web-server-multishare-76c9ffb4b5-7mtcb   1/1     Running   0          35m
web-server-multishare-76c9ffb4b5-csdbd   1/1     Running   0          35m
web-server-multishare-76c9ffb4b5-rgx82   1/1     Running   0          35m
web-server-multishare-76c9ffb4b5-zjl27   1/1     Running   0          35m

  3. Scala le repliche.

    a. Dalla riga di comando, esegui il seguente comando per modificare il deployment:

    kubectl edit deployment web-server-multishare

    b. Il file si aprirà nella riga di comando. Trova il campo spec.replicas e aggiorna il valore in 10.

    c. Dalla riga di comando, esegui il seguente comando per visualizzare la modifica applicata:

    kubectl get pod

    Dovresti visualizzare una risposta simile alla seguente:

    NAME                                     READY   STATUS    RESTARTS   AGE
web-server-multishare-76c9ffb4b5-2dhml   1/1     Running   0          36m
web-server-multishare-76c9ffb4b5-5ctkf   1/1     Running   0          3s
web-server-multishare-76c9ffb4b5-7mtcb   1/1     Running   0          36m
web-server-multishare-76c9ffb4b5-8dwmw   1/1     Running   0          2s
web-server-multishare-76c9ffb4b5-csdbd   1/1     Running   0          36m
web-server-multishare-76c9ffb4b5-lndcq   1/1     Running   0          2s
web-server-multishare-76c9ffb4b5-rgx82   1/1     Running   0          36m
web-server-multishare-76c9ffb4b5-vtd6p   1/1     Running   0          3s
web-server-multishare-76c9ffb4b5-xm49s   1/1     Running   0          3s
web-server-multishare-76c9ffb4b5-zjl27   1/1     Running   0          36m

    Nota che sono in esecuzione 10 pod.

    d. Dalla riga di comando, esegui il seguente comando:

    kubectl get deployment

    Dovresti visualizzare una risposta simile alla seguente:

    NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
web-server-multishare   10/10   10           10          36m

    e. Dalla riga di comando, esegui il seguente comando per controllare lo stato della PVC associata:

    kubectl get pvc

    Dovresti visualizzare una risposta simile alla seguente:

    NAME          STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
test-pvc-fs   Bound    pvc-056d769d-a709-4bb2-b6d3-0361871b27a2   100Gi      RWX            enterprise-multishare-rwx  37m

    f. Dalla riga di comando, esegui il seguente comando per modificare il deployment:

    kubectl edit deployment web-server-multishare

    g. Il file si aprirà nella riga di comando. Trova il campo spec.replicas e aggiorna il valore in 2.

    h. Dalla riga di comando, esegui il seguente comando per visualizzare la modifica applicata:

    kubectl get pod

    Dovresti visualizzare una risposta simile alla seguente:

    NAME                                     READY   STATUS    RESTARTS   AGE
web-server-multishare-76c9ffb4b5-2dhml   1/1     Running   0          38m
web-server-multishare-76c9ffb4b5-7mtcb   1/1     Running   0          38m

  4. Esegui il deployment di un set stateful.

    Esegui il deployment di una seconda applicazione che condivide l'istanza Filestore di base.

    A tale scopo, esegui il provisioning di 200 GiB di spazio e verifica che utilizzi la stessa istanza Filestore di base della prima applicazione.

    Successivamente, eseguirai il ridimensionamento dell'applicazione a nove repliche utilizzando 900 GiB in totale (9 repliche da 100 GiB ciascuna) e verificherai che GKE utilizzi la stessa istanza Filestore condividendola.

    Crea un file di configurazione YAML simile al seguente:

    cat <<EOF | kubectl apply -f -

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: web
spec:
  serviceName: "nginx"
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: registry.k8s.io/nginx-slim:0.8
        ports:
        - containerPort: 80
          name: web
        volumeMounts:
        - name: test-pvc-multishare
          mountPath: /usr/share/nginx/html
  volumeClaimTemplates:
  - metadata:
      name: test-pvc-multishare
    spec:
      accessModes: [ "ReadWriteMany" ]
      storageClassName: enterprise-multishare-rwx
      resources:
        requests:
          storage: 100Gi

EOF

  5. Controlla le repliche e i volumi di Statefulset.

    Dalla riga di comando, esegui il seguente comando:

    kubectl get pod

    Dovresti visualizzare una risposta simile alla seguente:

    NAME                                     READY   STATUS    RESTARTS   AGE
web-0                                    1/1     Running   0          4m48s
web-1                                    1/1     Running   0          3m32s
web-server-multishare-76c9ffb4b5-2dhml   1/1     Running   0          57m
web-server-multishare-76c9ffb4b5-7mtcb   1/1     Running   0          57m

    Tieni presente che i primi due pod sono associati allo Statefulset. Gli ultimi due pod sono associati al deployment.

    Dalla riga di comando, esegui il seguente comando:

    kubectl get statefulset

    Dovresti visualizzare una risposta simile alla seguente:

    NAME   READY   AGE
web    2/2     2m8s

    Dalla riga di comando, esegui il seguente comando:

    kubectl get pvc

    Dovresti visualizzare una risposta simile alla seguente:

    NAME                        STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
test-pvc-fs                 Bound    pvc-056d769d-a709-4bb2-b6d3-0361871b27a2   100Gi      RWX            enterprise-multishare-rwx   54m
test-pvc-multishare-web-0   Bound    pvc-7aa21b5a-5343-4547-b7d7-414c16af15a7   100Gi      RWX            enterprise-multishare-rwx   114s
test-pvc-multishare-web-1   Bound    pvc-8b37cd6e-d764-4d38-80d7-d74228536cfe   100Gi      RWX            enterprise-multishare-rwx   38s

    Il PVC test-pvc-fs è associato al deployment web-server-multishare.

    I PVC test-pvc-multishare-web-0 e test-pvc-multishare-web-1 sono associati allo Statefulset.

  6. Esegui lo scale delle repliche di StatefulSet.

    Aumenta il conteggio delle repliche a nove. Man mano che il conteggio aumenta, vengono creati i PVC corrispondenti.

    a. Dalla riga di comando, esegui il seguente comando:

    kubectl  edit statefulset web

    b. Il file si aprirà nella riga di comando. Trova il campo spec.replicas e aggiorna il valore in 9.

    c. Dalla riga di comando, esegui il seguente comando per visualizzare la modifica applicata:

    kubectl get statefulset

    Dovresti visualizzare una risposta simile alla seguente:

    NAME   READY   AGE
web    9/9     13m

    d. Dalla riga di comando, esegui il seguente comando:

    kubectl get deployment

    Dovresti visualizzare una risposta simile alla seguente:

    NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
web-server-multishare   2/2     2            2           65m

    e. Dalla riga di comando, esegui il seguente comando:

    kubectl get pvc

    Dovresti visualizzare una risposta simile alla seguente:

    NAME                        STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
test-pvc-fs                 Bound    pvc-056d769d-a709-4bb2-b6d3-0361871b27a2   100Gi      RWX            enterprise-multishare-rwx   65m
test-pvc-multishare-web-0   Bound    pvc-7aa21b5a-5343-4547-b7d7-414c16af15a7   100Gi      RWX            enterprise-multishare-rwx   13m
test-pvc-multishare-web-1   Bound    pvc-8b37cd6e-d764-4d38-80d7-d74228536cfe   100Gi      RWX            enterprise-multishare-rwx   12m
test-pvc-multishare-web-2   Bound    pvc-3fcbd132-939f-4364-807a-7c8ac6a3e64e   100Gi      RWX            enterprise-multishare-rwx   5m12s
test-pvc-multishare-web-3   Bound    pvc-5894afa5-2502-4ee7-9d5c-b7378cb85479   100Gi      RWX            enterprise-multishare-rwx   4m57s
test-pvc-multishare-web-4   Bound    pvc-ebbe452b-bc8f-4624-a830-a2094cce0d67   100Gi      RWX            enterprise-multishare-rwx   4m36s
test-pvc-multishare-web-5   Bound    pvc-5a73a698-d174-44cb-a3a1-e767966c3417   100Gi      RWX            enterprise-multishare-rwx   4m20s
test-pvc-multishare-web-6   Bound    pvc-102da6a9-2ca6-4f9e-9896-8fe14709db7a   100Gi      RWX            enterprise-multishare-rwx   3m55s
test-pvc-multishare-web-7   Bound    pvc-160e81cd-c5bf-4ae6-966e-518e8249e02d   100Gi      RWX            enterprise-multishare-rwx   3m38s
test-pvc-multishare-web-8   Bound    pvc-9b52d773-2e9a-40de-881c-dc06945ba3d7   100Gi      RWX            enterprise-multishare-rwx   118s

  7. Verifica lo stato dell'istanza Filestore.

    Ora hai un deployment con due pod di replica, uno Statefulset con nove pod di replica e un totale di 10 PVC, ciascuno di 100 GiB di dimensione. Tutti i volumi vengono impacchettati in un'unica istanza multishare Filestore.

    a. Dalla riga di comando, esegui il seguente comando instances list:

    gcloud beta filestore instances list --project=YOUR_PROJECT_ID --region=REGION

    dove:

    • YOUR_PROJECT_ID è il nome del progetto in uso. Ad esempio: my-project.

    • REGION è il nome della regione in uso. Ad esempio: us-central1.

    Dovresti visualizzare una risposta simile alla seguente:

    INSTANCE_NAME                            LOCATION     TIER        CAPACITY_GB  FILE_SHARE_NAME  IP_ADDRESS   STATE  CREATE_TIME
fs-a767cef8-738e-4c8e-b70b-09cbb872d016  us-central1  ENTERPRISE  1024         N/A              10.192.53.2  READY  2022-06-21T21:15:30

    b. Dalla riga di comando, esegui il seguente comando instances describe:

    gcloud filestore instances describe fs-a767cef8-738e-4c8e-b70b-09cbb872d016 --project=YOUR_PROJECT_ID --region=REGION
capacityGb: '1024'
capacityStepSizeGb: '256'
createTime: '2022-06-21T21:15:30.464237089Z'
labels:
  storage_gke_io_created-by: filestore_csi_storage_gke_io
  storage_gke_io_storage-class-id: enterprise-multishare-rwx
maxCapacityGb: '10240'
maxShareCount: '10'
multiShareEnabled: true
name: projects/YOUR_PROJECT_ID/locations/REGION/instances/fs-a767cef8-738e-4c8e-b70b-09cbb872d016
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.192.53.2
  modes:
  - MODE_IPV4
  network: csi-filestore-test-network
  reservedIpRange: 10.192.53.0/26
state: READY
tier: ENTERPRISE

    dove:

    • YOUR_PROJECT_ID è il nome del progetto in uso. Ad esempio: my-project.

    • REGION è il nome della regione in uso. Ad esempio: us-central1.

Espandi un PVC e verifica l'istanza Filestore

Questa sezione mostra come espandere un PVC esistente e verificare le dimensioni dell'istanza Filestore.

  1. Espandi un PVC.

    I PVC, supportati dalle condivisioni in un'istanza Filestore a condivisione multipla, possono crescere fino alla dimensione massima specificata nel parametro max-volume-size. Per verificare, espandi uno dei volumi associati allo stato set mentre il pod lo utilizza.

    Dalla riga di comando, esegui il seguente comando per controllare la dimensione corrente della PVC della replica 0:

    kubectl get pvc test-pvc-multishare-web-0 -o json
{
    "apiVersion": "v1",
    "kind": "PersistentVolumeClaim",
    "metadata": {
        "annotations": {
            "pv.kubernetes.io/bind-completed": "yes",
            "pv.kubernetes.io/bound-by-controller": "yes",
            "volume.beta.kubernetes.io/storage-provisioner": "filestore.csi.storage.gke.io",
            "volume.kubernetes.io/storage-provisioner": "filestore.csi.storage.gke.io"
        },
        "creationTimestamp": "2022-06-21T22:07:42Z",
        "finalizers": [
            "kubernetes.io/pvc-protection"
        ],
        "labels": {
            "app": "nginx"
        },
        "name": "test-pvc-multishare-web-0",
        "namespace": "default",
        "resourceVersion": "48395",
        "uid": "7aa21b5a-5343-4547-b7d7-414c16af15a7"
    },
    "spec": {
        "accessModes": [
            "ReadWriteMany"
        ],
        "resources": {
            "requests": {
                "storage": "100Gi"
            }
        },
        "storageClassName": "enterprise-multishare-rwx",
        "volumeMode": "Filesystem",
        "volumeName": "pvc-7aa21b5a-5343-4547-b7d7-414c16af15a7"
    },
    "status": {
        "accessModes": [
            "ReadWriteMany"
        ],
        "capacity": {
            "storage": "100Gi"
        },
        "phase": "Bound"
    }
}

  2. Dalla riga di comando, esegui il seguente comando per aumentare le dimensioni a 500 GB:

    kubectl edit pvc test-pvc-multishare-web-0

  3. Il file si aprirà nella riga di comando. Trova il campo spec.resources.requests.storage e aggiorna il valore in 500Gi.

  4. Dalla riga di comando, esegui il seguente comando per visualizzare la modifica applicata:

    kubectl get pvc test-pvc-multishare-web-0

    Dovresti visualizzare una risposta simile alla seguente:

    NAME                        STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
test-pvc-multishare-web-0   Bound    pvc-7aa21b5a-5343-4547-b7d7-414c16af15a7   500Gi      RWX            enterprise-multishare-rwx   28m

    Il driver CSI Filestore ha accettato la richiesta, espandendo prima l'istanza Filestore sottostante e poi la condivisione di supporto del PVC.

    Nello specifico, il driver CSI Filestore ha ampliato automaticamente l'istanza a 1536 Gi per supportare la nuova dimensione della condivisione di 500 Gi.

  5. Dalla riga di comando, esegui il seguente comando instances describe per verificare la capacità dell'istanza Filestore:

    gcloud filestore instances describe fs-a767cef8-738e-4c8e-b70b-09cbb872d016 --project=YOUR_PROJECT_ID --region=REGION
capacityGb: '1536'
capacityStepSizeGb: '256'
createTime: '2022-06-21T21:15:30.464237089Z'
labels:
  storage_gke_io_created-by: filestore_csi_storage_gke_io
  storage_gke_io_storage-class-id: enterprise-multishare-rwx
maxCapacityGb: '10240'
maxShareCount: '10'
multiShareEnabled: true
name: projects/YOUR_PROJECT_ID/locations/us-central1/instances/fs-a767cef8-738e-4c8e-b70b-09cbb872d016
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.192.53.2
  modes:
  - MODE_IPV4
  network: csi-filestore-test-network
  reservedIpRange: 10.192.53.0/26
state: READY
tier: ENTERPRISE

    dove:

    • YOUR_PROJECT_ID è il nome del progetto in uso. Ad esempio: my-project.

    • REGION è il nome della regione in uso. Ad esempio: us-central1.

Provisioning dinamico in una VPC condiviso

Il driver CSI Filestore per GKE supporta il provisioning dinamico dei volumi in un progetto di servizio in un VPC condiviso. La sezione seguente mostra come utilizzare il driver CSI Filestore per eseguire il provisioning dinamico dei volumi sulle istanze multishare Filestore in un progetto di servizio in una rete VPC condiviso.

  1. Completa i passaggi di configurazione per una rete VPC condiviso e l'accesso ai servizi privati.

  2. Crea una classe di archiviazione per eseguire il provisioning dinamico dei volumi supportati da un'istanza Filestore multishare su una VPC condiviso.

    Esegui il comando seguente per eseguire il deployment di una risorsa StorageClass:

    cat <<EOF | kubectl apply -f -

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: csi-filestore-multishare-sharedvpc
provisioner: filestore.csi.storage.gke.io
parameters:
  network: "projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME"
  connect-mode: PRIVATE_SERVICE_ACCESS
  tier: enterprise
  multishare: "true"
allowVolumeExpansion: true

EOF

    dove:

    • HOST_PROJECT_ID è l'ID o il nome del progetto host della rete VPC condiviso. Ad esempio: my-host-project.

    • SHARED_VPC_NAME il nome della rete VPC condivisa. Ad esempio: my-shared-vpc.

    Se vuoi eseguire il deployment della risorsa in un intervallo di indirizzi IP riservati, aggiungi la seguente riga ai parametri utilizzati nel comando:

    reserved-ip-range: RESERVED_NAME

    dove RESERVED_NAME è il nome dell'intervallo di indirizzi IP riservati all'interno del quale è possibile eseguire il provisioning di un'istanza Filestore. Ad esempio, filestore-reserved-ip-range. Se viene specificato un intervallo IP riservato, deve essere un intervallo di indirizzi denominato anziché un valore CIDR diretto.

    Per ulteriori informazioni, consulta Allocare intervalli di indirizzi IP o Configurare un intervallo di indirizzi IP riservato. Per un esempio di come creare un nome riservato utilizzando la console Google Cloud, consulta Creare un'allocazione IP.

  3. Crea un deployment.

    Esegui il comando seguente per creare una risorsa Deployment:

    cat <<EOF | kubectl apply -f -

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-server-multishare
  labels:
    app: nginx
spec:
  replicas: 5
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx
        volumeMounts:
        - mountPath: /usr/share/nginx/html
          name: mypvc
      volumes:
      - name: mypvc
        persistentVolumeClaim:
          claimName: test-pvc-fs-sharedvpc
---
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: test-pvc-fs-sharedvpc
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: csi-filestore-multishare-sharedvpc
  resources:
    requests:
      storage: 100Gi

EOF

Istanze Filestore abilitate per CMEK

Puoi creare volumi GKE ospitati su istanze multishare Filestore con CMEK abilitato. In questa sezione scoprirai come configurare una chiave di crittografia gestita dal cliente (CMEK) per la tua istanza Filestore.

I dettagli delle chiavi gestite dal cliente possono essere forniti in StorageClass. Per qualsiasi istanza creata dinamicamente dal driver CSI Filestore, che fa riferimento a questa StorageClass, verrà attivato CMEK.

  1. Crea una classe di archiviazione con CMEK abilitato.

    a. Esegui questo comando:

    cat <<EOF | kubectl apply -f -

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: csi-filestore-multishare-cmek
provisioner: filestore.csi.storage.gke.io
parameters:
  tier: enterprise
  multishare: "true"
  instance-encryption-kms-key: projects/KEY_PROJECT_ID/locations/REGION/keyRings/RING_NAME/cryptoKeys/KEY_NAME

allowVolumeExpansion: true

EOF

    dove:

    • KEY_PROJECT_ID è il nome del progetto in cui si trova la chiave. Ad esempio: my-key-project.

    • REGION è il nome della regione in uso. Ad esempio: us-central1.

    • RING_NAME il nome del keyring. Ad esempio, my-key-ring-name.

    • KEY_NAME il nome della chiave. Ad esempio, my-key-name.

  2. Crea un deployment.

    b. Esegui il comando seguente per creare una risorsa Deployment:

    cat <<EOF | kubectl apply -f -

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-server-multishare
  labels:
    app: nginx
spec:
  replicas: 5
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx
        volumeMounts:
        - mountPath: /usr/share/nginx/html
          name: mypvc
      volumes:
      - name: mypvc
        persistentVolumeClaim:
          claimName: test-pvc-fs-cmek
---
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: test-pvc-fs-cmek
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: csi-filestore-multishare-cmek
  resources:
    requests:
      storage: 100Gi

EOF

Mappa i PVC alle istanze Filestore

In questa sezione scoprirai come mappare i PVC alle istanze Filestore.

Con le istanze multishare Filestore, ogni PVC è ospitato su un'istanza Filestore dal driver CSI Filestore. I dettagli dell'istanza Filestore sottostante che ospita il volume e la condivisione che rappresenta il volume Kubernetes vengono acquisiti nel campo volumeHandle della specifica dei volumi permanenti. Il formato dell'handle del volume è il seguente:

modeMultishare/<storageclass-prefix>/<project>/<region>/<filestore-instance-name>/<filestore-share-name>

Il seguente comando kubectl può essere utilizzato per determinare rapidamente le mappature tra un PVC, un PV, un'istanza Filestore e una condivisione Filestore.

Dalla riga di comando, esegui il seguente comando:

kubectl get pv -o jsonpath='{range .items[*]}{"pv="}{.metadata.name}{",pvc="}{.spec.claimRef.name}{",volumeHandle="}{.spec.csi.volumeHandle}{"\n"}{end}'

Dovresti visualizzare una risposta simile alla seguente:

pv=pvc-67ad9abd-f25e-4130-b7ca-64d28bd29525,pvc=test-pvc-multishare,volumeHandle=modeMultishare/csi-filestore-multishare-sharedvpc/YOUR_PROJECT_ID/us-central1/fs-2109f680-3f04-4ada-b4bc-2a1c7fc47b88/pvc_67ad9abd_f25e_4130_b7ca_64d28bd29525

pv=pvc-c80f4de0-9916-4957-b8ae-b21206650ac0,pvc=test-pvc-fs-sharedvpc,volumeHandle=modeMultishare/csi-filestore-multishare-sharedvpc/YOUR_PROJECT_ID/us-central1/fs-2109f680-3f04-4ada-b4bc-2a1c7fc47b88/pvc_c80f4de0_9916_4957_b8ae_b21206650ac0

dove:

  • YOUR_PROJECT_ID è il nome del progetto in uso. Ad esempio: my-project.

Tieni presente che due volumi permanenti nel cluster sono ospitati su una singola istanza Filestore.

Passaggi successivi