Memulihkan di satu region

Anda saat ini melihat versi 1.11 dokumentasi Apigee hybrid. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.11 

   Versi yang didukung:

• v1.13 (terbaru)                        
• v1.12                         
• v1.11                         
• Daftar versi yang didukung

   Versi yang tidak didukung:

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

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.

Catatan: Sebelum Anda mulai memulihkan satu region, pertimbangkan apakah langkah-langkah prasyarat berikut berlaku:

• Jika ingin mempertahankan penyiapan yang ada untuk pemecahan masalah dan analisis akar masalah (RCA), Anda harus menghapus semua komponen org dan env dari cluster Kubernetes kecuali pengontrol Apigee, lalu mempertahankan cluster. Cluster akan berisi datastore Apigee (Cassandra) yang ada yang dapat Anda gunakan untuk memecahkan masalah. Buat cluster Kubernetes baru, lalu pulihkan Cassandra di cluster baru.
• Jika penginstalan campuran Anda disiapkan dengan beberapa organisasi, dapatkan file penggantian untuk setiap organisasi sebelum melanjutkan pemulihan di satu wilayah. Anda dapat menambahkan konfigurasi pemulihan seperti yang dijelaskan di Langkah 3 ke salah satu file penggantian. Jangan tambahkan konfigurasi pemulihan ke file penggantian lainnya.

Memulihkan region dari cadangan

Pilih petunjuk di bawah untuk alat pengelolaan yang Anda gunakan untuk Apigee hybrid:

Helm

1. Perbarui detail pemulihan Cassandra dalam file overrides.yaml:

   namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.
   cassandra:
     hostNetwork: false
     ...
     restore:
       enabled: true
       serviceAccountPath: "SA_JSON_FILE_PATH"
       dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
       cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
       snapshotTimestamp: "TIMESTAMP"
     ...
     backup:
      enabled: false
     ...

   Dengan keterangan:

   Properti	Deskripsi
   namespace	YOUR_RESTORE_NAMESPACE Namespace untuk pemulihan. Gunakan namespace yang sama seperti di cluster asli Anda.
   cassandra:hostNetwork	hostNetwork diperlukan dan harus selalu ditetapkan ke false.
   restore:enabled	Pemulihan dinonaktifkan secara default. Anda harus menetapkan properti ini ke true.
   restore:serviceAccountPath	SA_JSON_FILE_PATH Jalur di sistem file Anda ke akun layanan yang Anda buat untuk pencadangan.
   restore:dbStorageBucket	CLOUD_STORAGE_BUCKET_PATH Jalur bucket Cloud Storage tempat data cadangan Anda disimpan dalam format berikut: gs://BUCKET_NAME. gs:// wajib diisi.
   restore:cloudProvider	GCP Properti cloudProvider: "GCP" 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	Anda harus menetapkan properti ini ke false jika sebelumnya ditetapkan ke true. Catatan: Pencadangan tidak boleh diaktifkan saat memulihkan jika Anda menggunakan Helm. Setelan ini bersifat opsional jika Anda menggunakan apigeectl.

   Catatan: Jika Anda menggunakan pencadangan CSI, ikuti contoh konfigurasi pemulihan dalam dokumentasi pencadangan dan pemulihan CSI.

2. Jika Anda tidak memiliki cluster bersih untuk memulai, ikuti dokumentasi Menonaktifkan region hybrid untuk helm untuk mengubah penginstalan Hybrid yang ada ke status bersih (Anda dapat membiarkan Cert Manager diinstal). Tindakan ini akan membawa Anda ke status yang sama seolah-olah Anda telah mengikuti panduan penyiapan runtime Helm hingga awal Langkah 11.

3. Pastikan tidak ada pod yang tersisa di namespace Apigee:

   kubectl get pods -n apigee
           kubectl get pods -n apigee-system

4. Jika Anda menggunakan pencadangan CSI, pastikan Anda dapat melihat volumesnapshot yang ingin digunakan untuk proses pemulihan dengan menjalankan:

   kubectl get volumesnapshot -n apigee
             

5. Instal semua komponen Hybrid satu per satu seperti yang dijelaskan dalam Langkah 11 pada manual penginstalan. Perhatikan bahwa pod apigee-cassandra-restore akan dibuat setelah Anda menjalankan perintah untuk menginstal datastore, tetapi pod tersebut hanya akan berstatus running setelah Anda menginstal komponen apigee-org.

   Penting: Hapus tanda ‑‑atomic untuk semua perintah upgrade untuk cluster yang dimigrasikan.

Lihat Ringkasan pencadangan Cassandra untuk mengetahui detail selengkapnya tentang pencadangan dan pemulihan Cassandra.

apigeectl

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.
   Tips: Jalankan setiap perintah apigeectl dengan flag --dry-run=true terlebih dahulu untuk memeriksa apakah ada error apigeectl.
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 -f overrides.yaml
   kubectl -n apigee get apigeedatastore,apigeeredis,apigeetelemetry,org,env,arc # The output should be empty.
   apigeectl delete --all -f overrides.yaml

