Mencadangkan penyimpanan Persistent Disk menggunakan snapshot volume


Halaman ini menunjukkan cara mencadangkan dan memulihkan penyimpanan Persistent Disk menggunakan snapshot volume.

Untuk pengantar, lihat Tentang snapshot volume Kubernetes.

Persyaratan

Untuk menggunakan snapshot volume di GKE, Anda harus memenuhi persyaratan berikut:

  • Menggunakan driver CSI yang mendukung snapshot. Driver Persistent Disk hierarki tidak mendukung snapshot. Untuk membuat dan mengelola snapshot, Anda harus menggunakan driver CSI yang sama dengan PersistentVolumeClaim (PVC) yang mendasarinya.

  • Gunakan control plane versions 1.17 atau yang lebih baru. Untuk menggunakan driver CSI Compute Engine Persistent Disk di VolumeSnapshot, gunakan GKE versi 1.17.6-gke.4 atau yang lebih baru.

  • 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: pd.csi.storage.gke.io atau filestore.csi.storage.gke.io. Jika PersistentVolume disediakan secara dinamis oleh driver CSI seperti dijelaskan di bagian berikut, driver tersebut dikelola oleh driver CSI.

Batasan

Semua batasan untuk membuat snapshot disk di Compute Engine juga berlaku untuk GKE.

Praktik terbaik

Pastikan untuk mengikuti praktik terbaik untuk snapshot disk Compute Engine saat menggunakan snapshot Volume Persistent Disk di GKE.

Sebelum memulai

Sebelum memulai, pastikan Anda telah menjalankan tugas berikut:

  • Aktifkan Google Kubernetes Engine API.
  • Aktifkan Google Kubernetes Engine API
  • Jika ingin menggunakan Google Cloud CLI untuk tugas ini, instal lalu initialize gcloud CLI. Jika sebelumnya Anda telah menginstal gcloud CLI, dapatkan versi terbaru dengan menjalankan gcloud components update.

Membuat dan menggunakan snapshot volume

Contoh dalam dokumen ini menunjukkan cara melakukan tugas berikut:

  1. Buat PersistentVolumeClaim dan Deployment.
  2. Tambahkan file ke PersistentVolume yang digunakan Deployment.
  3. Buat VolumeSnapshotClass untuk mengonfigurasi snapshot.
  4. Buat snapshot volume PersistentVolume.
  5. Hapus file pengujian.
  6. Pulihkan PersistentVolume ke snapshot yang Anda buat.
  7. Verifikasi bahwa pemulihan berfungsi.

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

  1. Buat objek VolumeSnapshotClass untuk menentukan driver CSI dan kebijakan penghapusan untuk snapshot Anda.
  2. Buat objek VolumeSnapshot untuk meminta snapshot PersistentVolumeClaim yang ada.
  3. Referensikan VolumeSnapshot di PersistentVolumeClaim untuk memulihkan volume ke snapshot tersebut atau membuat volume baru menggunakan snapshot.

Membuat PersistentVolumeClaim dan Deployment

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

    Persistent Disk

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

    Contoh ini menggunakan kelas penyimpanan standard-rwo yang diinstal secara default dengan driver CSI Persistent Disk Compute Engine. Untuk mempelajari lebih lanjut, baca Menggunakan driver CSI Persistent Disk Compute Engine.

    Untuk spec.storageClassName, Anda dapat menentukan class penyimpanan apa pun yang menggunakan driver CSI yang didukung.

  2. Terapkan manifes:

    kubectl apply -f my-pvc.yaml
    
  3. Untuk membuat Deployment, simpan manifes berikut sebagai my-deployment.yaml:

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: hello-app
    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: sdk-volume
              mountPath: /usr/share/hello/
          volumes:
          - name: sdk-volume
            persistentVolumeClaim:
              claimName: my-pvc
    
  4. Terapkan manifes:

    kubectl apply -f my-deployment.yaml
    
  5. Periksa status Deployment:

    kubectl get deployment hello-app
    

    Mungkin perlu waktu beberapa saat sampai Deployment siap. Anda dapat menjalankan perintah sebelumnya hingga melihat output yang mirip dengan berikut ini:

    NAME        READY   UP-TO-DATE   AVAILABLE   AGE
    hello-app   1/1     1            1           2m55s
    

