Mengambil snapshot PersistentVolume

Anda dapat menggunakan fitur snapshot volume Kubernetes untuk Volume persisten dan penyediaan dinamis di cluster GKE Anda.

Snapshot volume memungkinkan Anda membuat salinan volume pada waktu tertentu. Anda dapat menggunakan salinan ini untuk mengembalikan volume ke status sebelumnya atau untuk menyediakan volume pengganti.

Anda dapat menyediakan dan melampirkan snapshot volume dengan komponen berikut:

Persyaratan

Untuk menggunakan snapshot volume pada GKE di Azure, Anda harus memiliki hal-hal berikut:

  • Volume menggunakan driver Antarmuka Penyimpanan Container (CSI) yang mendukung snapshot. Driver File Azure dan Disk Azure yang digunakan GKE di Azure secara default untuk snapshot dukungan.

    Untuk mengetahui daftar semua driver CSI yang mendukung snapshot, lihat kolom "Fitur lainnya" di Driver dalam dokumentasi Kubernetes.

  • Memiliki PersistentVolumeClaim yang ada untuk digunakan untuk snapshot. PersistentVolume yang Anda gunakan untuk sumber snapshot harus dikelola oleh driver CSI. Anda dapat memverifikasi bahwa Anda menggunakan driver CSI dengan memeriksa apakah spesifikasi PersistentVolume memiliki bagian csi dengan driver: disk.csi.azure.com atau file.csi.azure.com. Jika cluster Anda menyediakan PersistentVolumes secara dinamis oleh driver CSI seperti yang dijelaskan di bagian berikut, cluster tersebut akan dikelola oleh driver CSI.

Sebelum memulai

Membuat dan menggunakan snapshot volume

Contoh dalam dokumen ini menunjukkan cara melakukan tugas berikut:

  1. Buat contoh PersistentVolumeClaim dan Pod.
  2. Membuat VolumeSnapshot.
  3. Pulihkan ringkasan volume.
  4. Verifikasi bahwa pemulihan berfungsi.

Untuk menggunakan snapshot volume, Anda harus menyelesaikan langkah-langkah berikut:

  1. Buat objek VolumeSnapshot untuk meminta snapshot PersistentVolumeClaim yang ada.
  2. Merujuk VolumeSnapshot dalam PersistentVolumeClaim untuk memulihkan volume ke snapshot tersebut atau membuat volume baru menggunakan snapshot tersebut.

Buat contoh PersistentVolumeClaim dan Pod

  1. Untuk membuat objek PersistentVolumeClaim, simpan manifes berikut sebagai example-pvc.yaml:

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

    Untuk spec.storageClassName, Anda dapat menentukan class penyimpanan apa pun yang menggunakan driver CSI yang didukung. Contoh ini menggunakan kelas penyimpanan standard-rwo default.

  2. Terapkan manifes:

    kubectl apply -f example-pvc.yaml
    
  3. Membuat Pod yang menuliskan tanggal dan waktu saat ini ke volume. Untuk membuat Pod, simpan manifes berikut sebagai snapshot-shell.yaml:

    apiVersion: v1
    kind: Pod
    metadata:
      name: snapshot-shell
    spec:
      terminationGracePeriodSeconds: 10
      containers:
      - name: linux
        image: ubuntu:bionic
        command: ["/bin/sh"]
        args: ["-c", "echo $(date -u) >> /data/out.txt"]
        volumeMounts:
        - name: snapshot-volume
          mountPath: /data
      restartPolicy: Never
      volumes:
      - name: snapshot-volume
        persistentVolumeClaim:
          claimName: example-pvc
    
  4. Terapkan manifes:

    kubectl apply -f snapshot-shell.yaml
    
  5. Periksa status Pod:

    kubectl get pod snapshot-shell
    

    Perlu waktu beberapa saat sampai Pod berjalan dan selesai. Anda dapat menjalankan perintah sebelumnya hingga melihat output yang mirip dengan berikut ini:

    NAME             READY   STATUS      RESTARTS   AGE
    snapshot-shell   0/1     Completed   0          24s
    

Membuat VolumeSnapshot

