Scalare le prestazioni di archiviazione con Hyperdisk

Il driver CSI per Persistent Disk di Compute Engine è il modo principale per accedere allo spazio di archiviazione di Hyperdisk con i cluster Google Kubernetes Engine (GKE).

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti attività:

  • Abilita l'API Google Kubernetes Engine.
  • Abilita l'API Google Kubernetes Engine
  • Per utilizzare Google Cloud CLI per questa attività, installala e poi inizializza gcloud CLI. Se hai già installato gcloud CLI, scarica l'ultima versione eseguendo il comando gcloud components update. Le versioni precedenti di gcloud CLI potrebbero non supportare l'esecuzione dei comandi in questo documento.

Requisiti

Per utilizzare i volumi Hyperdisk in GKE, i cluster devono soddisfare i seguenti requisiti:

  • Utilizza cluster Linux che eseguono GKE versione 1.26 o successive. Se utilizzi un canale di rilascio, assicurati che il canale abbia la versione minima di GKE o una versione successiva richiesta per questo driver. Il provisioning dei volumi Hyperdisk Balanced High Availability richiede GKE versione 1.33 o successive.
  • Assicurati che il driver CSI per Compute Engine Persistent Disk sia abilitato. Il driver Persistent Disk di Compute Engine è abilitato per impostazione predefinita nei nuovi cluster Autopilot e Standard e non può essere disabilitato o modificato quando utilizzi Autopilot. Se devi abilitare il driver CSI per il disco permanente di Compute Engine dal tuo cluster, consulta Abilitazione del driver CSI per il disco permanente di Compute Engine su un cluster esistente.

Crea un volume Hyperdisk per GKE

Questa sezione fornisce una panoramica della creazione di un volume Hyperdisk supportato dal driver CSI di Compute Engine in GKE.

Crea una classe StorageClass

I seguenti campi di archiviazione su Persistent Disk Type sono forniti dal driver CSI di Compute Engine Persistent Disk per supportare Hyperdisk:

  • hyperdisk-balanced
  • hyperdisk-throughput
  • hyperdisk-extreme
  • hyperdisk-ml
  • hyperdisk-balanced-high-availability

Per creare un nuovo StorageClass con il livello di throughput o IOPS che preferisci, utilizza pd.csi.storage.gke.io nel campo Provisioner e specifica uno dei tipi di archiviazione Hyperdisk.

Ogni tipo di Hyperdisk ha valori predefiniti per le prestazioni determinati dalle dimensioni iniziali del disco di cui è stato eseguito il provisioning. Quando crei la classe StorageClass, puoi facoltativamente specificare i seguenti parametri a seconda del tipo di Hyperdisk. Se ometti questi parametri, GKE utilizza i valori predefiniti del tipo di disco in base alla capacità. Per indicazioni sui valori consentiti per il throughput o le IOPS, consulta Pianifica il livello di prestazioni per il volume Hyperdisk.

Parametro Tipo di Hyperdisk Utilizzo
provisioned-throughput-on-create Hyperdisk Balanced*, Hyperdisk Balanced High Availability, Hyperdisk Throughput Esprimi il valore del throughput in MiB/s utilizzando il qualificatore "Mi". Ad esempio, se il throughput richiesto è 250 MiB/s, specifica "250Mi" durante la creazione di StorageClass.
provisioned-iops-on-create Hyperdisk Balanced, Hyperdisk Balanced High Availability, Hyperdisk Extreme Il valore delle IOPS deve essere espresso senza qualificatori. Ad esempio, se hai bisogno di 7000 IOPS, specifica "7000" durante la creazione della StorageClass.
* Se hai bisogno di una maggiore sicurezza e prevedi di utilizzare i nodi Confidential Google Kubernetes Engine, valuta la possibilità di creare la modalità riservata per Hyperdisk bilanciato, esamina le limitazioni aggiuntive della modalità riservata per Hyperdisk bilanciato e scopri di più sui nodi Confidential Google Kubernetes Engine.

Gli esempi seguenti mostrano come creare un oggetto StorageClass per ogni tipo di Hyperdisk:

