Halaman ini diterjemahkan oleh Cloud Translation API.

Menskalakan Cassandra

Topik ini membahas cara menskalakan Cassandra secara horizontal dan vertikal, serta cara menskalakan Cassandra.

Menskalakan Cassandra secara horizontal

Untuk menskalakan Cassandra secara horizontal

Pastikan node pool apigee-data Anda memiliki kapasitas tambahan, sesuai kebutuhan, sebelum menskalakan Cassandra. Lihat juga Mengonfigurasi node pool khusus.
Tetapkan nilai properti konfigurasi cassandra.replicaCount dalam file penggantian Anda. Nilai replicaCount harus berupa kelipatan 3. Untuk menentukan nilai replicaCount yang diinginkan, pertimbangkan hal berikut:
- Perkiraan permintaan traffic untuk proxy Anda.
- Lakukan pengujian beban dan buat prediksi yang wajar tentang penggunaan CPU Anda.
- Anda dapat menentukan nilai replicaCount yang berbeda di berbagai region.
- Anda dapat memperluas replicaCount di masa mendatang dalam file penggantian.
Untuk mengetahui informasi tentang properti ini, lihat Referensi properti konfigurasi. Lihat juga Mengelola komponen bidang runtime.

Catatan: Faktor replikasi default untuk semua ruang kunci adalah tiga. Oleh karena itu, sebaiknya skalakan replika dengan faktor tiga.
Terapkan perubahan. Misalnya:
Helm
```
helm upgrade datastore apigee-datastore/ \
  --namespace apigee \
  --atomic \
  -f OVERRIDES_FILE.yaml
```
Catatan: Jika Anda melihat error yang bertuliskan Error: UPGRADE FAILED: "datastore" has no deployed releases, ganti upgrade dengan install dan coba lagi perintahnya.
apigeectl
```
$APIGEECTL_HOME/apigeectl apply --datastore -f OVERRIDES_FILE.yaml
```

Menskalakan Cassandra secara vertikal

Bagian ini menjelaskan cara menskalakan pod Cassandra secara vertikal untuk mengakomodasi persyaratan CPU dan memori yang lebih tinggi.

Ringkasan

Untuk deployment produksi campuran Apigee, sebaiknya buat minimal dua node pool terpisah: satu untuk layanan stateful (Cassandra) dan satu untuk layanan stateless (runtime). Misalnya, lihat Persyaratan cluster produksi GKE.

Untuk kumpulan node Cassandra stateful, sebaiknya mulai dengan 8 core CPU dan memori 30 GB. Setelah node pool disediakan, setelan ini tidak dapat diubah. Lihat juga Mengonfigurasi Cassandra untuk produksi.

Jika Anda perlu menskalakan pod Cassandra untuk mengakomodasi persyaratan CPU dan memori yang lebih tinggi, ikuti langkah-langkah yang dijelaskan dalam topik ini.

Meningkatkan skala pod Cassandra

Ikuti langkah-langkah berikut untuk meningkatkan CPU dan memori untuk node pool stateful yang digunakan untuk Cassandra:

Ikuti petunjuk platform Kubernetes Anda untuk menambahkan kumpulan node baru ke cluster. Platform yang didukung tercantum dalam petunjuk penginstalan.

Pastikan kumpulan node baru sudah siap:

kubectl get nodes -l NODE_POOL_LABEL_NAME=NODE_POOL_LABEL_VALUE

Contoh perintah:

kubectl get nodes -l cloud.google.com/gke-nodepool=apigee-data-new

Contoh output:

NAME                                                STATUS   ROLES    AGE     VERSION
gke-apigee-data-new-441387c2-2h5n   Ready    <none>   4m28s   v1.14.10-gke.17
gke-apigee-data-new-441387c2-6941   Ready    <none>   4m28s   v1.14.10-gke.17
gke-apigee-data-new-441387c2-nhgc   Ready    <none>   4m29s   v1.14.10-gke.17

Perbarui file penggantian untuk menggunakan node pool baru untuk Cassandra dan update resource pod ke jumlah CPU dan ukuran memori yang ditingkatkan yang ingin Anda gunakan. Misalnya, untuk cluster GKE, gunakan konfigurasi yang mirip dengan berikut. Jika menggunakan platform Kubernetes lain, Anda perlu menyesuaikan nilai apigeeData.key dengan tepat:

nodeSelector:
  requiredForScheduling: true
  apigeeData:
    key: "NODE_POOL_LABEL_NAME"
    value: "NODE_POOL_LABEL_VALUE"

