Pencadangan dan pemulihan CSI Cassandra

Saat ini Anda melihat versi 1.9 dari dokumentasi Apigee Hybrid. This version is end of life. You should upgrade to a newer version. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.9 (unsupported)

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Mulai Apigee hybrid 1.9, Anda dapat mencadangkan dan memulihkan data hybrid menggunakan snapshot CSI (Container Storage Interface). Pencadangan CSI menghasilkan snapshot disk dan menyimpannya sebagai data terenkripsi di penyimpanan cloud. Pencadangan CSI tidak memerlukan bucket Google Cloud Storage atau server jarak jauh untuk menyimpan data cadangan.

Pencadangan CSI direkomendasikan untuk instance hybrid yang dihosting di Google Cloud, AWS, atau Azure.

Halaman ini menjelaskan langkah-langkah untuk menggunakan pencadangan dan pemulihan CSI hybrid. Untuk ringkasan umum pencadangan dan pemulihan hibrida secara umum, lihat Ringkasan pencadangan dan pemulihan Cassandra.

Peringatan: Menggunakan perintah apigeectl delete dengan flag --all (misalnya, apigeectl delete --all -f overrides.yaml) akan menghapus semua data cadangan snapshot. Untuk mempertahankan data cadangan snapshot, kecualikan tanda --all (misalnya, apigeectl delete -f overrides.yaml).

Batasan pencadangan dan pemulihan

Perhatikan batasan berikut saat menggunakan pencadangan dan pemulihan CSI:

• Driver CSI yang digunakan oleh class penyimpanan yang dikonfigurasi harus mendukung snapshot CSI. Lihat daftar driver CSI Kubernetes ini untuk mengetahui informasi driver.
• Tidak semua platform didukung. Hanya platform Google Cloud, AWS, dan Azure yang didukung.
• OpenShift Container Platform tidak didukung karena keterbatasan snapshot volume.
• Hanya platform cloud yang didukung. Platform lokal tidak didukung.
• Data cadangan CSI dan data cadangan hibrida non-CSI tidak kompatibel. Cadangan non-CSI tidak dapat digunakan dengan pemulihan CSI dan cadangan CSI tidak dapat digunakan dengan pemulihan non-CSI.
• Penginstalan dan fungsi driver CSI adalah tanggung jawab vendor driver CSI.
• Pengguna bertanggung jawab untuk memastikan resource cluster yang memadai tersedia untuk penyediaan snapshot CSI.
• Pengguna bertanggung jawab untuk menghapus data snapshot lama.

Menyiapkan pencadangan CSI

Untuk menjadwalkan pencadangan hybrid menggunakan CSI, lakukan langkah-langkah berikut:

1. Jika Anda belum pernah menyiapkan pencadangan hybrid:
   1. Jalankan perintah create-service-account berikut untuk membuat akun layanan (SA) Google Cloud dengan peran roles/storage.objectAdmin standar. Peran SA ini memungkinkan Anda menulis data cadangan ke Cloud Storage. Jalankan perintah berikut di direktori hybrid-base-directory/hybrid-files:

      ./tools/create-service-account --env non-prod --dir ./service-accounts

      Perintah ini membuat satu akun layanan bernama apigee-non-prod untuk digunakan di lingkungan non-produksi dan menempatkan file kunci yang didownload di direktori ./service-accounts.
      Catatan: Jika Anda lebih memilih untuk membuat semua akun layanan individual untuk lingkungan produksi, gunakan perintah berikut:

      ./tools/create-service-account --env prod --dir ./service-accounts

      Untuk mengetahui informasi selengkapnya tentang akun layanan Google Cloud, lihat Membuat dan mengelola akun layanan.
   2. Perintah create-service-account menyimpan file JSON yang berisi kunci pribadi akun layanan. File disimpan di direktori yang sama tempat perintah dijalankan. Anda akan memerlukan jalur ke file ini pada langkah-langkah berikutnya.
2. Buka file overrides.yaml. Tetapkan parameter berikut, seperti yang ditunjukkan dalam Contoh mengganti file.
   1. Tetapkan parameter umum yang ditunjukkan di bawah dalam blok backup. Jika Anda telah menyetel parameter ini untuk solusi pencadangan hibrida non-CSI, Anda dapat menggunakan parameter yang sama untuk snapshot CSI Anda. Lihat tabel referensi properti pencadangan untuk mengetahui informasi selengkapnya tentang setiap nilai.
      

      Untuk backup:

      • enabled: Setel ke true untuk mengaktifkan pencadangan terjadwal.
      • pullPolicy dalam gambar: Tetapkan ke Always.
      • serviceAccountPath: Jalur ke akun layanan.
      • schedule: Berikan jadwal ekspresi cron.
   2. Tetapkan parameter ini untuk pencadangan khusus CSI:
      • Nilai grup penyimpanan Cassandra: Class penyimpanan Cassandra yang dikonfigurasi harus mendukung snapshot CSI agar pencadangan dan pemulihan CSI berfungsi. Untuk memeriksa apakah kelas penyimpanan mendukung snapshot CSI, jalankan perintah berikut untuk mendapatkan kelas penyimpanan yang tersedia:

        kubectl get sc

        Lihat output "Provisioner" untuk setiap class penyimpanan. Penyedia menggunakan CSI biasanya memiliki bagian ".csi." pada namanya seperti "pd.csi.storage.gke.io". Cari nama penyedia di daftar driver CSI Kubernetes ini. Jika kolom "Fitur Lainnya" untuk penyedia berisi kata "SNAPSHOT", maka class penyimpanan yang menggunakan penyedia tersebut mendukung snapshot CSI.

        Tambahkan parameter ini di grup penyimpanan. Kedua nilai wajib diisi.

        • storageclass: Nama class penyimpanan yang mendukung snapshot CSI.
        • kapasitas: Kapasitas disk.
      • Jenis penyedia cloud:

        Setelah kemampuan snapshot CSI diverifikasi, ubah file penggantian untuk menggunakan pencadangan dan pemulihan CSI:

        • cloudProvider: Tetapkan cloudProvider di backup dan restore ke CSI.

