Halaman ini menjelaskan cara memulihkan atau memulihkan Cassandra di beberapa region.
Dalam deployment multi-region, Apigee hybrid di-deploy di beberapa lokasi geografis di seluruh pusat data yang berbeda. Jika satu atau beberapa region gagal, tetapi region yang sehat tetap ada, Anda dapat menggunakan region yang sehat untuk memulihkan region Cassandra yang gagal dengan data terbaru.
Jika terjadi kegagalan besar di semua region hybrid, Cassandra dapat dipulihkan. Penting untuk diperhatikan bahwa, jika Anda memiliki beberapa organisasi Apigee dalam deployment, proses pemulihan akan memulihkan data untuk semua organisasi. Dalam penyiapan multi-organisasi, hanya memulihkan organisasi tertentu tidak didukung.
Topik ini menjelaskan kedua pendekatan untuk menyelamatkan region yang gagal:
- Memulihkan region yang gagal - Menjelaskan langkah-langkah untuk memulihkan region yang gagal berdasarkan region yang responsif.
- Memulihkan region yang gagal - Menjelaskan langkah-langkah untuk memulihkan region yang gagal dari cadangan. Pendekatan ini hanya diperlukan jika semua region campuran terpengaruh.
Memulihkan wilayah yang gagal
Untuk memulihkan region yang gagal dari region yang sehat, lakukan langkah-langkah berikut:
- Alihkan traffic API dari region yang terpengaruh ke region yang berfungsi dengan baik. Rencanakan kapasitas yang sesuai untuk mendukung traffic yang dialihkan dari region yang gagal.
- Nonaktifkan region yang terpengaruh. Untuk setiap region yang terpengaruh, ikuti langkah-langkah yang diuraikan di Menonaktifkan region hybrid. Tunggu hingga penghentian layanan selesai sebelum melanjutkan ke langkah berikutnya.
- Pulihkan region yang terpengaruh. Untuk memulihkan, buat region baru, seperti yang dijelaskan dalam Deployment multi-region di GKE, GKE on-prem, dan AKS.
Memulihkan dari cadangan
Pencadangan Cassandra dapat berada di Cloud Storage atau di server jarak jauh berdasarkan konfigurasi Anda. Untuk memulihkan Cassandra dari cadangan, lakukan langkah-langkah berikut:
- Buka file penggantian untuk region yang ingin Anda pulihkan.
- Tetapkan
cassandra:hostNetwork
kefalse
. - Terapkan file penggantian:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace APIGEE_NAMESPACE \ -f OVERRIDES_FILE
- Sebelum melanjutkan, pastikan
hostNetwork
disetel kefalse
:kubectl -n APIGEE_NAMESPACE get apigeeds -o=jsonpath='{.items[].spec.components.cassandra.hostNetwork}'
- Hapus hybrid dari wilayah yang Anda pulihkan:
helm delete DATASTORE_RELEASE_NAME \ --namespace APIGEE_NAMESPACE
Dengan DATASTORE_RELEASE_NAME adalah nama rilis datastore tempat Anda menginstal Cassandra di region, misalnya
datastore-region1
. -
Pulihkan region yang diinginkan dari cadangan. Untuk informasi selengkapnya, lihat Memulihkan region dari cadangan.
- Hapus referensi region yang dihapus dan tambahkan referensi region yang dipulihkan dalam
metadata
KeySpaces
. - Dapatkan nama pusat data cassandra menggunakan opsi
nodetool status
.kubectl exec -n APIGEE_NAMESPACE -it apigee-cassandra-default-0 -- bash nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status |grep -i Datacenter
dengan:
- APIGEE_JMX_USER adalah nama pengguna untuk pengguna operasi JMX Cassandra. Digunakan untuk melakukan autentikasi dan berkomunikasi dengan antarmuka JMX Cassandra. Lihat
cassandra:auth:jmx:username
. - APIGEE_JMX_PASSWORD adalah sandi untuk pengguna operasi JMX Cassandra.
Lihat
cassandra:auth:jmx:password
.
- APIGEE_JMX_USER adalah nama pengguna untuk pengguna operasi JMX Cassandra. Digunakan untuk melakukan autentikasi dan berkomunikasi dengan antarmuka JMX Cassandra. Lihat
- Perbarui replikasi
KeySpaces
.- Buat penampung klien dan hubungkan ke cluster Cassandra melalui antarmuka CQL.
- Dapatkan daftar ruang kunci pengguna dari antarmuka CQL:
cqlsh CASSANDRA_SEED_HOST -u APIGEE_DDL_USER -p APIGEE_DDL_PASSWORD --ssl -e "select keyspace_name from system_schema.keyspaces;"|grep -v system
dengan:
- CASSANDRA_SEED_HOST adalah host seed multi-region Cassandra. Untuk sebagian besar penginstalan multi-region, gunakan alamat IP host di region pertama Anda. Lihat
Mengonfigurasi Apigee
hybrid untuk multi-region dan
cassandra:externalSeedHost
. - APIGEE_DDL_USER dan APIGEE_DDL_PASSWORD adalah nama pengguna dan sandi admin untuk pengguna Cassandra Data Definition Language (DDL). Nilai defaultnya adalah "
ddl_user
" dan "iloveapis123
".Lihat
cassandra.auth.ddl.password
dalam referensi Properti konfigurasi dan Opsi Command Line dalam dokumentasi cqlsh Apache Cassandra.
- CASSANDRA_SEED_HOST adalah host seed multi-region Cassandra. Untuk sebagian besar penginstalan multi-region, gunakan alamat IP host di region pertama Anda. Lihat
Mengonfigurasi Apigee
hybrid untuk multi-region dan
- Untuk setiap ruang kunci, jalankan perintah berikut dari antarmuka CQL untuk memperbarui setelan replikasi:
ALTER KEYSPACE KEYSPACE_NAME WITH replication = {'class': 'NetworkTopologyStrategy', 'DATACENTER_NAME':3};
dengan:
- KEYSPACE_NAME adalah nama ruang kunci yang tercantum dalam output langkah sebelumnya.
- DATACENTER_NAME adalah nama datacenter Cassandra yang Anda peroleh dengan opsi
nodetool status
di langkah 8.