cassandra:
  resources:
    requests:
      cpu: NODE_POOL_CPU_NUMBER
      memory: NODE_POOL_MEMORY_SIZE

Contoh:

nodeSelector:
  requiredForScheduling: true
  apigeeData:
    key: "cloud.google.com/gke-nodepool"
    value: "apigee-data-new"

cassandra:
  resources:
    requests:
      cpu: 14
      memory: 16Gi

Terapkan file penggantian ke cluster:

Helm

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

`apigeectl`

$APIGEECTL_HOME/apigeectl apply --datastore -f OVERRIDES_FILE.yaml

Setelah Anda menyelesaikan langkah-langkah ini, pod Cassandra akan mulai di-rollover ke kumpulan node baru.

Memperkecil skala Cassandra

Apigee hybrid menggunakan cincin node Cassandra sebagai StatefulSet. Cassandra menyediakan penyimpanan persisten untuk entity Apigee tertentu di platform runtime. Untuk informasi selengkapnya tentang Cassandra, lihat Tentang platform runtime.

Cassandra adalah layanan yang membutuhkan banyak resource dan tidak boleh di-deploy di pod dengan layanan hybrid lainnya. Bergantung pada beban, Anda mungkin ingin menskalakan jumlah node Cassandra di ring down dalam cluster.

Proses umum untuk menskalakan ring Cassandra adalah:

Pastikan cluster Cassandra dalam kondisi baik dan memiliki penyimpanan yang cukup untuk mendukung penskalaan ke bawah.
Perbarui properti cassandra.replicaCount di overrides.yaml.
Terapkan update konfigurasi.
Hapus klaim volume persisten atau volume, bergantung pada konfigurasi cluster Anda.

Yang perlu Anda ketahui

Jika ada node selain node yang akan dinonaktifkan yang tidak responsif, jangan lanjutkan. Kubernetes tidak akan dapat mendownscale pod dari cluster.
Selalu skalakan ke bawah atau ke atas dengan faktor tiga node.

Menskalakan Cassandra ke bawah

Validasi bahwa cluster berfungsi dengan baik dan semua node aktif dan berjalan, seperti yang ditunjukkan oleh contoh berikut:

 kubectl get pods -n yourNamespace -l app=apigee-cassandra
NAME                 READY   STATUS    RESTARTS   AGE
apigee-cassandra-default-0   1/1     Running   0          2h
apigee-cassandra-default-1   1/1     Running   0          2h
apigee-cassandra-default-2   1/1     Running   0          2h
apigee-cassandra-default-3   1/1     Running   0          16m
apigee-cassandra-default-4   1/1     Running   0          14m
apigee-cassandra-default-5   1/1     Running   0          13m
apigee-cassandra-default-6   1/1     Running   0          9m
apigee-cassandra-default-7   1/1     Running   0          9m
apigee-cassandra-default-8   1/1     Running   0          8m

kubectl -n yourNamespace exec -it apigee-cassandra-default-0 nodetool status
Datacenter: us-east1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.16.2.6    690.17 KiB  256          48.8%             b02089d1-0521-42e1-bbed-900656a58b68  ra-1
UN  10.16.4.6    705.55 KiB  256          51.6%             dc6b7faf-6866-4044-9ac9-1269ebd85dab  ra-1 to
UN  10.16.11.11  674.36 KiB  256          48.3%             c7906366-6c98-4ff6-a4fd-17c596c33cf7  ra-1
UN  10.16.1.11   697.03 KiB  256          49.8%             ddf221aa-80aa-497d-b73f-67e576ff1a23  ra-1
UN  10.16.5.13   703.64 KiB  256          50.9%             2f01ac42-4b6a-4f9e-a4eb-4734c24def95  ra-1
UN  10.16.8.15   700.42 KiB  256          50.6%             a27f93af-f8a0-4c88-839f-2d653596efc2  ra-1
UN  10.16.11.3   697.03 KiB  256          49.8%             dad221ff-dad1-de33-2cd3-f1.672367e6f  ra-1
UN  10.16.14.16  704.04 KiB  256          50.9%             1feed042-a4b6-24ab-49a1-24d4cef95473  ra-1
UN  10.16.16.1   699.82 KiB  256          50.6%             beef93af-fee0-8e9d-8bbf-efc22d653596  ra-1