Menambahkan file pengujian ke volume

  1. Cantumkan Pods dalam Deployment:

    kubectl get pods -l app=hello-app
    

    Outputnya mirip dengan hal berikut ini:

    NAME                         READY   STATUS    RESTARTS   AGE
    hello-app-6d7b457c7d-vl4jr   1/1     Running   0          2m56s
    
  2. Buat file pengujian di Pod:

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

    Ganti POD_NAME dengan nama Pod.

  3. Verifikasi bahwa file tersebut ada:

    kubectl exec POD_NAME \
        -- sh -c 'cat /usr/share/hello/hello.txt'
    

    Outputnya mirip dengan hal berikut ini:

    Hello World!
    

Membuat objek VolumeSnapshotClass.

Buat objek VolumeSnapshotClass untuk menentukan driver CSI dan deletionPolicy untuk snapshot volume Anda. Anda dapat mereferensikan objek VolumeSnapshotClass saat membuat objek VolumeSnapshot.

  1. Simpan manifes berikut sebagai volumesnapshotclass.yaml.

    Persistent Disk

    Gunakan versi v1 API untuk cluster yang menjalankan versi 1.21 atau yang lebih baru.

    apiVersion: snapshot.storage.k8s.io/v1
    kind: VolumeSnapshotClass
    metadata:
      name: my-snapshotclass
    driver: pd.csi.storage.gke.io
    deletionPolicy: Delete
    

    Dalam contoh ini:

    • Kolom driver digunakan oleh driver CSI untuk menyediakan snapshot. Dalam contoh ini, pd.csi.storage.gke.io menggunakan driver CSI Persistent Disk Compute Engine.

    • Kolom deletionPolicy memberi tahu GKE apa yang harus dilakukan dengan objek VolumeSnapshotContent dan snapshot yang mendasarinya saat objek VolumeSnapshot terikat dihapus. Tentukan Delete untuk menghapus objek VolumeSnapshotContent dan snapshot yang mendasarinya. Tentukan Retain jika Anda ingin mempertahankan VolumeSnapshotContent dan snapshot yang mendasarinya.

      Untuk menggunakan lokasi penyimpanan kustom, tambahkan parameter storage-locations ke class snapshot. Untuk menggunakan parameter ini, cluster Anda harus menggunakan versi 1.21 atau yang lebih baru.

      apiVersion: snapshot.storage.k8s.io/v1
      kind: VolumeSnapshotClass
      metadata:
        name: my-snapshotclass
      parameters:
        storage-locations: us-east2
      driver: pd.csi.storage.gke.io
      deletionPolicy: Delete
      
    • Untuk membuat disk image, tambahkan baris berikut ke kolom parameters:

      parameters:
        snapshot-type: images
        image-family: IMAGE_FAMILY
      

      Ganti IMAGE_FAMILY dengan nama kelompok image pilihan Anda, seperti preloaded-data.

  2. Terapkan manifes:

    kubectl apply -f volumesnapshotclass.yaml
    

Membuat VolumeSnapshot

Objek VolumeSnapshot adalah permintaan untuk snapshot objek PersistentVolumeClaim yang sudah ada. Saat Anda membuat objek VolumeSnapshot, GKE 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: my-snapshot
    spec:
      volumeSnapshotClassName: my-snapshotclass
      source:
        persistentVolumeClaimName: my-pvc
    
  2. Terapkan manifes:

    kubectl apply -f volumesnapshot.yaml
    

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

  3. Konfirmasi bahwa GKE membuat objek VolumeSnapshotContents:

    kubectl get volumesnapshotcontents
    

    Outputnya mirip dengan hal berikut ini:

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