Hyperdisk bilanciato

  1. Salva il seguente manifest in un file denominato hdb-example-class.yaml:

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: balanced-storage
    provisioner: pd.csi.storage.gke.io
    volumeBindingMode: WaitForFirstConsumer
    allowVolumeExpansion: true
    parameters:
      type: hyperdisk-balanced
      provisioned-throughput-on-create: "250Mi"
      provisioned-iops-on-create: "7000"
    
  2. Crea la classe di archiviazione:

    kubectl create -f hdb-example-class.yaml
    

Hyperdisk Throughput

  1. Salva il seguente manifest in un file denominato hdt-example-class.yaml:

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: throughput-storage
    provisioner: pd.csi.storage.gke.io
    volumeBindingMode: WaitForFirstConsumer
    allowVolumeExpansion: true
    parameters:
      type: hyperdisk-throughput
      provisioned-throughput-on-create: "50Mi"
    
  2. Crea la classe di archiviazione:

    kubectl create -f hdt-example-class.yaml
    

Hyperdisk Extreme

  1. Salva il seguente manifest in un file denominato hdx-example-class.yaml:

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: extreme-storage
    provisioner: pd.csi.storage.gke.io
    volumeBindingMode: WaitForFirstConsumer
    allowVolumeExpansion: true
    parameters:
      type: hyperdisk-extreme
      provisioned-iops-on-create: "50000"
    
  2. Crea la classe di archiviazione:

    kubectl create -f hdx-example-class.yaml
    

Hyperdisk bilanciato ad alta affidabilità

  1. Salva il seguente manifest in un file denominato hdb-ha-example-class.yaml.

    • Per i cluster di zona, imposta le zone di disponibilità in cui vuoi creare i PersistentVolume.

    • Per i cluster a livello di regione, puoi scegliere di non impostare il campo allowedTopologies per creare i PersistentVolume in due zone di disponibilità selezionate in modo casuale al momento della pianificazione dei pod.

    Per ulteriori informazioni sulle zone supportate, consulta la disponibilità a livello di regione di Hyperdisk.

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: balanced-ha-storage
    provisioner: pd.csi.storage.gke.io
    volumeBindingMode: WaitForFirstConsumer
    allowVolumeExpansion: true
    parameters:
      type: hyperdisk-balanced-high-availability
      provisioned-throughput-on-create: "250Mi"
      provisioned-iops-on-create: "7000"
    allowedTopologies:
    - matchLabelExpressions:
      - key: topology.gke.io/zone
        values:
        - ZONE1
        - ZONE2
    
  2. Crea la classe di archiviazione:

    kubectl create -f hdb-ha-example-class.yaml
    

Per trovare il nome delle StorageClass disponibili nel tuo cluster, esegui questo comando:

kubectl get sc

Crea un PersistentVolumeClaim

Puoi creare un PersistentVolumeClaim che fa riferimento alla StorageClass del driver CSI per Compute Engine Persistent Disk.

Hyperdisk bilanciato

In questo esempio, specifichi la capacità di archiviazione target del volume Hyperdisk bilanciato come 20 GiB.

  1. Salva il seguente manifest PersistentVolumeClaim in un file denominato pvc-example.yaml:

    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: podpvc
    spec:
      accessModes:
      - ReadWriteOnce
      storageClassName: balanced-storage
      resources:
        requests:
          storage: 20Gi
    
  2. Applica l'oggetto PersistentVolumeClaim che fa riferimento alla classe di archiviazione che hai creato nell'esempio precedente:

    kubectl apply -f pvc-example.yaml
    

Hyperdisk Throughput

In questo esempio, specifichi la capacità di archiviazione target del volume Hyperdisk Throughput come 2 TiB.

  1. Salva il seguente manifest PersistentVolumeClaim in un file denominato pvc-example.yaml:

    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: podpvc
    spec:
      accessModes:
      - ReadWriteOnce
      storageClassName: throughput-storage
      resources:
        requests:
          storage: 2Ti
    
  2. Applica l'oggetto PersistentVolumeClaim che fa riferimento alla classe di archiviazione che hai creato nell'esempio precedente:

    kubectl apply -f pvc-example.yaml
    

