Memecahkan masalah error penyimpanan di Backup for GKE

Halaman ini menjelaskan error terkait penyimpanan yang mungkin Anda alami saat menggunakan Pencadangan untuk GKE, hal-hal yang perlu dipertimbangkan saat melakukan tindakan, dan langkah-langkah untuk memecahkan masalah.

Error 100010105: Failed to backup PersistentVolumeClaim - Disk referenced by PersistentVolume does not exist

Error 100010105 terjadi saat upaya mencadangkan PersistentVolumeClaim gagal karena merujuk ke disk yang tidak ada, sehingga menghasilkan pesan error yang menyatakan Failed to backup PersistentVolumeClaim - Disk referenced by PersistentVolume does not exist.

Di Google Kubernetes Engine, PersistentVolumeClaims meminta penyimpanan dari PersistentVolumes. PersistentVolume, pada gilirannya, mewakili bagian penyimpanan, sering kali Persistent Disk Compute Engine yang mendasarinya. Error dapat terjadi saat PersistentVolumeClaim terikat ke PersistentVolume dan konfigurasi PersistentVolume's menentukan Persistent Disk Compute Engine. Namun, disk sebenarnya dengan nama dan lokasi yang ditentukan dalam konfigurasi PersistentVolume tidak dapat ditemukan di your Cloud de Confiance by S3NS project. Dengan demikian, Pencadangan untuk GKE tidak dapat melanjutkan pencadangan disk yang tidak ada, dan terjadi kegagalan.

Untuk mengatasi error ini, gunakan petunjuk berikut:

  1. Identifikasi PersistentVolumeClaim dan PersistentVolume yang bermasalah. Nama PersistentVolumeClaim yang bermasalah dan PersistentVolume terkait tercantum di kolom state reason dari operasi Pencadangan untuk GKE yang gagal. Sebaiknya dokumentasikan nama PersistentVolumeClaim, namespace-nya, dan nama PersistentVolume.

  2. Periksa PersistentVolume. Untuk mendeskripsikan PersistentVolume, gunakan nama PersistentVolume yang Anda identifikasi dari kolom alasan status dalam perintah berikut:

    kubectl describe pv PERSISTENTVOLUME_NAME

    Ganti PERSISTENTVOLUME_NAME dengan nama PersistentVolume Anda.

  3. Dalam output, periksa bagian source, khususnya di bagian csi. Bagian ini menjelaskan VolumeHandle yang coba dirujuk oleh PersistentVolume. Contoh:

    Source:
  Type: GCEPersistentDisk (a Persistent Disk resource in Google Compute Engine)
PDName: my-non-existent-disk
FSType: ext4
Partition: 0
ReadOnly: false
            In this example, the PD name is my-non-existent-disk.

    Source:
  Type:       CSI (a Container Storage Interface (CSI) volume)
  Driver:     pd.csi.storage.gke.io
  VolumeHandle: projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
...

    Dalam contoh ini, VolumeHandle berisi jalur lengkap ke disk, termasuk nama dan lokasinya. Misalnya, projects/my-gcp-project/zones/us-central1-a/disks/my-disk-name.

  4. Gunakan VolumeHandle yang diperoleh dari deskripsi PersistentVolume untuk mengidentifikasi nama dan zona disk.

  5. Pastikan disk ada di your Cloud de Confiance by S3NS project menggunakan salah satu metode berikut:

    Disk zona

    Jika Anda menggunakan disk zona, gunakan Google Cloud CLI untuk menjalankan perintah gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME \
    --zone=ZONE_NAME \
    --project=PROJECT_ID

    Ganti kode berikut:

    • DISK_NAME: nama disk yang Anda peroleh dari deskripsi PersistentVolume.

    • ZONE_NAME: zona disk yang Anda peroleh dari deskripsi PersistentVolume.

    • PROJECT_ID: ID your Cloud de Confiance by S3NS project.

    Disk regional

    Jika Anda menggunakan disk regional, gunakan Google Cloud CLI untuk menjalankan perintah gcloud compute disks describe:

    gcloud compute disks describe DISK_NAME \
    --region=REGION_NAME \
    --project=PROJECT_ID

    Ganti kode berikut:

    • DISK_NAME: nama disk yang Anda peroleh dari deskripsi PersistentVolume.

    • REGION_NAME: region disk yang Anda peroleh dari deskripsi PersistentVolume.

    • PROJECT_ID: ID your Cloud de Confiance by S3NS project.

    Jika Anda mendapatkan pesan error Resource not found atau The resource DISK_NAME was not found, disk tersebut tidak ada. Gunakan salah satu metode berikut untuk mengatasi masalah ini, bergantung pada skenario yang paling sesuai dengan kebutuhan Anda:

    • Jika disk tidak sengaja dihapus atau salah nama dan Anda ingin menyimpan data atau PersistentVolumeClaim, atau PersistentVolume dikonfigurasi dengan nama disk yang salah, gunakan salah satu metode berikut untuk mengatasi masalah ini:

      • Pulihkan disk: jika Anda memiliki cadangan disk, pulihkan dengan nama dan lokasi yang sama persis dengan yang dirujuk oleh PersistentVolume.

      • Buat disk baru: jika memulihkan disk bukan merupakan opsi, buat disk baru dengan nama dan lokasi yang sama dengan yang ada dalam PersistentVolume konfigurasi.

    • Jika PersistentVolumeClaim atau PersistentVolume, datanya, atau aplikasi tidak lagi diperlukan, sebaiknya hapus entity yang tidak diperlukan:

      • Hapus PersistentVolumeClaim: hapus PersistentVolumeClaim menggunakan alat command line kubectl untuk menjalankan perintah kubectl delete pvc:
      kubectl delete pvc PVC_NAME -n NAMESPACE

      Ganti kode berikut:

      • PVC_NAME: nama PersistentVolumeClaim yang ingin Anda hapus.

      • NAMESPACE: namespace PersistentVolumeClaim yang ingin Anda hapus.

    • The PersistentVolume masih ada setelah Anda menghapus PersistentVolumeClaim: jika PersistentVolumeReclaimPolicy PersistentVolume ditetapkan ke Delete, PersistentVolume akan otomatis dihapus saat PersistentVolumeClaim dihapus. Jika persistentVolumeReclaimPolicy ditetapkan ke Retain, Anda harus menghapus PersistentVolume secara manual setelah PersistentVolumeClaim dihapus. Untuk menghapus PersistentVolume, gunakan alat command line kubectl untuk menjalankan perintah kubectl delete pv:

      kubectl delete pv PV_NAME

      Ganti PV_NAME dengan nama PersistentVolume yang ingin Anda hapus.

