Bagian ini membahas cara mengonfigurasi pencadangan dan pemulihan database Cassandra Anda menggunakan ssh
dan sistem file Anda, bukan menggunakan Google Cloud. Lihat juga:
Apa itu pencadangan dan pemulihan Cassandra dengan penyimpanan kustom?
Pencadangan dengan penyimpanan kustom menyimpan cadangan database Cassandra Anda ke file terkompresi dalam sistem file server yang Anda tentukan. Pencadangan dilakukan sesuai jadwal yang Anda tentukan dalam file penggantian. Koneksi ke server dilakukan melalui SSH aman.
Menyiapkan pencadangan tanpa Layanan Cloud
Langkah-langkah berikut mencakup contoh umum untuk menyelesaikan tugas tertentu, seperti membuat pasangan kunci SSH. Gunakan metode yang sesuai dengan penginstalan Anda.
Prosedur ini memiliki bagian-bagian berikut:
Menyiapkan server dan SSH
- Tetapkan server Linux atau Unix untuk cadangan Anda. Server ini harus dapat dijangkau menggunakan SSH dari bidang runtime hybrid Apigee Anda. Ruang penyimpanan harus memiliki penyimpanan yang cukup untuk cadangan Anda.
- Siapkan server SSH di server, atau pastikan server tersebut memiliki server SSH aman yang telah dikonfigurasi.
- Buat pasangan kunci SSH dan simpan file kunci pribadi di jalur yang dapat diakses dari bidang runtime hybrid Anda. Anda harus menggunakan sandi kosong untuk pasangan kunci atau cadangan akan gagal. Contoh:
ssh-keygen -t rsa -b 4096 -C exampleuser@example.com
Enter file in which to save the key (/Users/exampleuser/.ssh/id_rsa): $APIGEE_HOME/hybrid-files/certs/ssh_key Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in ssh_key Your public key has been saved in ssh_key.pub The key fingerprint is: SHA256:DWKo334XMZcZYLOLrd/8HNpjTERPJJ0mc11UYmrPvSA exampleuser@example.com The key's randomart image is: +---[RSA 4096]----+ | +. ++X| | . . o.=.*+| | . o . . o==o | | . . . =oo+o...| | . S +E oo .| | . . .. . o .| | . . . . o.. | | . ...o ++. | | .. .. +o+. | +----[SHA256]-----+ - Buat akun pengguna di server pencadangan dengan nama
apigee
. Pastikan penggunaapigee
baru memiliki direktori utama di bawah/home
. - Di server pencadangan, buat direktori
ssh
di direktori/home/apigee
baru. - Salin kunci publik (
ssh_key.pub
pada contoh sebelumnya) ke dalam file bernamaauthorized_keys
di direktori/home/apigee/ssh
baru. Contoh:cd /home/apigee
mkdir .ssh
cd .ssh
vi authorized_keys
- Di server pencadangan, buat direktori pencadangan dalam direktori
/home/apigee/
. Direktori cadangan dapat berupa direktori apa pun selama penggunaapigee
memiliki akses ke direktori tersebut. Contoh:cd /home/apigee
mkdir cassandra-backup
- Uji koneksi. Anda perlu memastikan bahwa pod Cassandra dapat terhubung ke server cadangan menggunakan SSH:
- Login ke shell pod Cassandra Anda. Contoh:
kubectl exec -it -n apigee APIGEE_CASSANDRA_DEFAULT_0 -- /bin/bash
Dengan APIGEE_CASSANDRA_DEFAULT_0 adalah nama pod Cassandra. Ubah ini menjadi nama pod yang ingin Anda hubungkan.
- Hubungkan melalui SSH ke server cadangan Anda, menggunakan alamat IP server:
ssh apigee@BACKUP_SERVER_IP
- Login ke shell pod Cassandra Anda. Contoh:
Menetapkan jadwal dan tujuan untuk pencadangan
Anda menetapkan jadwal dan tujuan pencadangan dalam file overrides.yaml
.
- Tambahkan parameter berikut ke file
overrides.yaml
Anda:Parameter
cassandra: 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
cassandra: 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 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
pada 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. Direktori ini harus berupa direktori di dalam
home/apigee
(direktori cadangan diberi namacassandra_backup
pada 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 * * *
- Gunakan
apigeectl
untuk menerapkan konfigurasi cadangan ke cakupan penyimpanan cluster Anda:$APIGEECTL_HOME/apigeectl --datastore -f YOUR_OVERRIDES_FILE
Dengan YOUR_OVERRIDES_FILE adalah jalur ke file penggantian yang baru saja Anda edit.
Mengonfigurasi pemulihan
Pemulihan mengambil data Anda dari lokasi cadangan dan memulihkan data tersebut ke cluster Cassandra baru dengan jumlah node yang sama. Tidak ada data yang diambil dari cluster Cassandra lama.
Petunjuk pemulihan di bawah ini ditujukan untuk deployment region tunggal yang tidak menggunakan Google Cloud Storage untuk pencadangan. Untuk deployment lainnya, lihat referensi berikut:
- Untuk deployment region tunggal yang menggunakan Google Cloud Storage untuk pencadangan, lihat Pencadangan dan pemulihan Cassandra.
- Untuk deployment multi-region, lihat Deployment multi-region di GKE dan GKE secara lokal.
Untuk memulihkan cadangan Cassandra:
- Membuat namespace baru dalam cluster Kubernetes yang ada yang akan digunakan untuk memulihkan deployment hybrid huntime. Jangan gunakan nama namespace asli untuk namespace baru. Jangan gunakan namespace lama untuk pemulihan.
-
Di direktori penginstalan root hybrid, buat file
overrides-restore.yaml
baru. -
Salin konfigurasi Cassandra lengkap dari file
overrides.yaml
asli ke fileoverrides-restore.yaml
baru. Contoh:cp ./overrides.yaml ./overrides-restore.yaml
- Tambahkan elemen namespace ke file
overrides-restore.yaml
baru.Parameter
namespace: YOUR_RESTORE_NAMESPACE 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: "BACKUP_TO_RESTORE" ...
Contoh
namespace: cassandra-restore 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"
- Ubah label
app
pada node Cassandra mana pun di namespace lama dengan menjalankan perintah berikut:kubectl label pods --overwrite --namespace=OLD_NAMESPACE -l app=apigee-cassandra app=apigee-cassandra-old
- Membuat deployment runtime hybrid baru. Tindakan ini akan membuat cluster Cassandra baru dan mulai
memulihkan data cadangan ke dalam cluster:
./apigeectl init -f ../overrides-restore.yaml
./apigeectl apply -f ../overrides-restore.yaml
-
Setelah pemulihan selesai, traffic harus dialihkan untuk menggunakan cluster Cassandra di namespace baru. Jalankan perintah berikut untuk mengalihkan traffic:
kubectl get rs -n OLD_NAMESPACE # look for the 'apigee-connect' replicaset
kubectl patch rs -n OLD_NAMESPACE APIGEE_CONNECT_RS_NAME -p '{"spec":{"replicas" : 0}}'
- Setelah pengalihan traffic selesai, Anda dapat mengonfigurasi ulang cadangan di cluster yang dipulihkan dengan menghapus konfigurasi
restore
dan menambahkan konfigurasibackup
ke fileoverrides-restore.yaml
. Ganti YOUR_RESTORE_NAMESPACE dengan nama namespace baru yang dibuat di langkah 1.namespace: YOUR_RESTORE_NAMESPACE cassandra: ... backup: enabled: true serviceAccountPath: SA_JSON_FILE_PATH dbStorageBucket: CLOUD_STORAGE_BUCKET_PATH schedule: BACKUP_SCHEDULE_CODE ...
Lalu, terapkan konfigurasi
backup
dengan perintah berikut:./apigeectl apply -f ../overrides-restore.yaml
Dengan keterangan:
Properti | Deskripsi |
---|---|
namespace |
YOUR_RESTORE_NAMESPACE Nama namespace baru yang Anda buat di langkah 1 untuk cluster Cassandra baru. Jangan gunakan namespace yang sama dengan yang digunakan untuk 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 |
restore:server |
BACKUP_SERVER_IP Alamat IP server cadangan Anda. |
restore:storageDirectory |
BACKUP_DIRECTORY Nama direktori cadangan di server cadangan Anda.
Direktori ini harus berupa direktori di dalam
|
restore:cloudProvider |
Properti |
restore:snapshotTimestamp |
BACKUP_TO_RESTORE Cadangan spesifik yang ingin Anda pulihkan, ditentukan dalam sintaksis crontab standar (karakter pengganti tidak diizinkan). |