Crea cloni di volumi permanenti

Autopilot Standard

Questo documento mostra come utilizzare la clonazione dei volumi Kubernetes per clonare volumi permanenti nei cluster Google Kubernetes Engine (GKE).

Panoramica

Un clone è un nuovo volume indipendente che è un duplicato di un volume Kubernetes esistente. Un clone è simile a uno snapshot del volume in quanto è una copia di un volume in un momento specifico. Tuttavia, anziché creare un oggetto snapshot dal volume di origine, la clonazione del volume fornisce al clone tutti i dati del volume di origine.

Requisiti

Per utilizzare la clonazione dei volumi su GKE, devi soddisfare i seguenti requisiti:

L'oggetto PersistentVolumeClaim di origine deve trovarsi nello stesso spazio dei nomi dell'oggetto PersistentVolumeClaim di destinazione.
Utilizza un driver CSI che supporti la clonazione dei volumi. Il driver del disco permanente integrato non supporta la clonazione di volumi.
- Il driver CSI del disco permanente di Compute Engine versione 1.4.0 e successive supporta la clonazione dei volumi ed è installato per impostazione predefinita sui nuovi cluster Linux che eseguono GKE versione 1.22 o successive. Puoi anche abilitare il driver CSI del disco permanente di Compute Engine su un cluster esistente.

Per verificare la versione del driver CSI del disco permanente di Compute Engine, esegui questo comando nellgcloud CLI:

kubectl describe daemonsets pdcsi-node --namespace=kube-system | grep "gke.gcr.io/gcp-compute-persistent-disk-csi-driver"

Se l'output mostra una versione precedente a 1.4.0, esegui manualmente l'upgrade del piano di controllo per ottenere la versione più recente.

Limitazioni

Entrambi i volumi devono utilizzare la stessa modalità volume. Per impostazione predefinita, GKE imposta VolumeMode su ext4.
Tutte le limitazioni per la creazione di un clone di disco da un disco esistente in Compute Engine si applicano anche a GKE.
Puoi creare un clone di disco a livello di regione da un disco di zona, ma tieni presente le limitazioni di questo approccio.
La clonazione deve essere eseguita in una zona compatibile. Utilizza allowedTopologies per limitare la topologia dei volumi di cui è stato eseguito il provisioning a zone specifiche. In alternativa, è possibile usare nodeSelectors o Affinità e anti-affinità per limitare un pod in modo che ne sia limitato l'esecuzione su un determinato nodo in esecuzione in una zona compatibile.
- Per la clonazione a livello di zona o di zona, la zona di clonazione deve corrispondere alla zona del disco di origine.
- Per la clonazione a livello di zona o di regione, una delle zone di replica del clone deve corrispondere alla zona del disco di origine.

Utilizzo della clonazione dei volumi

Per eseguire il provisioning di un clone di volume, aggiungi un riferimento a un PersistentVolumeClaim esistente nello stesso spazio dei nomi al campo dataSource di un nuovo PersistentVolumeClaim. L'esercizio seguente mostra come eseguire il provisioning di un volume di origine con i dati, creare un clone di volume e utilizzare il clone.

Crea un volume di origine

Per creare un volume di origine, segui le istruzioni in Utilizzo del driver CSI del disco permanente di Compute Engine per i cluster Linux per creare un oggetto StorageClass, un PersistentVolumeClaim e un pod per consumare il nuovo volume. Utilizzerai l'oggetto PersistentVolumeClaim che crei come origine per il clone del volume.

Aggiungere un file di test al volume di origine

Aggiungi un file di test al volume di origine. Puoi cercare questo file di test nel clone del volume per verificare che la clonazione sia riuscita.

Crea un file di test in un pod:
```
kubectl exec POD_NAME \
    -- sh -c 'echo "Hello World!" > /var/lib/www/html/hello.txt'
```
Sostituisci POD_NAME con il nome di un pod che utilizza il volume di origine. Ad esempio, se hai seguito le istruzioni in Utilizzo del driver CSI del disco permanente di Compute Engine per i cluster Linux, sostituisci POD_NAME con web-server.

Verifica che il file esista:

kubectl exec POD_NAME \
    -- sh -c 'cat /var/lib/www/html/hello.txt'

L'output è simile al seguente:

Hello World!

clona il volume di origine

Salva il seguente manifest con il nome podpvc-clone.yaml:
```
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: podpvc-clone
spec:
  dataSource:
    name: PVC_NAME
    kind: PersistentVolumeClaim
  accessModes:
  - ReadWriteOnce
  storageClassName: STORAGE_CLASS_NAME
  resources:
    requests:
      storage: STORAGE
```
Sostituisci quanto segue:
- PVC_NAME: il nome dell'oggetto PersistentVolumeClaim di origine che hai creato in Creare un volume di origine.
- STORAGE_CLASS_NAME: il nome dell'oggetto StorageClass da utilizzare, che deve essere uguale a quello dell'oggetto PersistentVolumeClaim di origine.
- STORAGE: la quantità di spazio di archiviazione da richiedere, che deve essere almeno delle dimensioni dell'oggetto PersistentVolumeClaim di origine.
Applica il manifest:
```
kubectl apply -f podpvc-clone.yaml
```

Crea un pod che consuma il volume clonato

L'esempio seguente crea un pod che consuma il clone del volume che hai creato.

Salva il seguente manifest con il nome web-server-clone.yaml:

apiVersion: v1
kind: Pod
metadata:
  name: web-server-clone
spec:
  containers:
   - name: web-server-clone
     image: nginx
     volumeMounts:
       - mountPath: /var/lib/www/html
         name: mypvc
  volumes:
   - name: mypvc
     persistentVolumeClaim:
       claimName: podpvc-clone
       readOnly: false

Applica il manifest:
```
kubectl apply -f web-server-clone.yaml
```

Verifica che il file di test esista:

kubectl exec web-server-clone \
    -- sh -c 'cat /var/lib/www/html/hello.txt'

L'output è simile al seguente:

Hello World!

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Elimina l'oggetto Pod:

kubectl delete pod POD_NAME web-server-clone

Elimina l'oggetto PersistentVolumeClaim:
```
kubectl delete pvc podpvc podpvc-clone
```