Hyperdisk Extreme

In questo esempio, specifichi la capacità di archiviazione minima del volume Hyperdisk Extreme, ovvero 64 GiB.

  1. Salva il seguente manifest PersistentVolumeClaim in un file denominato pvc-example.yaml:

    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: podpvc
    spec:
      accessModes:
      - ReadWriteOnce
      storageClassName: extreme-storage
      resources:
        requests:
          storage: 64Gi
    
  2. Applica l'oggetto PersistentVolumeClaim che fa riferimento alla classe di archiviazione che hai creato nell'esempio precedente:

    kubectl apply -f pvc-example.yaml
    

Hyperdisk bilanciato ad alta affidabilità

In questo esempio, specifichi la capacità di archiviazione minima del volume Hyperdisk Balanced ad alta affidabilità come 20 GiB e la modalità di accesso come ReadWriteOnce. Hyperdisk Balanced High Availability supporta anche le modalità di accesso ReadWriteMany e ReadWriteOncePod. Per le differenze e i casi d'uso di ciascuna modalità di accesso, consulta Modalità di accesso ai volumi permanenti.

Se utilizzi la modalità di accesso ReadWriteMany, devi impostare anche la coppia campo-valore volumeMode: Block nel PersistentVolumeClaim. Con questa impostazione, il volume viene esposto come dispositivo a blocchi non elaborati anziché come file system condiviso e l'applicazione deve gestire la propria coerenza dei dati. Per un esempio, consulta Provisioning di Persistent Disk a livello di regione e di volumi Hyperdisk Balanced High Availability.

  1. Salva il seguente manifest PersistentVolumeClaim in un file denominato pvc-example.yaml:

    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: podpvc
    spec:
      accessModes:
      - ReadWriteOnce
      storageClassName: balanced-ha-storage
      resources:
        requests:
          storage: 20Gi
    
  2. Applica l'oggetto PersistentVolumeClaim che fa riferimento alla classe di archiviazione che hai creato nell'esempio precedente:

    kubectl apply -f pvc-example.yaml
    

Crea un deployment per utilizzare il volume Hyperdisk

Quando utilizzi i pod con PersistentVolume, ti consigliamo di utilizzare un controller del workload (come un deployment o un StatefulSet).

  1. L'esempio seguente crea un manifest che configura un pod per il deployment di un server web Nginx utilizzando l'oggetto PersistentVolumeClaim creato nella sezione precedente. Salva il seguente manifest di esempio come hyperdisk-example-deployment.yaml:

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: web-server-deployment
      labels:
        app: nginx
    spec:
      replicas: 1
      selector:
        matchLabels:
          app: nginx
      template:
        metadata:
          labels:
            app: nginx
        spec:
          containers:
          - name: nginx
            image: nginx
            volumeMounts:
            - mountPath: /var/lib/www/html
              name: mypvc
          volumes:
          - name: mypvc
            persistentVolumeClaim:
              # Reference the PVC created earlier.
              claimName: podpvc
              readOnly: false
    
  2. Per creare un deployment basato sul file manifest hyperdisk-example-deployment.yaml, esegui questo comando:

    kubectl apply -f hyperdisk-example-deployment.yaml
    
  3. Verifica che il deployment sia stato creato correttamente:

    kubectl get deployment
    

    Il completamento del provisioning delle istanze Hyperdisk potrebbe richiedere alcuni minuti. Al termine del provisioning, il deployment segnala lo stato READY.

  4. Puoi controllare l'avanzamento monitorando lo stato del PersistentVolumeClaim eseguendo questo comando:

    kubectl get pvc
    

Esegui il provisioning di un volume Hyperdisk da uno snapshot

Per creare un nuovo volume Hyperdisk da uno snapshot di Persistent Disk esistente, utilizza la console Google Cloud , Google Cloud CLI o l'API Compute Engine. Per scoprire come creare uno snapshot di un Persistent Disk, consulta Creazione e utilizzo di snapshot dei volumi.