Jika operasi terus gagal, hubungi Cloud Customer Care untuk mendapatkan bantuan lebih lanjut.

Error 100010202: Snapshotting volume failed

Error 100010202 terjadi saat pembuatan snapshot Persistent Disk Compute Engine gagal, sehingga menghasilkan pesan error yang menyatakan Snapshotting volume failed.

Operasi snapshot Persistent Disk Compute Engine gagal jika status lampiran disk ke instance virtual machine (VM) berubah selama proses pembuatan snapshot yang dimulai oleh layanan Pencadangan untuk GKE. Skenario umum yang memicu hal ini mencakup hal berikut:

  • Perbaikan otomatis node: node yang tidak sehat dibuat ulang, yang menyebabkan Pod dijadwalkan ulang dan disk dilepas serta dipasang kembali.
  • Upgrade node: selama upgrade kumpulan node, node biasanya dikuras dan diganti. Pod dihentikan dengan lancar dan dijadwalkan ulang di node baru, yang memicu siklus pelepasan dan pemasangan kembali disk.
  • Autoscaling cluster: selama peristiwa penurunan skala, jika autoscaler cluster menghapus node, Pod apa pun di node tersebut dengan Persistent Disk akan dikeluarkan, sehingga menyebabkan pelepasan disk. Jika Pod ini dijadwalkan ulang di tempat lain, lampiran akan terjadi di node baru. Selama peristiwa peningkatan skala, node baru tidak secara langsung menyebabkan pemasangan ulang, tetapi Pod yang dijadwalkan di node tersebut akan memicu lampiran awal.

Ini adalah error sementara. Pencadangan biasanya berhasil pada proses otomatis berikutnya setelah lampiran disk stabil. Untuk mencegah peristiwa cluster memengaruhi pencadangan Anda, terapkan rekomendasi berikut:

  1. Aktifkan Penjadwalan cerdas: Konfigurasi paket pencadangan Anda menggunakan Penjadwalan cerdas (jadwal berbasis RPO). Hal ini memungkinkan sistem mencoba kembali kegagalan sementara secara otomatis dalam jangka waktu yang Anda tentukan tanpa memengaruhi RPO keseluruhan paket pencadangan.

  2. Siapkan jangka waktu pengecualian pencadangan: Jika Anda melakukan operasi upgrade kumpulan node atau pengubahan ukuran cluster, tambahkan jangka waktu pengecualian pencadangan ke setelan pencadangan Anda selama interval tersebut. Hal ini memastikan bahwa layanan Pencadangan untuk GKE akan dijeda dan menghindari penjadwalan snapshot saat cluster Anda secara aktif mengubah lampiran disk.

  3. Coba Lagi Pencadangan Manual: Jika pencadangan manual atau sesuai permintaan, coba lagi operasi pencadangan setelah peristiwa cluster selesai.

Jika operasi terus gagal, hubungi Cloud Customer Care untuk mendapatkan bantuan lebih lanjut.

Langkah berikutnya