3. Buka file overrides.yaml dan tetapkan properti restore ke nilai yang diinginkan:

   Cloud Storage

   Parameter

   namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.
   cassandra:
     hostNetwork: false
     ...
     restore:
       enabled: true
       serviceAccountPath: "SA_JSON_FILE_PATH"
       dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
       cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
       snapshotTimestamp: "TIMESTAMP"
     ...
     backup:
       enabled: false
       serviceAccountPath: "SA_JSON_FILE_PATH"
       dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
       cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
       schedule: "SCHEDULE"

   Contoh

   namespace: apigee
   cassandra:
     hostNetwork: false
     ...
     restore:
       enabled: true
       serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
       dbStorageBucket: "gs://myname-cassandra-backup"
       cloudProvider: "GCP"
       snapshotTimestamp: "20201001183903"
   
     ...
     backup:
       enabled: false
       serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
       dbStorageBucket: "gs://myname-cassandra-backup"
       cloudProvider: "GCP"
       schedule: "0 2 * * *"
     ...

   Dengan keterangan:

   Properti	Deskripsi
   namespace	YOUR_RESTORE_NAMESPACE Namespace untuk pemulihan. Gunakan namespace yang sama seperti di cluster asli Anda.
   cassandra:hostNetwork	hostNetwork diperlukan dan harus selalu ditetapkan ke false.
   restore:enabled	Pemulihan dinonaktifkan secara default. Anda harus menetapkan properti ini ke true.
   restore:serviceAccountPath	SA_JSON_FILE_PATH Jalur di sistem file Anda ke akun layanan yang Anda buat untuk pencadangan.
   restore:dbStorageBucket	CLOUD_STORAGE_BUCKET_PATH Jalur bucket Cloud Storage tempat data cadangan Anda disimpan dalam format berikut: gs://BUCKET_NAME. gs:// wajib diisi.
   restore:cloudProvider	GCP Properti cloudProvider: "GCP" 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	Anda harus menetapkan properti ini ke false jika sebelumnya ditetapkan ke true. Catatan: Pencadangan tidak boleh diaktifkan saat memulihkan jika Anda menggunakan Helm. Setelan ini bersifat opsional jika Anda menggunakan apigeectl.
   backup:serviceAccountPath	SA_JSON_FILE_PATH Jalur di sistem file Anda ke file JSON akun layanan yang didownload saat Anda menjalankan ./tools/create-service-account
   backup:dbStorageBucket	CLOUD_STORAGE_BUCKET_PATH Jalur bucket Cloud Storage dalam format ini: gs://BUCKET_NAME. gs:// wajib diisi.
   backup:cloudProvider	GCP Properti cloudProvider: "GCP" wajib diisi.
   backup:schedule	SCHEDULE Waktu saat pencadangan dimulai, yang ditentukan dalam sintaksis crontab standar. Default: 0 2 * * * Catatan: Hindari menjadwalkan pencadangan yang dimulai dalam waktu singkat setelah Anda menerapkan konfigurasi pencadangan ke cluster. Saat Anda menerapkan konfigurasi pencadangan, Kubernetes akan membuat ulang node Cassandra. Jika pencadangan dimulai sebelum node dimulai ulang (mungkin beberapa menit), pencadangan akan gagal.

   Penyimpanan Non-Cloud

   Parameter

     namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.
     cassandra:
       hostNetwork: false
       ...
       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: false
         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:
       hostNetwork: false
       ...
       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: false
         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 nama yang sama seperti di cluster asli Anda.
   cassandra:hostNetwork	hostNetwork diperlukan dan harus selalu ditetapkan ke false.
   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	Anda harus menetapkan properti ini ke false jika sebelumnya telah ditetapkan ke true. Catatan: Pencadangan tidak boleh diaktifkan saat memulihkan jika Anda menggunakan Helm. Setelan ini bersifat opsional jika Anda menggunakan apigeectl.
   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 * * * Catatan: Hindari menjadwalkan pencadangan yang dimulai dalam waktu singkat setelah Anda menerapkan konfigurasi pencadangan ke cluster. Saat Anda menerapkan konfigurasi pencadangan, Kubernetes akan membuat ulang node Cassandra. Jika pencadangan dimulai sebelum node dimulai ulang (mungkin beberapa menit), pencadangan akan gagal.

   Catatan: Apigee memulihkan Cassandra dari pencadangan Cloud Storage atau pencadangan server jarak jauh berdasarkan konfigurasi backup dalam file overrides.yaml.
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

Verifikasi progres tugas pemulihan dan konfirmasi bahwa apigeeds dan semua pod lainnya sudah aktif:

1. Periksa apigeeds:

   kubectl get apigeeds -n apigee

2. Periksa 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:

   Helm

   helm upgrade datastore apigee-datastore/ \
   --install \
   --namespace apigee \
   --atomic \
   -f overrides.yaml

   apigeectl

   ./apigeectl apply -f ../overrides.yaml