Tentukan apakah cluster Cassandra memiliki penyimpanan yang cukup untuk mendukung penskalaan ke bawah. Setelah penskalaan ke bawah, node Cassandra tidak boleh memiliki lebih dari 75% penyimpanan yang penuh.
Misalnya, jika cluster Anda memiliki 6 node Cassandra dan semuanya terisi sekitar 50%, mendownscale ke tiga node akan membuat ketiganya terisi 100%, sehingga tidak akan ada ruang untuk operasi yang berkelanjutan.

Namun, jika Anda memiliki 9 node Cassandra, semuanya sekitar 50% penuh, penskalaan ke bawah menjadi 6 node akan membuat setiap node yang tersisa sekitar 75% penuh. Anda dapat mendownscale.

Catatan: Merupakan praktik umum untuk mempertahankan node Cassandra dalam kelipatan tiga.
Perbarui atau tambahkan properti cassandra.replicaCount di file overrides.yaml Anda. Misalnya, jika jumlah node saat ini adalah 9, ubah menjadi 6:
```
cassandra:
  replicaCount: 6 # 
```

Terapkan perubahan konfigurasi ke cluster Anda:

Helm

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

`apigeectl`

$APIGEECTL_HOME/apigeectl apply --datastore -f OVERRIDES_FILE.yaml

namespace/apigee unchanged
secret/ssl-cassandra unchanged
storageclass.storage.k8s.io/apigee-gcepd unchanged
service/apigee-cassandra unchanged
statefulset.apps/apigee-cassandra configured

Pastikan semua node Cassandra yang tersisa sedang berjalan:

kubectl get pods -n yourNamespace -l app=apigee-cassandra
NAME                 READY   STATUS    RESTARTS   AGE
apigee-cassandra-default-0   1/1     Running   0          3h
apigee-cassandra-default-1   1/1     Running   0          3h
apigee-cassandra-default-2   1/1     Running   0          2h
apigee-cassandra-default-3   1/1     Running   0          25m
apigee-cassandra-default-4   1/1     Running   0          24m
apigee-cassandra-default-5   1/1     Running   0          23m

Verifikasi bahwa nilai cassandra.replicaCount sama dengan jumlah node yang ditampilkan oleh perintah nodetool status.

Misalnya, jika Anda menskalakan Cassandra ke enam node:

kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -u JMX_user -pw JMX_password status
Datacenter: us-east1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load         Tokens       Owns (effective)  Host ID                               Rack
UN  10.16.2.6    1009.17 KiB  256          73.8%             b02089d1-0521-42e1-bbed-900656a58b68  ra-1
UN  10.16.4.6    1.65.55 KiB  256          75.6%             dc6b7faf-6866-4044-9ac9-1269ebd85dab  ra-1 to
UN  10.16.11.11  999.36 KiB   256          72.8%             c7906366-6c98-4ff6-a4fd-17c596c33cf7  ra-1
UN  10.16.1.11   1017.03 KiB  256          74.2%             ddf221aa-80aa-497d-b73f-67e576ff1a23  ra-1
UN  10.16.5.13   1061.64 KiB  256          75.9%             2f01ac42-4b6a-4f9e-a4eb-4734c24def95  ra-1
UN  10.16.8.15   1049.42 KiB  256          74.9%             a27f93af-f8a0-4c88-839f-2d653596efc2  ra-1

Setelah cluster Cassandra diperkecil skalanya, pastikan pvcs (PersistentVolumeClaim) sesuai dengan node Cassandra yang tersisa.

Dapatkan nama VPC:

kubectl get pvc -n yourNamespace
NAME                                STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   AGE
cassandra-data-apigee-cassandra-default-0   Bound    pvc-f9c2a5b9-818c-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   7h
cassandra-data-apigee-cassandra-default-1   Bound    pvc-2956cb78-818d-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   7h
cassandra-data-apigee-cassandra-default-2   Bound    pvc-79de5407-8190-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   7h
cassandra-data-apigee-cassandra-default-3   Bound    pvc-d29ba265-81a2-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   5h
cassandra-data-apigee-cassandra-default-4   Bound    pvc-0675a0ff-81a3-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   5h
cassandra-data-apigee-cassandra-default-5   Bound    pvc-354afa95-81a3-11e9-8862-42010a8e014a   100Gi      RWO            apigee-gcepd   5h

Dalam contoh ini, Anda tidak akan melihat pvc yang sesuai dengan tiga node yang diskalakan ke bawah:

cassandra-data-apigee-cassandra-8
cassandra-data-apigee-cassandra-7
cassandra-data-apigee-cassandra-6