Objek VolumeSnapshot adalah permintaan untuk snapshot objek PersistentVolumeClaim yang sudah ada. Saat membuat objek VolumeSnapshot, cluster Anda akan otomatis membuat dan mengikatnya dengan objek VolumeSnapshotContent, yang merupakan resource di cluster Anda seperti objek PersistentVolume.

  1. Simpan manifes berikut sebagai volumesnapshot.yaml.

    apiVersion: snapshot.storage.k8s.io/v1
    kind: VolumeSnapshot
    metadata:
      name: example-snapshot
    spec:
      source:
        persistentVolumeClaimName: example-pvc
    
  2. Terapkan manifes:

    kubectl apply -f volumesnapshot.yaml
    

    Setelah membuat snapshot volume, cluster Anda akan membuat objek VolumeSnapshotContent yang sesuai. Objek ini menyimpan snapshot dan binding objek VolumeSnapshot. Anda tidak berinteraksi dengan objek VolumeSnapshotContents secara langsung.

  3. Konfirmasi bahwa cluster Anda membuat objek VolumeSnapshotContents:

    kubectl get volumesnapshotcontents
    

    Outputnya mirip dengan hal berikut ini:

    NAME                                               AGE
    snapcontent-cee5fb1f-5427-11ea-a53c-42010a1000da   55s
    

Pastikan snapshot volume sudah siap

Setelah konten snapshot volume dibuat, driver CSI yang Anda tentukan dalam VolumeSnapshotClass akan membuat snapshot pada sistem penyimpanan yang sesuai. Setelah cluster Anda membuat snapshot di sistem penyimpanan dan mengikatnya ke objek VolumeSnapshot, snapshot siap digunakan. Anda dapat memeriksa statusnya dengan menjalankan perintah berikut:

kubectl get volumesnapshot \
  -o custom-columns='NAME:.metadata.name,READY:.status.readyToUse'

Jika snapshot siap digunakan, outputnya akan mirip dengan berikut ini:

NAME                    READY
example-snapshot        true

Memulihkan snapshot volume

Anda dapat mereferensikan VolumeSnapshot di PersistentVolumeClaim untuk menyediakan volume baru dengan data dari volume yang ada atau memulihkan volume ke status yang Anda rekam dalam snapshot.

Untuk mereferensikan VolumeSnapshot dalam PersistentVolumeClaim, tambahkan kolom dataSource ke PersistentVolumeClaim Anda.

Dalam contoh ini, Anda mereferensikan VolumeSnapshot yang Anda buat di PersistentVolumeClaim baru dan membuat Pod yang memasang PersistentVolumeClaim.

  1. Simpan manifes berikut sebagai pvc-restore.yaml:

    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
     name: pvc-restore
    spec:
     dataSource:
       name: example-snapshot
       kind: VolumeSnapshot
       apiGroup: snapshot.storage.k8s.io
     storageClassName: standard-rwo
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 1Gi
    
  2. Terapkan manifes:

    kubectl apply -f pvc-restore.yaml
    
  3. Luncurkan Pod sementara yang memasang PVC ke Pod dan mencetak konten out.txt ke log.

    Simpan manifes berikut sebagai restore-log.yaml:

    apiVersion: v1
    kind: Pod
    metadata:
      name: restore-verify
    spec:
      volumes:
        - name: restore-data
          persistentVolumeClaim:
            claimName: pvc-restore
      containers:
        - name: shell-container
          image: ubuntu:bionic
          volumeMounts:
            - mountPath: "/data"
              name: restore-data
          command: [ "/bin/sh" ]
          args: ["-c", "cat /data/out.txt", "exit", "1"]
      restartPolicy: Never
    
  4. Terapkan manifes:

    kubectl apply -f restore-log.yaml
    

Pastikan snapshot berhasil dipulihkan

Pod yang Anda buat pada langkah sebelumnya akan membaca dari snapshot. Untuk melihat data dari snapshot, gunakan perintah kubectl logs.

kubectl logs restore-verify

Output harus menyertakan stempel waktu dari snapshot.

Pembersihan

Agar tidak menimbulkan biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

  1. Hapus VolumeSnapshot.

    kubectl delete volumesnapshot example-snapshot
    

  2. Hapus Pod sementara:

    kubectl delete -f restore-log.yaml
    
  3. Hapus Pod:

    kubectl delete -f snapshot-shell.yaml
    
  4. Hapus objek PersistentVolumeClaim:

    kubectl delete pvc example-pvc pvc-restore
    

Langkah selanjutnya