Memulihkan di beberapa wilayah

Halaman ini menjelaskan cara memulihkan atau memulihkan Cassandra di beberapa region.

Dalam deployment multi-region, Apigee Hybrid di-deploy di beberapa lokasi geografis di berbagai pusat data. 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 fatal 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, pemulihan organisasi tertentu saja tidak didukung.

Topik ini menjelaskan kedua pendekatan untuk menyelamatkan wilayah yang gagal:

Memulihkan region yang gagal - Menjelaskan langkah-langkah untuk memulihkan region yang gagal berdasarkan region yang sehat.
Memulihkan region yang gagal - Menjelaskan langkah-langkah untuk memulihkan region yang gagal dari cadangan. Pendekatan ini hanya diperlukan jika semua region hybrid terpengaruh.

Memulihkan region yang gagal

Untuk memulihkan region yang gagal dari region yang sehat, lakukan langkah-langkah berikut:

Alihkan traffic API dari region yang terpengaruh ke region kerja yang baik. Rencanakan kapasitas yang sesuai untuk mendukung traffic yang dialihkan dari region yang gagal.
Menonaktifkan wilayah yang terpengaruh. Untuk setiap wilayah yang terpengaruh, ikuti langkah-langkah yang dijelaskan dalam Menonaktifkan region hybrid. Tunggu hingga penonaktifan selesai sebelum melanjutkan ke langkah berikutnya.
Pulihkan wilayah yang terpengaruh. Untuk memulihkan, buat region baru, seperti yang dijelaskan dalam Deployment multi-region di GKE, GKE lokal, dan AKS.

Memulihkan dari cadangan

Catatan: 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, dan mempertahankan cluster. Cluster tersebut akan berisi datastore Apigee (Cassandra) yang sudah ada, yang dapat Anda gunakan untuk pemecahan masalah. Buat cluster Kubernetes baru, lalu pulihkan Cassandra di cluster baru tersebut.

Cadangan Cassandra dapat berada di Cloud Storage atau di server jarak jauh berdasarkan konfigurasi Anda. Untuk memulihkan Cassandra dari cadangan, lakukan langkah-langkah berikut:

Penting: Jika menginstal Apigee Hybrid ke beberapa region, Anda harus memeriksa file penggantian untuk region yang Anda pulihkan guna memastikan cassandra:hostNetwork disetel ke false sebelum Anda melakukan pemulihan. Untuk memeriksa setelan hostNetwork di wilayah yang Anda coba pulihkan, gunakan perintah ini:

kubectl -n apigee get apigeeds -o=jsonpath='{.items[].spec.components.cassandra.hostNetwork}'

Buka file penggantian untuk wilayah yang ingin dipulihkan.
Tetapkan cassandra:hostNetwork ke false.

Terapkan file penggantian:

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

Sebelum melanjutkan, pastikan hostNetwork disetel ke false:

kubectl -n apigee get apigeeds -o=jsonpath='{.items[].spec.components.cassandra.hostNetwork}'

Hapus campuran dari region yang Anda pulihkan:
```
helm delete DATASTORE_RELEASE_NAME \
  --namespace apigee
```
Dengan DATASTORE_RELEASE_NAME adalah nama rilis datastore tempat Anda menginstal Cassandra di region, misalnya datastore-region1.

Catatan: Berhati-hatilah dengan rilis komponen datastore yang Anda hapus. Anda dapat melihat rilis dengan perintah helm -n apigee ls.
Memulihkan region yang diinginkan dari cadangan. Untuk informasi selengkapnya, lihat Memulihkan region dari cadangan.
Hapus referensi wilayah yang dihapus dan tambahkan referensi wilayah yang dipulihkan dalam metadata KeySpaces.
Dapatkan nama pusat data cassandra dengan menggunakan opsi nodetool status.
```
kubectl exec -n apigee -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 Cassandra JMX. Digunakan untuk mengautentikasi dan berkomunikasi dengan antarmuka Cassandra JMX. Lihat cassandra:auth:jmx:username.
- APIGEE_JMX_PASSWORD adalah sandi untuk pengguna operasi Cassandra JMX. Lihat cassandra:auth:jmx:password.
Update replikasi KeySpaces.
1. Buat container klien dan hubungkan ke cluster Cassandra melalui antarmuka CQL.
2. Mendapatkan daftar keyspace 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".
    Anda dapat memeriksa nama pengguna dan sandi DDL dengan memeriksa nilai yang tersimpan dalam apigee-datastore-default-credssecret. Anda harus memiliki hak istimewa admin untuk memeriksa rahasia ini. Perintah berikut akan menampilkan nilai yang dienkode base-64 untuk nama pengguna dan sandi DDL:
```
kubectl get secret apigee-datastore-default-creds -n apigee -o yaml
```
    Lihat cassandra.auth.ddl.password dalam referensi Properti konfigurasi dan Opsi Command Line dalam dokumentasi Apache Cassandra cqlsh.
3. Untuk setiap keyspace, 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 keyspace yang tercantum dalam output langkah sebelumnya.
  - DATACENTER_NAME adalah nama pusat data Cassandra yang Anda peroleh dengan opsi nodetool status di langkah 8.