Console

  1. Nella console Google Cloud , vai alla pagina Dischi.

    Vai a Dischi

  2. Fai clic su Crea disco.

  3. In Tipo di disco, scegli una delle seguenti opzioni per il tipo di disco:

    • Hyperdisk bilanciato
    • Hyperdisk Extreme
    • Hyperdisk Throughput
    • Hyperdisk ad alta affidabilità
  4. In Tipo di disco di origine, fai clic su Snapshot.

  5. Seleziona il nome dello snapshot da ripristinare.

  6. Seleziona le dimensioni del nuovo disco in GiB. Questo numero deve essere uguale o maggiore del disco di origine iniziale per lo snapshot.

  7. Imposta il throughput riservato o le IOPS riservate che vuoi per il disco, se diversi dai valori predefiniti.

  8. Fai clic su Crea per creare il volume Hyperdisk.

gcloud

Esegui il comando gcloud compute disks create per creare il volume Hyperdisk da uno snapshot.

Hyperdisk bilanciato

gcloud compute disks create DISK_NAME \
    --size=SIZE \
    --source-snapshot=SNAPSHOT_NAME \
    --provisioned-throughput=TRHROUGHPUT_LIMIT \
    --provisioned-iops=IOPS_LIMIT \
    --type=hyperdisk-balanced

Sostituisci quanto segue:

  • DISK_NAME: il nome del nuovo disco.
  • SIZE: le dimensioni, in gibibyte (GiB) o tebibyte (TiB), del nuovo disco. Per saperne di più sulle limitazioni di capacità, consulta Limiti di dimensioni e prestazioni.
  • SNAPSHOT_NAME: il nome dello snapshot da ripristinare.
  • THROUGHPUT_LIMIT: (Facoltativo) Per i dischi Hyperdisk bilanciato, si tratta di un numero intero che rappresenta il throughput, misurato in MiB/s, che il disco può raggiungere. Per saperne di più sulle limitazioni di capacità, consulta Limiti di dimensioni e prestazioni.
  • IOPS_LIMIT: (Facoltativo) Per i dischi Hyperdisk Balanced, questo è il numero massimo di IOPS che il disco può raggiungere. Per saperne di più sulle limitazioni di capacità, consulta Limiti di dimensioni e prestazioni.

Hyperdisk Throughput

gcloud compute disks create DISK_NAME \
    --size=SIZE \
    --source-snapshot=SNAPSHOT_NAME \
    --provisioned-throughput=TRHROUGHPUT_LIMIT \
    --type=hyperdisk-throughput

Sostituisci quanto segue:

  • DISK_NAME: il nome del nuovo disco.
  • SIZE: le dimensioni, in gibibyte (GiB o GB) o tebibyte (TiB o TB), del nuovo disco. Per saperne di più sulle limitazioni di capacità, consulta Limiti di dimensioni e prestazioni.
  • SNAPSHOT_NAME: il nome dello snapshot da ripristinare.
  • THROUGHPUT_LIMIT: (facoltativo) per i dischi Hyperdisk Throughput, si tratta di un numero intero che rappresenta il throughput (misurato in MiB/s) che il disco può raggiungere. Per saperne di più sulle limitazioni di capacità, consulta Limiti di dimensioni e prestazioni.

Hyperdisk Extreme

gcloud compute disks create DISK_NAME \
    --size=SIZE \
    --source-snapshot=SNAPSHOT_NAME \
    --provisioned-iops=IOPS_LIMIT \
    --type=hyperdisk-extreme

Sostituisci quanto segue:

  • DISK_NAME: il nome del nuovo disco.
  • SIZE: le dimensioni, in gibibyte (GiB o GB) o tebibyte (TiB o TB), del nuovo disco. Per saperne di più sulle limitazioni di capacità, consulta Limiti di dimensioni e prestazioni.
  • SNAPSHOT_NAME: il nome dello snapshot da ripristinare.
  • IOPS_LIMIT: (facoltativo) per i dischi Hyperdisk Extreme, si tratta del numero massimo di operazioni di I/O al secondo che il disco può raggiungere. Per saperne di più sulle limitazioni di capacità, consulta Limiti di dimensioni e prestazioni.

