Menjadwalkan pencadangan di server jarak jauh

Version 1.12 (upcoming)

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 menjadwalkan pencadangan untuk Cassandra tanpa Cloud Storage. Dalam metode ini, cadangan disimpan di server jarak jauh yang Anda tentukan, bukan bucket Cloud Storage. Apigee menggunakan SSH untuk berkomunikasi dengan server jarak jauh.

Anda harus menjadwalkan pencadangan sebagai tugas cron. Setelah jadwal pencadangan diterapkan ke cluster hybrid Anda, tugas pencadangan Kubernetes akan dijalankan secara berkala sesuai jadwal di bidang runtime. Tugas ini memicu skrip pencadangan pada setiap node Cassandra di cluster hybrid Anda yang mengumpulkan semua data pada node, membuat file arsip (terkompresi) data, dan mengirimkan arsip ke server yang ditentukan di file overrides.yaml Anda.

Catatan:

• Anda harus memastikan ada cukup ruang pada sistem file untuk cadangan, dan menyesuaikan frekuensi pencadangan agar tidak memenuhi ruang penyimpanan yang dialokasikan secara tidak perlu. Apigee tidak menentukan kebijakan retensi untuk file cadangan. Anda dapat membuat kebijakan retensi untuk file yang sesuai dengan penginstalan Anda.
• Menerapkan konfigurasi cadangan pada cluster yang ada akan memulai ulang pod Cassandra secara berkelanjutan.

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
• Menetapkan jadwal dan tujuan untuk pencadangan

Menyiapkan server dan SSH

1. 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.
2. Siapkan server SSH di server, atau pastikan server tersebut memiliki server SSH aman yang telah dikonfigurasi.
   Perhatian: Untuk tujuan keamanan, pastikan server SSH Anda sudah yang terbaru.
3. 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 [e-mail]
     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 [e-mail]
     The key's randomart image is:
     +---[RSA 4096]----+
     |          +.  ++X|
     |     .   . o.=.*+|
     |    . o . . o==o |
     |   . . . =oo+o...|
     |  .     S +E oo .|
     |   . .   .. . o .|
     |    . . .  . o.. |
     |     .  ...o ++. |
     |      .. .. +o+. |
     +----[SHA256]-----+

   Dengan: [e-mail] adalah string. Setiap string yang mengikuti -C dalam perintah ssh-keygen akan menjadi komentar yang disertakan dalam kunci ssh yang baru dibuat. String input dapat berupa string apa pun. Jika menggunakan nama akun dalam bentuk [e-mail], Anda dapat dengan cepat mengidentifikasi akun yang menggunakan kunci tersebut.

4. Buat akun pengguna di server pencadangan dengan nama apigee. Pastikan pengguna apigee baru memiliki direktori utama di bawah /home.
5. Di server pencadangan, buat direktori .ssh di direktori /home/apigee baru.
6. Salin kunci publik (ssh_key.pub pada contoh sebelumnya) ke dalam file bernama authorized_keys di direktori /home/apigee/.ssh baru. Contoh:

   cd /home/apigee
   mkdir .ssh
   cd .ssh
   vi authorized_keys

7. Di server pencadangan, buat direktori pencadangan dalam direktori /home/apigee/. Direktori cadangan dapat berupa direktori apa pun selama pengguna apigee memiliki akses ke direktori tersebut. Contoh:

   cd /home/apigee
   mkdir cassandra-backup

8. Uji koneksi. Anda perlu memastikan bahwa pod Cassandra dapat terhubung ke server cadangan menggunakan SSH:
   1. 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.

   2. Hubungkan melalui SSH ke server cadangan Anda, menggunakan kunci SSH pribadi yang terpasang di pod Cassandra dan alamat IP server:

      ssh -i /var/secrets/keys/key apigee@BACKUP_SERVER_IP

      Catatan: Pada tahap ini, Anda mungkin melihat peringatan yang menyatakan bahwa sidik jari server tidak dikenal dan menanyakan apakah Anda ingin melanjutkan. Anda dapat melanjutkan pada dialog tersebut dan memverifikasi konfigurasi SSH.

Menetapkan jadwal dan tujuan untuk pencadangan

Anda menetapkan jadwal dan tujuan pencadangan dalam file overrides.yaml.

1. 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 nama cassandra_backup pada langkah saat Anda membuat direktori cadangan).
   backup:cloudProvider	GCP/HYBRID Untuk cadangan Cloud Storage, tetapkan properti ke GCP. Misalnya: cloudProvider: "GCP". Untuk pencadangan server jarak jauh, tetapkan properti ke HYBRID. Misalnya: cloudProvider: "HYBRID".
   backup:schedule	SCHEDULE Waktu saat pencadangan dimulai, yang ditentukan dalam sintaksis crontab standar. Default: 0 2 * * * Catatan: Hindari menjadwalkan pencadangan yang dimulai tidak lama setelah Anda menerapkan konfigurasi cadangan ke cluster. Saat Anda menerapkan konfigurasi pencadangan, Kubernetes akan membuat ulang node Cassandra. Jika pencadangan dimulai sebelum node dimulai ulang, pencadangan pertama akan gagal dan pencadangan berikutnya akan lulus.

2. Terapkan konfigurasi cadangan ke cakupan penyimpanan cluster Anda:

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

   Catatan: Jika Anda melihat error yang menyatakan Error: UPGRADE FAILED: "datastore" has no deployed releases, ganti upgrade dengan install dan coba kembali perintah tersebut.

   Dengan OVERRIDES_FILE adalah jalur ke file penggantian yang baru saja Anda edit.

3. Verifikasi tugas pencadangan. Contoh:

   kubectl get cronjob -n apigee

   NAME                      SCHEDULE     SUSPEND   ACTIVE   LAST SCHEDULE   AGE
   apigee-cassandra-backup   33 * * * *   False     0        <none>          94s