Setelah konten snapshot Volume dibuat, driver CSI yang Anda tentukan dalam VolumeSnapshotClass akan membuat snapshot pada sistem penyimpanan yang sesuai. Setelah GKE membuat snapshot di sistem penyimpanan dan mengikatnya ke objek VolumeSnapshot di cluster, snapshot siap digunakan. Anda dapat memeriksa status 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
my-snapshot        true

Menghapus file pengujian

  1. Hapus file pengujian yang Anda buat:

    kubectl exec POD_NAME \
        -- sh -c 'rm /usr/share/hello/hello.txt'
    
  2. Verifikasi bahwa file sudah tidak ada:

    kubectl exec POD_NAME \
        -- sh -c 'cat /usr/share/hello/hello.txt'
    

    Outputnya mirip dengan hal berikut ini:

    cat: /usr/share/hello/hello.txt: No such file or directory
    

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. Proses yang sama akan digunakan terlepas dari apakah VolumeSnapshotContents mengacu pada disk image atau snapshot.

Dalam contoh ini, Anda mereferensikan VolumeSnapshot yang Anda buat di PersistentVolumeClaim baru dan memperbarui Deployment untuk menggunakan klaim baru tersebut.

  1. Pastikan apakah Anda menggunakan snapshot disk atau image, yang berbeda sebagai berikut:

    • Snapshot disk: Seringlah mengambil snapshot dan jarang memulihkan.
    • Snapshot gambar: Tidak sering mengambil snapshot dan sering memulihkan. Snapshot image juga mungkin lebih lambat dibuat daripada snapshot disk.

    Untuk mengetahui detailnya, lihat Batas frekuensi snapshot. Mengetahui jenis snapshot Anda akan membantu jika Anda perlu memecahkan masalah apa pun.

    Periksa VolumeSnapshot:

    kubectl describe volumesnapshot SNAPSHOT_NAME
    

    Kolom volumeSnapshotClassName menentukan class snapshot.

    kubectl describe volumesnapshotclass SNAPSHOT_CLASS_NAME
    

    Parameter snapshot-type akan menentukan snapshots atau images. Jika tidak diberikan, defaultnya adalah snapshots.

    Jika tidak ada class snapshot (misalnya, jika snapshot dibuat secara statis), periksa VolumeSnapshotContents. sh kubectl describe volumesnapshotcontents SNAPSHOT_CONTENTS_NAME Format handle snapshot dalam output memberi tahu Anda jenis snapshot, sebagai berikut: * projects/PROJECT_NAME/global/snapshots/SNAPSHOT_NAME: snapshot disk

    • projects/PROJECT_NAME/global/images/IMAGE_NAME: snapshot image
  1. Simpan manifes berikut sebagai pvc-restore.yaml:

    Persistent Disk

    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: pvc-restore
    spec:
      dataSource:
        name: my-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. Perbarui file my-deployment.yaml untuk menggunakan PersistentVolumeClaim yang baru:

    ...
    volumes:
    - name: my-volume
      persistentVolumeClaim:
        claimName: pvc-restore
    
  4. Terapkan manifes yang diupdate:

    kubectl apply -f my-deployment.yaml
    

Pastikan snapshot berhasil dipulihkan

  1. Dapatkan nama Pod baru yang dibuat GKE untuk Deployment yang telah diupdate:

     kubectl get pods -l app=hello-app
    

Pastikan file pengujian ada:

   kubectl exec NEW_POD_NAME \
       -- sh -c 'cat /usr/share/hello/hello.txt'

Ganti NEW_POD_NAME dengan nama Pod baru yang dibuat GKE.

Outputnya mirip dengan hal berikut ini:

   Hello World!

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

  1. Hapus VolumeSnapshot.

    kubectl delete volumesnapshot my-snapshot
    
  2. Hapus VolumeSnapshotClass.

    kubectl delete volumesnapshotclass my-snapshotclass
    
  3. Hapus Deployment.

    kubectl delete deployments hello-app
    
  4. Hapus objek PersistentVolumeClaim:

    kubectl delete pvc my-pvc pvc-restore
    

Langkah selanjutnya