Contoh konfigurasi pencadangan

Bagian ini menunjukkan bagian terkait pencadangan dari contoh file overrides.yaml.

cassandra:
  hostNetwork: false
  replicaCount: 3
   storage:
    storageclass: standard-rwo
    capacity: 100Gi
  image:
     pullPolicy: Always

  backup:
   enabled: true
   image:
     pullPolicy: Always
   serviceAccountPath: "/Users/myuser/apigee-hybrid/hybrid-files/service-accounts/mycompany-hybrid-apigee-cassandra.json"
   cloudProvider: "CSI"
   schedule: "0 * * 11 *"

Mulai pencadangan manual

Cadangan CSI dibuat secara otomatis sesuai dengan jadwal cron yang ditetapkan dalam file overrides.yaml.

Untuk memulai pencadangan CSI manual, gunakan perintah ini:

kubectl create job -n apigee --from=cronjob/apigee-cassandra-backup backup-pod-name

dengan backup-pod-name adalah nama pod cadangan yang akan dibuat.

Memverifikasi pencadangan

Salah satu cara untuk memverifikasi bahwa cadangan berhasil dibuat adalah dengan memeriksa snapshot volume di cluster Kubernetes, menggunakan perintah ini:

kubectl get volumesnapshot -n apigee

Output akan menampilkan daftar snapshot saat ini di cluster. Proses pencadangan CSI membuat snapshot setiap disk Cassandra. Jumlah snapshot yang dibuat harus sama dengan jumlah total pod Cassandra dalam cluster.

Memulihkan cadangan

Gunakan proses ini untuk memulihkan cadangan CSI yang dibuat sebelumnya. Untuk mengetahui informasi umum tentang pemulihan cadangan dan ringkasan prosesnya, lihat halaman ringkasan pemulihan.

Untuk memulai pemulihan cadangan CSI, ikuti petunjuk untuk pemulihan satu wilayah non-CSI hibrida, tetapi gunakan nilai ini di blok restore dalam overrides.yaml Anda. Lihat tabel referensi properti pencadangan untuk mengetahui informasi selengkapnya tentang setiap nilai dan contoh konfigurasi pemulihan untuk melihat contohnya.

• enabled: Disetel ke true untuk mengaktifkan pemulihan untuk cadangan yang dirujuk dengan stempel waktu snapshotTimestamp.
• snapshotTimestamp: Berikan stempel waktu cadangan CSI sebelumnya.
• serviceAccountPath: Jalur ke akun layanan.
• pullPolicy dalam gambar: Tetapkan ke Always.

Untuk menemukan nilai snapshotTimestamp yang akan dipulihkan, jalankan perintah ini untuk mendapatkan daftar snapshot yang tersedia:

kubectl get volumesnapshot -n apigee

Dalam daftar yang ditampilkan, nama snapshot berisi stempel waktu:

pvc-us-west2-b-20220803004907-47beff0e306d8861

Dalam contoh ini, stempel waktunya adalah 20220803004907.

Penting: Menghentikan cluster Cassandra adalah bagian normal dari proses pemulihan CSI. Setelah menghentikan cluster, proses pemulihan akan membuat PVC baru yang berisi data cadangan, lalu membuat ulang cluster Cassandra menggunakan PVC baru. Jangan khawatir jika Anda melihat cluster dihentikan.

Contoh konfigurasi pemulihan

Bagian ini menunjukkan bagian terkait pemulihan dari contoh file overrides.yaml.

cassandra:
  hostNetwork: false
  replicaCount: 3
   storage:
    storageclass: standard-rwo
    capacity: 100Gi
  image:
     pullPolicy: Always

  restore:
    enabled: true
    snapshotTimestamp: "20220908222130"
    serviceAccountPath: "/Users/myuser/apigee-hybrid/hybrid-files/service-accounts/mycompany-hybrid-apigee-cassandra.json"
    cloudProvider: "CSI"
    image:
      pullPolicy: Always

Bermigrasi ke pencadangan dan pemulihan CSI

Jika sebelumnya Anda belum pernah menggunakan pencadangan dan pemulihan hybrid, Anda dapat mengikuti petunjuk di Menyiapkan pencadangan CSI untuk membuat pencadangan CSI baru tanpa langkah-langkah di bagian ini. Langkah-langkah ini akan memandu Anda melakukan migrasi dari solusi pencadangan dan pemulihan non-CSI ke pencadangan CSI.

1. Buat cadangan baru menggunakan metode pencadangan non-CSI yang saat ini dikonfigurasi.
2. Ubah konfigurasi pencadangan dalam file overrides.yaml hybrid untuk menggunakan penggantian pencadangan CSI seperti yang ditunjukkan dalam contoh konfigurasi pencadangan.
3. Terapkan perubahan dalam file overrides.yaml:
   

   $APIGEECTL_HOME/apigeectl apply -f YOUR_OVERRIDES_FILE

4. Verifikasi tugas pencadangan:
   

   kubectl get cronjob -n apigee

5. Setelah tugas pencadangan selesai, verifikasi bahwa snapshot telah dibuat. Jumlah snapshot yang dibuat harus sama dengan jumlah node Cassandra dalam instance Hybrid.
   

   kubectl get volumesnapshot -n apigee