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.
- Imposta la regione e la zona predefinite su uno dei valori supportati.
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-balancedhyperdisk-throughputhyperdisk-extremehyperdisk-mlhyperdisk-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. |
Gli esempi seguenti mostrano come creare un oggetto StorageClass per ogni tipo di Hyperdisk:
Hyperdisk bilanciato
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"Crea la classe di archiviazione:
kubectl create -f hdb-example-class.yaml
Hyperdisk Throughput
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"Crea la classe di archiviazione:
kubectl create -f hdt-example-class.yaml
Hyperdisk Extreme
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"Crea la classe di archiviazione:
kubectl create -f hdx-example-class.yaml
Hyperdisk bilanciato ad alta affidabilità
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
allowedTopologiesper 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 - ZONE2Crea 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.
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: 20GiApplica 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.
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: 2TiApplica 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.
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: 64GiApplica 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.
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: 20GiApplica 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).
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: falsePer creare un deployment basato sul file manifest
hyperdisk-example-deployment.yaml, esegui questo comando:kubectl apply -f hyperdisk-example-deployment.yamlVerifica che il deployment sia stato creato correttamente:
kubectl get deploymentIl completamento del provisioning delle istanze Hyperdisk potrebbe richiedere alcuni minuti. Al termine del provisioning, il deployment segnala lo stato
READY.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
Nella console Google Cloud , vai alla pagina Dischi.
Fai clic su Crea disco.
In Tipo di disco, scegli una delle seguenti opzioni per il tipo di disco:
- Hyperdisk bilanciato
- Hyperdisk Extreme
- Hyperdisk Throughput
- Hyperdisk ad alta affidabilità
In Tipo di disco di origine, fai clic su Snapshot.
Seleziona il nome dello snapshot da ripristinare.
Seleziona le dimensioni del nuovo disco in GiB. Questo numero deve essere uguale o maggiore del disco di origine iniziale per lo snapshot.
Imposta il throughput riservato o le IOPS riservate che vuoi per il disco, se diversi dai valori predefiniti.
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 prestazioniIOPS_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:
Vai al browser degli oggetti nella console Google Cloud .
Trova la voce relativa all'oggetto PersistentVolumeClaim.
Fai clic sul link Volume.
Apri la scheda YAML del PersistentVolume associato. Individua il valore CSI
volumeHandlein questa scheda.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:
Vai al browser degli oggetti nella console Google Cloud .
Trova la voce relativa all'oggetto PersistentVolumeClaim.
Fai clic sul link Volume.
Apri la scheda YAML del PersistentVolume associato. Individua il valore CSI
volumeHandlein questa scheda.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
- Scopri come configurare un cluster GKE con un disco di avvio personalizzato Hyperdisk bilanciato.
- Scopri come eseguire la migrazione dei volumi Persistent Disk su Hyperdisk.
- Scopri come utilizzare l'espansione del volume.
- Scopri come utilizzare gli snapshot dei volumi.
- Scopri di più sul driver su GitHub.