Hyperdisk bilanciato ad alta affidabilità

gcloud compute disks create DISK_NAME \
    --size=SIZE \
    --region=REGION \
    --replica-zones=('ZONE1', 'ZONE2') \
    --source-snapshot=SNAPSHOT_NAME \
    --provisioned-throughput=TRHROUGHPUT_LIMIT \
    --provisioned-iops=IOPS_LIMIT \
    --type=hyperdisk-balanced-high-availability

Sostituisci quanto segue:

  • DISK_NAME: il nome del nuovo disco.
  • SIZE: le dimensioni, in gibibyte (GiB) o tebibyte (TiB), del nuovo disco. Consulta la documentazione di Compute Engine per le limitazioni di capacità più recenti.
  • REGION: la regione del nuovo disco. Consulta la documentazione di Compute Engine per conoscere la disponibilità regionale più recente.
  • ZONE1, ZONE2: le zone all'interno della regione in cui si troveranno le repliche.
  • SNAPSHOT_NAME: il nome dello snapshot da ripristinare.
  • THROUGHPUT_LIMIT: (Facoltativo) Per i dischi Hyperdisk Balanced High Availability, si tratta di un numero intero che rappresenta il throughput, misurato in MiB/s, che il disco può raggiungere. Per saperne di più sui limiti di capacità, consulta Limiti di dimensioni e prestazioni
  • IOPS_LIMIT: (Facoltativo) Per i dischi Hyperdisk Balanced High Availability, questo è il numero massimo di IOPS che il disco può raggiungere. Per saperne di più sulle limitazioni di capacità, consulta Limiti di dimensioni e prestazioni.

Crea uno snapshot per un volume Hyperdisk

Per creare uno snapshot da un volume Hyperdisk, segui gli stessi passaggi della creazione di uno snapshot per un volume Persistent Disk:

Aggiorna il throughput o le IOPS riservati di un volume Hyperdisk esistente

Questa sezione spiega come modificare le prestazioni di cui è stato eseguito il provisioning per i volumi Hyperdisk.

Throughput

L'aggiornamento del throughput riservato è supportato solo per i volumi Hyperdisk Balanced, Hyperdisk Balanced High Availability e Hyperdisk Throughput.

Per aggiornare il livello di throughput riservato del volume Hyperdisk, segui le istruzioni della console Google Cloud , di gcloud CLI o dell'API Compute Engine riportate in Modifica le prestazioni di cui è stato eseguito il provisioning per un volume Hyperdisk.

Puoi modificare il livello di throughput riservato (fino a una volta ogni 4 ore) per un volume Hyperdisk dopo la creazione del volume. L'applicazione dei nuovi livelli di throughput potrebbe richiedere fino a 15 minuti. Durante la modifica delle prestazioni, gli SLA e gli SLO relativi alle prestazioni non sono validi. Puoi modificare il livello di throughput di un volume esistente in qualsiasi momento, indipendentemente dal fatto che il disco sia collegato o meno a un'istanza in esecuzione.

Il nuovo livello di throughput specificato deve rispettare i valori supportati per i volumi Hyperdisk Balanced, Hyperdisk Throughput e Hyperdisk Balanced High Availability, rispettivamente.

Per aggiornare il livello di throughput riservato per un volume Hyperdisk, devi identificare il nome del Persistent Disk che supporta le risorse PersistentVolumeClaim e PersistentVolume:

  1. Vai al browser degli oggetti nella console Google Cloud .

    Vai al visualizzatore oggetti

  2. Trova la voce relativa all'oggetto PersistentVolumeClaim.

  3. Fai clic sul link Volume.

  4. Apri la scheda YAML del PersistentVolume associato. Individua il valore CSI volumeHandle in questa scheda.

  5. Prendi nota dell'ultimo elemento di questo handle (dovrebbe avere un valore simile a "pvc-XXXXX"). Questo è il nome del tuo PersistentVolumeClaim. Prendi nota anche del progetto e della zona.

IOPS

