Ripristina un volume da uno snapshot

Questo documento mostra come creare uno snapshot del volume e quindi utilizzarlo per ripristinare il volume. Le istruzioni qui riportate si applicano ai cluster che utilizzano il driver CSI vSphere.

Prima di iniziare

Consulta la pagina relativa all'utilizzo del driver vSphere Container Storage Interface.

Verifica che nel cluster sia presente un oggetto StorageClass denominato standard-rwo e che il driver CSI di vSphere sia installato.

La tua versione di vSphere, ESXi e vCenter Server, deve essere 7.0 Update 3 o versioni successive. Per ulteriori informazioni, consulta la sezione Risoluzione dei problemi di archiviazione.

Panoramica della procedura

Questi sono i passaggi principali dell'esercizio indicato in questo documento:

  1. Crea un PersistentVolumeClaim.
    Crea una richiesta PersitentVolumeClaim che richieda la classe di archiviazione standard-rwo. Il cluster esegue il provisioning dinamico di un PersistentVolume e lo associa al tuo PersistentVolumeClaim.
  2. Creare un deployment.
    Creare un deployment con un solo pod. Il pod specifica un volume in base al tuo PersistentVolumeClaim. L'unico container nel pod monta il volume in /hello/.
  3. Scrivere un file nel volume del pod.
    Crea un file denominato hello.txt nel volume del pod. Il contenuto del file è "Hello World!".
  4. Creare un volumeSnapshot.
    Crea un oggetto VolumeSnapshot che acquisisca lo stato del volume del pod.
  5. Danneggia il file.
    Modifica il file hello.txt in modo che sembri un file danneggiato. Ora il contenuto del file è "Hello W-corrupted-file-orld!"
  6. Utilizza lo snapshot per ripristinare il volume.
    Crea un secondo oggetto PersistentVolumeClaim che utilizza VolumeSnapshot come origine dati. Modifica il tuo deployment in modo che il suo volume venga associato al nuovo PersistentVolumeClaim. Dopodiché verifica che il file hello.txt sia stato ripristinato.

Crea un PersistentVolumeClaim

Di seguito è riportato un manifest per un PersistentVolumeClaim:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 5Gi
  storageClassName: standard-rwo

Nel file manifest precedente, puoi vedere che storageClassName è impostato su standard-rwo. Questa è la classe di archiviazione associata al driver CSI vSphere.

Salva il manifest in un file denominato my-pvc.yaml. Crea e visualizza l'oggetto PersistentVolumeClaim:

kubectl --kubeconfig CLUSTER_KUBECONFIG apply -f my-pvc.yaml

kubectl --kubeconfig CLUSTER_KUBECONFIG get pvc my-pvc

Nell'output puoi vedere che l'oggetto PersistentVolumeClaim è associato a un PersistentVolume di cui è stato eseguito il provisioning dinamico. Ad esempio, il seguente output mostra che l'oggetto PersistentVolumeClaim denominato my-pvc è associato a un PersistentVolume denominato pvc-467d211c-26e4-4d69-aaa5-42219aee6fd5:

my-pvc   Bound    pvc-467d211c-26e4-4d69-aaa5-42219aee6fd5  …  standard-rwo   100s

Creazione di un deployment

Ecco il manifest per un deployment:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-deployment
spec:
  selector:
    matchLabels:
      app: hello-app
  template:
    metadata:
      labels:
        app: hello-app
    spec:
      containers:
      - name: hello-app
        image: google/cloud-sdk:slim
        args: [ "sleep", "3600" ]
        volumeMounts:
        - name: my-volume
          mountPath: /hello/
      volumes:
      - name: my-volume
        persistentVolumeClaim:
          claimName: my-pvc

Nel contesto di questo esercizio, ecco i punti importanti da comprendere in merito al precedente manifest di deployment:

  • Il pod richiede spazio di archiviazione specificando l'oggetto PersistentVolumeClaim, my-pvc, che hai creato in precedenza.

  • Il pod ha un container, il quale monta il volume su /hello/.

