Memulihkan deployment region tunggal

Halaman ini menjelaskan cara memulihkan Cassandra di satu region.

Dalam deployment region tunggal, Apigee hybrid di-deploy di satu pusat data atau region. Jika Anda memiliki beberapa organisasi Apigee dalam deployment, proses pemulihan akan memulihkan data untuk semua organisasi. Dalam penyiapan multi-organisasi, Anda tidak dapat memulihkan organisasi tertentu.

Memulihkan region dari cadangan

Dalam konfigurasi Anda, pencadangan Cassandra dapat berada di Cloud Storage atau di server jarak jauh. Dalam kedua kasus tersebut, lakukan langkah-langkah berikut untuk memulihkan:

  1. Verifikasi versi campuran. 
    apigeectl version
     Pastikan versinya sama dengan versi yang membuat file cadangan di penyimpanan.
  2. Pastikan cluster Kubernetes tempat Anda melakukan pemulihan tidak memiliki penginstalan hibrida Apigee sebelumnya. Jika Anda memulihkan ke cluster yang ada, gunakan perintah berikut untuk menghapus penginstalan hibrida Apigee yang ada: 
    apigeectl delete --all -f overrides.yaml
  3. Buka file overrides.yaml dan tetapkan properti restore ke nilai yang diinginkan:

    Parameter

    namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster.
cassandra:
  ...
  restore:
    enabled: true
    keyFile: "PATH_TO_PRIVATE_KEY_FILE"
    server: "BACKUP_SERVER_IP"
    storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
    cloudProvider: "HYBRID"  # required verbatim "HYBRID" (all caps)
    snapshotTimestamp: "TIMESTAMP"
  ...
  backup:
    enabled: true
    keyFile: "PATH_TO_PRIVATE_KEY_FILE"
    server: "BACKUP_SERVER_IP"
    storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
    cloudProvider: "HYBRID" # required verbatim "HYBRID" (all caps)
    schedule: "SCHEDULE"

    Contoh

    namespace: apigee
cassandra:
...
  restore:
    enabled: true
    keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
    server: "34.56.78.90"
    storageDirectory: "/home/apigee/cassbackup"
    cloudProvider: "HYBRID"
    snapshotTimestamp: "20201001183903"
  ...
  backup:
    enabled: true
    keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
    server: "34.56.78.90"
    storageDirectory: "/home/apigee/cassbackup"
    cloudProvider: "HYBRID"
    schedule: "0 2 * * *"
  ...

    Dengan keterangan:

    Properti Deskripsi
    namespace

    YOUR_RESTORE_NAMESPACE

    Namespace untuk pemulihan. Gunakan namespace seperti di cluster asli Anda.
    restore:enabled Pemulihan dinonaktifkan secara default. Anda harus menetapkan properti ini ke true.
    restore:keyFile

    PATH_TO_PRIVATE_KEY_FILE

    Jalur di sistem file lokal Anda ke file kunci pribadi SSH (bernama ssh_key di langkah saat Anda membuat pasangan kunci SSH).
    restore:server

    BACKUP_SERVER_IP

    Alamat IP server cadangan Anda.
    restore:storageDirectory

    BACKUP_DIRECTORY

    Nama direktori cadangan di server cadangan Anda. Ini harus berupa direktori dalam home/apigee (direktori cadangan bernama cassandra_backup di langkah saat Anda membuat direktori cadangan).
    restore:cloudProvider

    HYBRID

    Properti cloudProvider: "HYBRID" wajib diisi.
    restore:snapshotTimestamp

    TIMESTAMP

    Stempel waktu snapshot cadangan yang akan dipulihkan. Untuk memeriksa stempel waktu yang dapat digunakan, buka dbStorageBucket dan lihat file yang ada di bucket. Setiap nama file berisi nilai stempel waktu. Misalnya, backup_20210203213003_apigee-cassandra-default-0.tgz

    Dengan 20210203213003 adalah nilai snapshotTimestamp yang akan Anda gunakan jika ingin memulihkan cadangan yang dibuat pada waktu tersebut.

    backup:enabled Pencadangan dinonaktifkan secara default. Anda harus menetapkan properti ini ke true.
    backup:keyFile

    PATH_TO_PRIVATE_KEY_FILE

    Jalur di sistem file lokal Anda ke file kunci pribadi SSH (bernama ssh_key di langkah saat Anda membuat pasangan kunci SSH).
    backup:server

    BACKUP_SERVER_IP

    Alamat IP server cadangan Anda.
    backup:storageDirectory

    BACKUP_DIRECTORY

    Nama direktori cadangan di server cadangan Anda. Ini harus berupa direktori dalam home/apigee (direktori cadangan bernama cassandra_backup di langkah saat Anda membuat direktori cadangan).
    backup:cloudProvider

    HYBRID

    Properti cloudProvider: "HYBRID" wajib diisi.
    backup:schedule

    SCHEDULE

    Waktu saat pencadangan dimulai, yang ditentukan dalam sintaksis crontab standar. Default: 0 2 * * *
  4. Buat deployment runtime hybrid baru. Tindakan ini akan membuat cluster Cassandra baru dan mulai memulihkan data cadangan ke cluster: 
    ${APIGEECTL_HOME}/apigeectl init  -f overrides/overrides.yaml
     
    ${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
     
    ${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --restore
     
    ${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
  5. Verifikasi progres tugas pemulihan dan pastikan apigeeds dan semua pod lainnya sudah aktif:
    • Untuk memeriksa apigeeds: 
      kubectl get apigeeds -n apigee
    • Untuk memeriksa semua pod lainnya: 
      kubectl get pods -n apigee

Setelah pemulihan berhasil diselesaikan dan konfirmasi bahwa komponen runtime berfungsi dengan baik, sebaiknya konfigurasikan pencadangan di cluster:

  1. Hapus konfigurasi restore dari file overrides-restore.yaml.
  2. Tambahkan konfigurasi backup ke file overrides-restore.yaml.
  3. Terapkan konfigurasi backup dengan perintah berikut: 
    ./apigeectl apply -f ../overrides-restore.yaml