L'aggiornamento delle IOPS sottoposte a provisioning è supportato solo per i volumi Hyperdisk Balanced, Hyperdisk Balanced High Availability e Hyperdisk Extreme.

Per aggiornare il livello di IOPS di cui è stato eseguito il provisioning del volume Hyperdisk, segui le istruzioni della console Google Cloud , di gcloud CLI o dell'API Compute Engine riportate in Modifica delle prestazioni di cui è stato eseguito il provisioning per un volume Hyperdisk.

Puoi modificare il livello di IOPS sottoposte a provisioning (fino a una volta ogni 4 ore) per un volume Hyperdisk IOPS dopo la creazione del volume. L'applicazione dei nuovi livelli di IOPS potrebbe richiedere fino a 15 minuti. Durante la modifica delle prestazioni, gli SLA e gli SLO relativi alle prestazioni non sono attivi. Puoi modificare il livello di IOPS di un volume esistente in qualsiasi momento, indipendentemente dal fatto che il disco sia collegato o meno a un'istanza in esecuzione.

Il nuovo livello di IOPS specificato deve rispettare i valori supportati per i volumi Hyperdisk Balanced o Hyperdisk Extreme, rispettivamente.

Per aggiornare il livello di IOPS sottoposto a provisioning per un volume Hyperdisk, devi identificare il nome del Persistent Disk che supporta le risorse PersistentVolumeClaim e PersistentVolume:

  1. Vai al browser degli oggetti nella console Google Cloud .

    Vai al visualizzatore oggetti

  2. Trova la voce relativa all'oggetto PersistentVolumeClaim.

  3. Fai clic sul link Volume.

  4. Apri la scheda YAML del PersistentVolume associato. Individua il valore CSI volumeHandle in questa scheda.

  5. Prendi nota dell'ultimo elemento di questo handle (dovrebbe avere un valore simile a "pvc-XXXXX"). Questo è il nome del tuo PersistentVolumeClaim. Dovresti anche prendere nota del progetto e della zona.

Monitora il throughput o le IOPS su un volume Hyperdisk

Per monitorare le prestazioni di cui è stato eseguito il provisioning del volume Hyperdisk, consulta Analizza le IOPS e il throughput di cui è stato eseguito il provisioning nella documentazione di Compute Engine.

Risoluzione dei problemi

Questa sezione fornisce indicazioni per la risoluzione dei problemi relativi ai volumi Hyperdisk su GKE.

Impossibile modificare le prestazioni o la capacità: rapporto fuori intervallo

Il seguente errore si verifica quando tenti di modificare il livello di prestazioni o la capacità di cui è stato eseguito il provisioning, ma il livello di prestazioni o la capacità che hai scelto non rientra nell'intervallo accettabile per il volume:

  • Requested provisioned throughput cannot be higher than <value>.
  • Requested provisioned throughput cannot be lower than <value>.
  • Requested provisioned throughput is too high for the requested disk size.
  • Requested provisioned throughput is too low for the requested disk size.
  • Requested disk size is too high for current provisioned throughput.

Il throughput riservato per i volumi Hyperdisk Throughput deve soddisfare i seguenti requisiti:

  • Almeno 10 MiB/s per TiB di capacità e non più di 90 MiB/s per TiB di capacità.
  • Al massimo 600 MiB/s per volume.

Per risolvere il problema, correggi la portata o la capacità richiesta in modo che rientri nell'intervallo consentito ed esegui nuovamente il comando.

Impossibile modificare le prestazioni: limitazione di frequenza

Il seguente errore si verifica quando tenti di modificare il livello di prestazioni di cui è stato eseguito il provisioning, ma il livello di prestazioni è già stato modificato nelle ultime 4 ore:

Cannot update provisioned throughput due to being rate limited.
Cannot update provisioned iops due to being rate limited.

Le prestazioni di cui è stato eseguito il provisioning dei volumi Hyperdisk Throughput e Hyperdisk IOPS possono essere aggiornate una volta ogni 4 ore. Per risolvere il problema, attendi che il timer di attesa per il volume scada, quindi esegui nuovamente il comando.

Passaggi successivi