Salva il manifest in un file denominato my-deployment.yaml e crea il deployment:

kubectl --kubeconfig CLUSTER_KUBECONFIG apply -f my-deployment.yaml

Il deployment ha un solo pod. Ottieni il nome del pod:

kubectl --kubeconfig CLUSTER_KUBECONFIG get pods

Prendi nota del nome del pod. Ad esempio, nell'output seguente, il nome del pod è my-deployment-7575c4f5bf-r59nt:

my-deployment-7575c4f5bf-r59nt   1/1     Running   0          65s

Creare un file nel volume del pod e visualizzarlo.

kubectl --kubeconfig CLUSTER_KUBECONFIG \
    exec POD_NAME \
    -- sh -c 'echo "Hello World!" > /hello/hello.txt'

kubectl --kubeconfig CLUSTER_KUBECONFIG \
    exec POD_NAME \
    -- sh -c 'cat /hello/hello.txt'

L'output mostra i contenuti del file /hello/hello.txt:

Hello World!

Crea uno snapshot

Ecco il manifest per un volumeSnapshot:

apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshot
metadata:
  name: my-snapshot
spec:
  volumeSnapshotClassName: csi-vsphere-snapshot-class
  source:
    persistentVolumeClaimName: my-pvc

Salva il manifest in un file denominato my-snapshot.yaml e crea il volumeSnapshot:

kubectl --kubeconfig CLUSTER_KUBECONFIG apply -f my-snapshot.yaml

Danneggia il file nel volume

Modifica i contenuti di hello.txt in modo che sembrino danneggiati:

kubectl --kubeconfig CLUSTER_KUBECONFIG \
    exec POD_NAME \
    -- sh -c 'echo "Hello W-corrupted-file-orld!" > /hello/hello.txt'

kubectl --kubeconfig CLUSTER_KUBECONFIG \
    exec POD_NAME \
    -- sh -c 'cat /hello/hello.txt'

Nell'output, puoi vedere che il file è stato modificato:

Hello W-corrupted-file-orld!

Ripristina

Di seguito è riportato un manifest per un secondo PersistentVolumeClaim:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-pvc-2
spec:
  storageClassName: standard-rwo
  dataSource:
    name: my-snapshot
    kind: VolumeSnapshot
    apiGroup: snapshot.storage.k8s.io
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 5Gi

Nel manifest precedente puoi vedere che l'origine dati per la nuova richiesta di PersistentVolume è il volumeSnapshot creato in precedenza.

Salva il manifest in un file denominato my-pvc-2.yaml. Crea e visualizza l'oggetto PersistentVolumeClaim:

kubectl --kubeconfig CLUSTER_KUBECONFIG apply -f my-pvc-2.yaml

kubectl --kubeconfig CLUSTER_KUBECONFIG get pvc my-pvc-2

Apri il deployment per la modifica:

kubectl --kubeconfig CLUSTER_KUBECONFIG edit deployment my-deployment

Modifica my-pvc in my-pvc-2 e chiudi l'editor:

…
  volumes:
  - name: my-volume
    persistentVolumeClaim:
    claimName: my-pvc-2

Il deployment elimina il pod e ne crea uno nuovo che utilizza il nuovo PersistentVolumeClaim.

Attendi qualche minuto, quindi ottieni il nuovo nome del pod:

kubectl --kubeconfig CLUSTER_KUBECONFIG get pods

Verifica che il volume del pod sia stato ripristinato:

kubectl --kubeconfig CLUSTER_KUBECONFIG \
   exec NEW_POD_NAME \
   -- sh -c 'cat /hello/hello.txt'

L'output mostra che il volume è stato ripristinato:

Hello World!

Risoluzione dei problemi

Per indicazioni sulla risoluzione dei problemi, consulta Risoluzione dei problemi di archiviazione.