Deployment multi-region

Version 1.14 (coming soon)

   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                                         

Topik ini menjelaskan deployment multi-region untuk Apigee hybrid di GKE, Anthos GKE yang di-deploy di lokal, Microsoft® Azure Kubernetes Service (AKS), Amazon Elastic Kubernetes Service (EKS), dan di RedHat OpenShift. Pilih platform Anda di prasyarat dan prosedur.

Topologi untuk deployment multi-region mencakup hal berikut:

• Aktif-Aktif: Jika Anda memiliki aplikasi yang di-deploy di beberapa lokasi geografis dan memerlukan respons API latensi rendah untuk deployment. Anda memiliki opsi untuk men-deploy hybrid di beberapa lokasi geografis yang paling dekat dengan klien Anda. Misalnya: Pantai Barat Amerika Serikat, Pantai Timur Amerika Serikat, Eropa, APAC.
• Aktif-Pasif: Jika Anda memiliki region utama dan region failover atau disaster recovery.

Region dalam deployment hybrid multi-region berkomunikasi melalui Cassandra, seperti yang ditunjukkan gambar berikut:

Prasyarat

Sebelum mengonfigurasi hybrid untuk beberapa region, Anda harus menyelesaikan prasyarat berikut:

GKE

• Saat menginstal deployment Apigee multi-region di antara jaringan yang berbeda (misalnya, penyedia cloud yang berbeda, jaringan VPC yang berbeda, cloud, dan lokal, dll.), Anda harus menyediakan konektivitas internal di antara jaringan terpisah ini yang dapat digunakan Cassandra untuk berkomunikasi antar-node. Hal ini dapat dilakukan dengan VPN atau solusi konektivitas khusus cloud.
• Jika Anda menggunakan Workload Identity di satu cluster untuk mengautentikasi akun layanan, sebaiknya gunakan Workload Identity untuk setiap cluster yang Anda perluas. Lihat Mengaktifkan Workload Identity di GKE atau Mengaktifkan Workload Identity Federation di AKS dan EKS.
• Siapkan cluster Kubernetes di beberapa region dengan blok CIDR yang berbeda.
• Pastikan cert-manager diinstal di setiap cluster.
• Menyiapkan komunikasi lintas region.
• Pastikan semua pod Cassandra dapat me-resolve nama hostnya sendiri. Jika hostNetwork ditetapkan ke false, nama host adalah nama pod Cassandra. Jika hostNetwork disetel ke true, nama host adalah nama host node Kubernetes yang menjalankan pod Cassandra.
  Tips: Untuk memeriksa apakah resolusi nama host berfungsi, gunakan perintah ini.
  
  Jika hostNetwork disetel ke false, gunakan Perintah 1. Jika hostNetwork disetel ke true, gunakan Perintah 2.
  
  Jika resolusi nama host berfungsi, output akan menampilkan alamat IP. Jika resolusi nama host gagal, output akan menyertakan "Host not found".
  
  Perintah 1:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee -- hostname -i

  
  Perintah 2:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee --overrides='{"kind":"Pod", "apiVersion":"v1", "spec": {"hostNetwork":true}}' -- hostname -i

• Persyaratan Multi-Wilayah Cassandra:
  • Pastikan namespace jaringan pod memiliki konektivitas di seluruh region, termasuk firewall, vpn, peering VPC, dan peering vNet. Hal ini berlaku untuk sebagian besar penginstalan GKE.
  • Jika namespace jaringan pod tidak memiliki konektivitas antar-cluster (cluster berjalan dalam "mode jaringan pulau"), aktifkan fitur hostNetwork Kubernetes dengan menetapkan cassandra.hostNetwork: true dalam file penggantian untuk semua region dalam penginstalan multi-region hybrid Apigee Anda.

    Untuk mengetahui informasi selengkapnya tentang kebutuhan hostNetwork, lihat Cluster mode pulau dan hostNetwork di bawah.

  • Aktifkan hostNetwork di cluster yang ada sebelum memperluas konfigurasi multi-region ke wilayah baru.
  • Jika hostNetwork diaktifkan, pastikan node pekerja dapat melakukan penerusan pencarian DNS nama hostnya. Apigee Cassandra menggunakan pencarian DNS maju untuk mendapatkan IP host saat memulai.
    Tips: Jika resolusi DNS tidak berfungsi, coba solusi ini.

    Tambahkan entri host statis dalam file /etc/hosts dari setiap node pekerja cassandra yang mirip dengan berikut:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    atau

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Buka port TCP 7001 di antara cluster Kubernetes di semua region agar node pekerja di seluruh region dan pusat data dapat berkomunikasi. Lihat Mengonfigurasi port untuk mengetahui informasi tentang nomor port Cassandra.

Untuk mengetahui informasi mendetail, lihat dokumentasi Kubernetes.

Catatan: Apigee merekomendasikan agar Anda memastikan waktu server Anda disinkronkan.

Beberapa fitur seperti masa berlaku dan pencabutan token bergantung pada waktu sistem yang akurat. Jika Anda menghosting komponen runtime di pusat data yang berbeda, pastikan waktu sistem disinkronkan.

Anda dapat menggunakan alat seperti ntpdate untuk memverifikasi bahwa waktu server disinkronkan.

GKE on-prem

• Saat menginstal deployment Apigee multi-region di antara jaringan yang berbeda (misalnya, penyedia cloud yang berbeda, jaringan VPC yang berbeda, cloud, dan lokal, dll.), Anda harus menyediakan konektivitas internal di antara jaringan terpisah ini yang dapat digunakan Cassandra untuk berkomunikasi antar-node. Hal ini dapat dilakukan dengan VPN atau solusi konektivitas khusus cloud.
• Siapkan cluster Kubernetes di beberapa region dengan blok CIDR yang berbeda.
• Pastikan cert-manager diinstal di setiap cluster.
• Menyiapkan komunikasi lintas region.
• Pastikan semua pod Cassandra dapat me-resolve nama hostnya sendiri. Jika hostNetwork ditetapkan ke false, nama host adalah nama pod Cassandra. Jika hostNetwork disetel ke true, nama host adalah nama host node Kubernetes yang menjalankan pod Cassandra.
  Tips: Untuk memeriksa apakah resolusi nama host berfungsi, gunakan perintah ini.
  
  Jika hostNetwork disetel ke false, gunakan Perintah 1. Jika hostNetwork disetel ke true, gunakan Perintah 2.
  
  Jika resolusi nama host berfungsi, output akan menampilkan alamat IP. Jika resolusi nama host gagal, output akan menyertakan "Host not found".
  
  Perintah 1:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee -- hostname -i

  
  Perintah 2:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee --overrides='{"kind":"Pod", "apiVersion":"v1", "spec": {"hostNetwork":true}}' -- hostname -i

• Persyaratan Multi-Wilayah Cassandra:
  • Jika namespace jaringan pod tidak memiliki konektivitas antar-cluster (cluster berjalan dalam "mode jaringan pulau", kasus default dalam penginstalan on-prem GKE), aktifkan fitur hostNetwork Kubernetes dengan menetapkan cassandra.hostNetwork: true dalam file penggantian untuk semua region dalam penginstalan multi-region hibrida Apigee Anda.

    Untuk mengetahui informasi selengkapnya tentang kebutuhan hostNetwork, lihat Cluster mode pulau dan hostNetwork di bawah.

  • Aktifkan hostNetwork di cluster yang ada sebelum memperluas konfigurasi multi-region ke wilayah baru.
  • Jika hostNetwork diaktifkan, pastikan node pekerja dapat melakukan penerusan pencarian DNS nama hostnya. Apigee Cassandra menggunakan pencarian DNS maju untuk mendapatkan IP host saat memulai.
    Tips: Jika resolusi DNS tidak berfungsi, coba solusi ini.

    Tambahkan entri host statis dalam file /etc/hosts dari setiap node pekerja cassandra yang mirip dengan berikut:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    atau

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Buka port Cassandra di antara cluster Kubernetes di semua region untuk memungkinkan node pekerja di seluruh region dan pusat data berkomunikasi. Lihat Mengonfigurasi port untuk mengetahui nomor port Cassandra.

Untuk mengetahui informasi mendetail, lihat dokumentasi Kubernetes.

Catatan: Apigee merekomendasikan agar Anda memastikan waktu server Anda disinkronkan.

Beberapa fitur seperti masa berlaku dan pencabutan token bergantung pada waktu sistem yang akurat. Jika Anda menghosting komponen runtime di pusat data yang berbeda, pastikan untuk menyinkronkan waktu sistem.

Anda dapat menggunakan alat seperti ntpdate untuk memverifikasi bahwa waktu server disinkronkan.

AKS

• Saat menginstal deployment Apigee multi-region di antara jaringan yang berbeda (misalnya, penyedia cloud yang berbeda, jaringan VPC yang berbeda, cloud, dan lokal, dll.), Anda harus menyediakan konektivitas internal di antara jaringan terpisah ini yang dapat digunakan Cassandra untuk berkomunikasi antar-node. Hal ini dapat dilakukan dengan VPN atau solusi konektivitas khusus cloud.
• Ikuti panduan penginstalan hybrid untuk prasyarat apa pun seperti konfigurasi Google Cloud dan organisasi sebelum beralih ke langkah-langkah penyiapan cluster.
• Pastikan cert-manager diinstal di setiap cluster.
• Pastikan semua pod Cassandra dapat me-resolve nama hostnya sendiri. Jika hostNetwork ditetapkan ke false, nama host adalah nama pod Cassandra. Jika hostNetwork disetel ke true, nama host adalah nama host node Kubernetes yang menjalankan pod Cassandra.
  Tips: Untuk memeriksa apakah resolusi nama host berfungsi, gunakan perintah ini.
  
  Jika hostNetwork disetel ke false, gunakan Perintah 1. Jika hostNetwork disetel ke true, gunakan Perintah 2.
  
  Jika resolusi nama host berfungsi, output akan menampilkan alamat IP. Jika resolusi nama host gagal, output akan menyertakan "Host not found".
  
  Perintah 1:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee -- hostname -i

  
  Perintah 2:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee --overrides='{"kind":"Pod", "apiVersion":"v1", "spec": {"hostNetwork":true}}' -- hostname -i

• Persyaratan Multi-Wilayah Cassandra:
  • Jika namespace jaringan pod tidak memiliki konektivitas antar-cluster (cluster berjalan dalam "mode jaringan pulau", kasus default dalam penginstalan AKS), aktifkan fitur hostNetwork Kubernetes dengan menetapkan cassandra.hostNetwork: true dalam file penggantian untuk semua region dalam penginstalan multi-region campuran Apigee Anda.

    Untuk mengetahui informasi selengkapnya tentang kebutuhan hostNetwork, lihat Cluster mode pulau dan hostNetwork di bawah.

  • Aktifkan hostNetwork di cluster yang ada sebelum memperluas konfigurasi multi-region ke wilayah baru.
  • Jika hostNetwork diaktifkan, pastikan node pekerja dapat melakukan penerusan pencarian DNS nama hostnya. Apigee Cassandra menggunakan pencarian DNS maju untuk mendapatkan IP host saat memulai.
    Tips: Jika resolusi DNS tidak berfungsi, coba solusi ini.

    Tambahkan entri host statis dalam file /etc/hosts dari setiap node pekerja cassandra yang mirip dengan berikut:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    atau

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Buka port Cassandra di antara cluster Kubernetes di semua region untuk memungkinkan node pekerja di seluruh region dan pusat data berkomunikasi. Lihat Mengonfigurasi port untuk mengetahui nomor port Cassandra.

Untuk mengetahui informasi mendetail, lihat dokumentasi Kubernetes.

Catatan: Apigee merekomendasikan agar Anda memastikan waktu server Anda disinkronkan.

Beberapa fitur seperti masa berlaku dan pencabutan token bergantung pada waktu sistem yang akurat. Jika Anda menghosting komponen runtime di pusat data yang berbeda, pastikan waktu sistem disinkronkan.

Anda dapat menggunakan alat seperti ntpdate untuk memverifikasi bahwa waktu server disinkronkan.

EKS

• Saat menginstal deployment Apigee multi-region di antara jaringan yang berbeda (misalnya, penyedia cloud yang berbeda, jaringan VPC yang berbeda, cloud, dan lokal, dll.), Anda harus menyediakan konektivitas internal di antara jaringan terpisah ini yang dapat digunakan Cassandra untuk berkomunikasi antar-node. Hal ini dapat dilakukan dengan VPN atau solusi konektivitas khusus cloud.
• Ikuti panduan penginstalan hybrid untuk prasyarat apa pun seperti konfigurasi Google Cloud dan organisasi sebelum beralih ke langkah-langkah penyiapan cluster.
• Pastikan cert-manager diinstal di setiap cluster.
• Pastikan semua pod Cassandra dapat me-resolve nama hostnya sendiri. Jika hostNetwork ditetapkan ke false, nama host adalah nama pod Cassandra. Jika hostNetwork disetel ke true, nama host adalah nama host node Kubernetes yang menjalankan pod Cassandra.
  Tips: Untuk memeriksa apakah resolusi nama host berfungsi, gunakan perintah ini.
  
  Jika hostNetwork disetel ke false, gunakan Perintah 1. Jika hostNetwork disetel ke true, gunakan Perintah 2.
  
  Jika resolusi nama host berfungsi, output akan menampilkan alamat IP. Jika resolusi nama host gagal, output akan menyertakan "Host not found".
  
  Perintah 1:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee -- hostname -i

  
  Perintah 2:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee --overrides='{"kind":"Pod", "apiVersion":"v1", "spec": {"hostNetwork":true}}' -- hostname -i

• Persyaratan Multi-Wilayah Cassandra:
  • Jika namespace jaringan pod tidak memiliki konektivitas antar-cluster (cluster berjalan dalam "mode jaringan pulau"), aktifkan fitur hostNetwork Kubernetes dengan menetapkan cassandra.hostNetwork: true dalam file penggantian untuk semua region di penginstalan multi-region hybrid Apigee Anda. Amazon EKS menggunakan model jaringan yang terintegrasi sepenuhnya secara default.

    Untuk mengetahui informasi selengkapnya tentang kebutuhan hostNetwork, lihat Cluster mode pulau dan hostNetwork di bawah.

  • Aktifkan hostNetwork di cluster yang ada sebelum memperluas konfigurasi multi-region ke wilayah baru.
  • Jika hostNetwork diaktifkan, pastikan node pekerja dapat melakukan penerusan pencarian DNS nama hostnya. Apigee Cassandra menggunakan pencarian DNS maju untuk mendapatkan IP host saat memulai.
    Tips: Jika resolusi DNS tidak berfungsi, coba solusi ini.

    Tambahkan entri host statis dalam file /etc/hosts dari setiap node pekerja cassandra yang mirip dengan berikut:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    atau

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Buka port Cassandra di antara cluster Kubernetes di semua region untuk memungkinkan node pekerja di seluruh region dan pusat data berkomunikasi. Lihat Mengonfigurasi port untuk mengetahui nomor port Cassandra.

Untuk mengetahui informasi mendetail, lihat dokumentasi Kubernetes.

Catatan: Apigee merekomendasikan agar Anda memastikan waktu server Anda disinkronkan.

Beberapa fitur seperti masa berlaku dan pencabutan token bergantung pada waktu sistem yang akurat. Jika Anda menghosting komponen runtime di pusat data yang berbeda, pastikan waktu sistem disinkronkan.

Anda dapat menggunakan alat seperti ntpdate untuk memverifikasi bahwa waktu server disinkronkan.

OpenShift

• Saat menginstal deployment Apigee multi-region di antara jaringan yang berbeda (misalnya, penyedia cloud yang berbeda, jaringan VPC yang berbeda, cloud, dan lokal, dll.), Anda harus menyediakan konektivitas internal di antara jaringan terpisah ini yang dapat digunakan Cassandra untuk berkomunikasi antar-node. Hal ini dapat dilakukan dengan VPN atau solusi konektivitas khusus cloud.
• Ikuti panduan penginstalan hybrid untuk prasyarat apa pun seperti konfigurasi Google Cloud dan organisasi sebelum beralih ke langkah-langkah penyiapan cluster.
• Pastikan cert-manager diinstal di setiap cluster.
• Pastikan semua pod Cassandra dapat me-resolve nama hostnya sendiri. Jika hostNetwork ditetapkan ke false, nama host adalah nama pod Cassandra. Jika hostNetwork disetel ke true, nama host adalah nama host node Kubernetes yang menjalankan pod Cassandra.
  Tips: Untuk memeriksa apakah resolusi nama host berfungsi, gunakan perintah ini.
  
  Jika hostNetwork disetel ke false, gunakan Perintah 1. Jika hostNetwork disetel ke true, gunakan Perintah 2.
  
  Jika resolusi nama host berfungsi, output akan menampilkan alamat IP. Jika resolusi nama host gagal, output akan menyertakan "Host not found".
  
  Perintah 1:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee -- hostname -i

  
  Perintah 2:

  kubectl run -l app=alpine --image=alpine --restart=Never --rm -i -t alpine-linux -n apigee --overrides='{"kind":"Pod", "apiVersion":"v1", "spec": {"hostNetwork":true}}' -- hostname -i

• Persyaratan Multi-Wilayah Cassandra:
  • Jika namespace jaringan pod tidak memiliki konektivitas antar-cluster (cluster berjalan dalam "mode jaringan pulau", kasus default dalam penginstalan OpenShift), aktifkan fitur hostNetwork Kubernetes dengan menetapkan cassandra.hostNetwork: true dalam file penggantian untuk semua region dalam penginstalan multi-region hybrid Apigee Anda.

    Untuk mengetahui informasi selengkapnya tentang kebutuhan hostNetwork, lihat Cluster mode pulau dan hostNetwork di bawah.

  • Aktifkan hostNetwork di cluster yang ada sebelum memperluas konfigurasi multi-region ke wilayah baru.
  • Jika hostNetwork diaktifkan, pastikan node pekerja dapat melakukan penerusan pencarian DNS nama hostnya. Apigee Cassandra menggunakan pencarian DNS maju untuk mendapatkan IP host saat memulai.
    Tips: Jika resolusi DNS tidak berfungsi, coba solusi ini.

    Tambahkan entri host statis dalam file /etc/hosts dari setiap node pekerja cassandra yang mirip dengan berikut:

    echo -e "\\n127.0.1.1 ${HOSTNAME}" >> "/etc/hosts"

    atau

    "\\nWORKER-NODE-IP ${HOSTNAME}" >> "/etc/hosts"

  • Buka port Cassandra di antara cluster Kubernetes di semua region untuk memungkinkan node pekerja di seluruh region dan pusat data berkomunikasi. Lihat Mengonfigurasi port untuk mengetahui nomor port Cassandra.

Untuk mengetahui informasi mendetail, lihat dokumentasi Kubernetes.

Catatan: Apigee merekomendasikan agar Anda memastikan waktu server Anda disinkronkan.

Beberapa fitur seperti masa berlaku dan pencabutan token bergantung pada waktu sistem yang akurat. Jika Anda menghosting komponen runtime di pusat data yang berbeda, pastikan waktu sistem disinkronkan.

Anda dapat menggunakan alat seperti ntpdate untuk memverifikasi bahwa waktu server disinkronkan.

Cluster mode pulau dan hostNetwork

Ada dua model jaringan utama untuk cluster Kubernetes: terintegrasi sepenuhnya (atau datar) dan mode pulau. Apigee merekomendasikan penggunaan model jaringan datar jika memungkinkan, karena hal ini akan mempermudah koneksi Cassandra multi-region. Saat cluster Kubernetes dikonfigurasi dalam mode pulau, jaringan pod akan diisolasi. Pod tidak dapat berkomunikasi langsung dengan pod yang berjalan di cluster lain menggunakan alamat IP pod. Lihat Implementasi model jaringan umum untuk mengetahui informasi lebih lanjut tentang perbedaan antara kedua model jaringan ini dan contoh dari masing-masing model.

Saat Apigee Hybrid berjalan di dua cluster Kubernetes atau lebih menggunakan model jaringan mode pulau, Anda harus mengaktifkan setelan hostNetwork untuk Cassandra melalui properti cassandra.hostNetwork. Secara default, pod Kubernetes diisolasi ke dalam setiap namespace jaringan yang mencegahnya menggunakan IP node pekerja Kubernetes. Jika hostNetwork ditetapkan ke true, pod tidak diisolasi dalam namespace jaringannya sendiri, dan sebagai gantinya menggunakan alamat IP dan nama host node pekerja Kubernetes tempat pod dijadwalkan. Hal ini memungkinkan Cassandra menggunakan IP node pekerja Kubernetes secara native sebagai IP-nya, sehingga menyediakan cara bagi Cassandra untuk membuat mesh penuh di antara semua pod Cassandra di beberapa cluster yang berjalan dalam mode pulau.

Resolusi nama host Cassandra

Meskipun pod Cassandra tidak me-resolve pod Cassandra lainnya berdasarkan nama host, saat memulai, Cassandra akan memeriksa apakah nama hostnya sendiri dapat di-resolve oleh DNS. Karena nama host pod sama dengan nama host node pekerja Kubernetes saat hostNetwork ditetapkan ke benar, nama host node pekerja harus dapat di-resolve ke alamat IP melalui layanan DNS cluster. Jika nama host node pekerja Kubernetes tidak dapat di-resolve, pod Cassandra akan gagal dimulai sepenuhnya. Oleh karena itu, nama host node pekerja Kubernetes harus dapat di-resolve dari pod di cluster saat menetapkan hostNetwork ke true.

Mengonfigurasi Apigee hybrid untuk multi-region

Bagian ini menjelaskan cara mengonfigurasi Apigee Hybrid untuk multi-wilayah.

GKE

Penting: Saat memperluas Apigee hybrid ke datacenter regional baru, pastikan untuk menginstal versi hybrid yang sama seperti yang Anda miliki di datacenter yang ada. Hindari menjalankan versi campuran yang berbeda di beberapa datacenter.

Peringatan: Jika penginstalan gagal untuk region baru, jangan lanjutkan penginstalan region. Sebagai gantinya, hapus dan buat ulang penginstalan campuran di wilayah yang gagal.

Mengonfigurasi host seed multi-region

Bagian ini menjelaskan cara memperluas cluster Cassandra yang ada ke region baru. Penyiapan ini memungkinkan region baru mem-bootstrap cluster dan bergabung dengan pusat data yang ada. Tanpa konfigurasi ini, cluster Kubernetes multi-region tidak akan saling mengetahui.

1. Untuk region pertama yang dibuat, dapatkan pod di namespace apigee Anda:

   kubectl get pods -o wide -n APIGEE_NAMESPACE
   

2. Identifikasi alamat host seed multi-region untuk Cassandra di region ini, misalnya 10.0.0.11.

3. Siapkan file overrides.yaml untuk region kedua dan tambahkan alamat IP host seed sebagai berikut:

   cassandra:
     multiRegionSeedHost: "SEED_HOST_IP_ADDRESS"
     datacenter: "DATACENTER_NAME"
     rack: "RACK_NAME"
     hostNetwork: false
     clusterName: CLUSTER_NAME

   Ganti kode berikut:

   • SEED_HOST_IP_ADDRESS dengan alamat IP host seed, misalnya 10.0.0.11.
   • DATACENTER_NAME dengan nama pusat data, misalnya dc-2.
   • RACK_NAME dengan nama rak, misalnya ra-1.
   • CLUSTER_NAME dengan nama cluster Cassandra Anda. Secara default, nilainya adalah apigeecluster. Jika menggunakan nama cluster yang berbeda, Anda harus menentukan nilai untuk cassandra.clusterName. Anda bebas memilih nilai sendiri, tetapi nilai tersebut harus sama di semua wilayah.

Mengonfigurasi region kedua

Untuk menyiapkan wilayah baru:

1. Instal cert-manager di region kedua.

2. Salin sertifikat Anda dari cluster yang ada ke cluster baru. Root CA baru digunakan oleh Cassandra dan komponen campuran lainnya untuk mTLS. Oleh karena itu, penting untuk memiliki sertifikat yang konsisten di seluruh cluster.

   1. Tetapkan konteks ke namespace asli:

      kubectl config use-context ORIGINAL_CLUSTER_NAME
      

   2. Ekspor konfigurasi namespace saat ini ke file:

      kubectl get namespace APIGEE_NAMESPACE -o yaml > apigee-namespace.yaml
      

   3. Ekspor secret apigee-ca ke file:

      kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
      

   4. Tetapkan konteks ke nama cluster region baru:

      kubectl config use-context NEW_CLUSTER_NAME
      

   5. Impor konfigurasi namespace ke cluster baru. Pastikan untuk memperbarui namespace dalam file jika Anda menggunakan namespace yang berbeda di region baru:

      kubectl apply -f apigee-namespace.yaml
      

   6. Impor secret ke cluster baru:

      kubectl -n cert-manager apply -f apigee-ca.yaml
      

3. Ikuti langkah-langkah untuk Menginstal CRD hybrid Apigee ke wilayah baru.

4. Sekarang, gunakan diagram Helm untuk menginstal Apigee hybrid di region baru dengan perintah Diagram Helm berikut (seperti yang dilakukan di region 1):

   Catatan: Anda dapat menggunakan CRD yang sama untuk konsistensi dengan menggunakan folder yang sama tempat Anda mendownload diagram, Anda juga dapat membuat file penggantian unik antara region 1 dan 2 dengan memberi nama penggantian sesuatu yang unik seperti overrides-region_name.yaml, dll.

   helm upgrade operator apigee-operator \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade datastore apigee-datastore \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade telemetry apigee-telemetry \
     --install \
     --namespace APIGEE_NAMESPACE> \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade redis apigee-redis \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ingress-manager apigee-ingress-manager \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ORG_NAME apigee-org \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env mentioned on the overrides
   helm upgrade ENV_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set env=ENV_NAME \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env group mentioned on the overrides
   helm upgrade apigee-virtualhost-ENV_GROUP_NAME apigee-virtualhost/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set envgroup=ENV_GROUP_NAME \
     -f overrides-DATACENTER_NAME.yaml
   

5. Verifikasi penyiapan cluster Cassandra dengan menjalankan perintah berikut. Output akan menampilkan pusat data yang ada dan baru.
   Peringatan: Jika output perintah ini tidak menampilkan data center yang ada dan baru, penyiapan akan gagal. Dalam hal ini, jangan melanjutkan lebih lanjut.

   Untuk memperbaiki masalah ini, penginstalan campuran di wilayah baru harus dihapus dan dibuat ulang. Lihat Meng-uninstal runtime campuran. Jika penyiapan gagal, jangan mencoba melanjutkan atau mencoba bergabung ke cluster.

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  \
   -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Contoh yang menunjukkan penyiapan yang berhasil:

   Datacenter: dc-1
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.87.93   68.07 GiB  256     ?     fb51465c-167a-42f7-98c9-b6eba1de34de  c
   UN  10.132.84.94   69.9 GiB   256     ?     f621a5ac-e7ee-48a9-9a14-73d69477c642  b
   UN  10.132.84.105  76.95 GiB  256     ?     0561086f-e95b-4232-ba6c-ad519ff30336  d
   
   Datacenter: dc-2
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.0.8     71.61 GiB  256     ?     8894a98b-8406-45de-99e2-f404ab10b5d6  c
   UN  10.132.9.204   75.1 GiB   256     ?     afa0ffa3-630b-4f1e-b46f-fc3df988092e  a
   UN  10.132.3.133   68.08 GiB  256     ?     25ae39ab-b39e-4d4f-9cb7-de095ab873db  b

6. Siapkan Cassandra di semua pod di pusat data baru.
   1. Dapatkan apigeeorg dari cluster dengan perintah berikut:

      kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      

      Contoh:

      Ex: kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      "rg-hybrid-b7d3b9c"
      

   2. Buat file resource kustom (YAML) replikasi data cassandra. File dapat bernama apa saja. Dalam contoh berikut, file akan memiliki nama datareplication.yaml.

      File harus berisi hal berikut:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: REGION_EXPANSION
        namespace: NAMESPACE
      spec:
        organizationRef: APIGEEORG_VALUE
        force: false
        source:
          region: SOURCE_REGION

      Dengan keterangan:

      • REGION_EXPANSION adalah nama yang Anda berikan ke metadata ini. Anda dapat menggunakan nama apa pun.
      • NAMESPACE adalah namespace yang sama dengan yang disediakan di overrides.yaml. Nilai ini biasanya "apigee".
      • APIGEEORG_VALUE adalah output nilai dari perintah kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name" di langkah sebelumnya. Misalnya, rg-hybrid-b7d3b9c
      • SOURCE_REGION adalah region sumber, nilai datacenter di bagian cassandra dari overrides.yaml region sumber

      Contoh:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: region-expansion
        namespace: apigee
      spec:
        organizationRef: rg-hybrid-b7d3b9c
        force: false
        source:
          region: "dc-1"

   3. Terapkan CassandraDataReplication dengan perintah berikut:

      kubectl apply -f datareplication.yaml

7. Verifikasi status build ulang menggunakan perintah berikut.
   Catatan: Operasi pembuatan ulang dapat memerlukan waktu hingga beberapa jam, bergantung pada ukuran data.

   kubectl -n APIGEE_NAMESPACE get apigeeds -o json | jq ".items[].status.cassandraDataReplication"

   Hasilnya akan terlihat seperti ini:

   {
   "rebuildDetails": {
   "apigee-cassandra-default-0": {
   "state": "complete",
   "updated": 1623105760
   },
   "apigee-cassandra-default-1": {
   "state": "complete",
   "updated": 1623105765
   },
   "apigee-cassandra-default-2": {
   "state": "complete",
   "updated": 1623105770
   }
   },
   "state": "complete",
   "updated": 1623105770
   }

8. Setelah replikasi data selesai dan diverifikasi, perbarui host seed:
   1. Menghapus multiRegionSeedHost: 10.0.0.11 dari overrides-DATACENTER_NAME.yaml.

   2. Terapkan kembali perubahan untuk memperbarui CR datastore apigee:

      helm upgrade datastore apigee-datastore/ \
        --install \
        --namespace APIGEE_NAMESPACE \
        --atomic \
        -f overrides-DATACENTER_NAME.yaml
      

9. Verifikasi proses build ulang dari log. Selain itu, verifikasi ukuran data menggunakan perintah nodetool status.
   Catatan: Jika operasi pembuatan ulang menunjukkan status selesai dan log proses pembuatan ulang berisi "Semua sesi selesai", semua data telah berhasil disalin ke region baru.

   kubectl logs apigee-cassandra-default-0 -f -n APIGEE_NAMESPACE

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Tips: APIGEE_JMX_USER dan APIGEE_JMX_PASSWORD biasanya ditentukan dalam variabel lingkungan $APIGEE_JMX_USER dan $APIGEE_JMX_PASSWORD.

   Contoh berikut menunjukkan contoh entri log:

   INFO  01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens)
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB)
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed

Memeriksa status cluster Cassandra

Perintah berikut berguna untuk melihat apakah penyiapan cluster berhasil di dua pusat data. Perintah ini memeriksa status nodetool untuk kedua region.

kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status


Datacenter: dc-1
=======================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.12.1.45  112.09 KiB  256          100.0%            3c98c816-3f4d-48f0-9717-03d0c998637f  ra-1
UN  10.12.4.36  95.27 KiB  256          100.0%            0a36383d-1d9e-41e2-924c-7b62be12d6cc  ra-1
UN  10.12.5.22  88.7 KiB   256          100.0%            3561f4fa-af3d-4ea4-93b2-79ac7e938201  ra-1
Datacenter: us-west1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.0.4.33   78.69 KiB  256          100.0%              a200217d-260b-45cd-b83c-182b27ff4c99  ra-1
UN  10.0.0.21   78.68 KiB  256          100.0%              9f3364b9-a7a1-409c-9356-b7d1d312e52b  ra-1
UN  10.0.1.26   15.46 KiB  256          100.0%              1666df0f-702e-4c5b-8b6e-086d0f2e47fa  ra-1

GKE on-prem

Penting: Saat memperluas Apigee hybrid ke datacenter regional baru, pastikan untuk menginstal versi hybrid yang sama seperti yang Anda miliki di datacenter yang ada. Hindari menjalankan versi campuran yang berbeda di beberapa datacenter.

Peringatan: Jika penginstalan gagal untuk region baru, jangan lanjutkan penginstalan region. Sebagai gantinya, hapus dan buat ulang penginstalan campuran di wilayah yang gagal.

Mengonfigurasi host seed multi-region

Bagian ini menjelaskan cara memperluas cluster Cassandra yang ada ke region baru. Penyiapan ini memungkinkan region baru mem-bootstrap cluster dan bergabung dengan pusat data yang ada. Tanpa konfigurasi ini, cluster Kubernetes multi-region tidak akan saling mengetahui.

1. Untuk region pertama yang dibuat, dapatkan pod di namespace apigee Anda:

   kubectl get pods -o wide -n APIGEE_NAMESPACE
   

2. Identifikasi alamat host seed multi-region untuk Cassandra di region ini, misalnya 10.0.0.11.

3. Siapkan file overrides.yaml untuk region kedua dan tambahkan alamat IP host seed sebagai berikut:

   cassandra:
     multiRegionSeedHost: "SEED_HOST_IP_ADDRESS"
     datacenter: "DATACENTER_NAME"
     rack: "RACK_NAME"
     hostNetwork: false
     clusterName: CLUSTER_NAME

   Ganti kode berikut:

   • SEED_HOST_IP_ADDRESS dengan alamat IP host seed, misalnya 10.0.0.11.
   • DATACENTER_NAME dengan nama pusat data, misalnya dc-2.
   • RACK_NAME dengan nama rak, misalnya ra-1.
   • CLUSTER_NAME dengan nama cluster Cassandra Anda. Secara default, nilainya adalah apigeecluster. Jika menggunakan nama cluster yang berbeda, Anda harus menentukan nilai untuk cassandra.clusterName. Anda bebas memilih nilai sendiri, tetapi nilai tersebut harus sama di semua wilayah.

Mengonfigurasi region kedua

Untuk menyiapkan wilayah baru:

1. Instal cert-manager di region kedua.

2. Salin sertifikat Anda dari cluster yang ada ke cluster baru. Root CA baru digunakan oleh Cassandra dan komponen campuran lainnya untuk mTLS. Oleh karena itu, penting untuk memiliki sertifikat yang konsisten di seluruh cluster.

   1. Tetapkan konteks ke namespace asli:

      kubectl config use-context ORIGINAL_CLUSTER_NAME
      

   2. Ekspor konfigurasi namespace saat ini ke file:

      kubectl get namespace APIGEE_NAMESPACE -o yaml > apigee-namespace.yaml
      

   3. Ekspor secret apigee-ca ke file:

      kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
      

   4. Tetapkan konteks ke nama cluster region baru:

      kubectl config use-context NEW_CLUSTER_NAME
      

   5. Impor konfigurasi namespace ke cluster baru. Pastikan untuk memperbarui namespace dalam file jika Anda menggunakan namespace yang berbeda di region baru:

      kubectl apply -f apigee-namespace.yaml
      

   6. Impor secret ke cluster baru:

      kubectl -n cert-manager apply -f apigee-ca.yaml
      

3. Ikuti langkah-langkah untuk Menginstal CRD hybrid Apigee ke wilayah baru.

4. Sekarang, gunakan diagram Helm untuk menginstal Apigee hybrid di region baru dengan perintah Diagram Helm berikut (seperti yang dilakukan di region 1):

   Catatan: Anda dapat menggunakan CRD yang sama untuk konsistensi dengan menggunakan folder yang sama tempat Anda mendownload diagram, Anda juga dapat membuat file penggantian unik antara region 1 dan 2 dengan memberi nama penggantian sesuatu yang unik seperti overrides-region_name.yaml, dll.

   helm upgrade operator apigee-operator \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade datastore apigee-datastore \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade telemetry apigee-telemetry \
     --install \
     --namespace APIGEE_NAMESPACE> \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade redis apigee-redis \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ingress-manager apigee-ingress-manager \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ORG_NAME apigee-org \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env mentioned on the overrides
   helm upgrade ENV_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set env=ENV_NAME \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env group mentioned on the overrides
   helm upgrade apigee-virtualhost-ENV_GROUP_NAME apigee-virtualhost/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set envgroup=ENV_GROUP_NAME \
     -f overrides-DATACENTER_NAME.yaml
   

5. Verifikasi penyiapan cluster Cassandra dengan menjalankan perintah berikut. Output akan menampilkan pusat data yang ada dan baru.
   Peringatan: Jika output perintah ini tidak menampilkan data center yang ada dan baru, penyiapan akan gagal. Dalam hal ini, jangan melanjutkan lebih lanjut.

   Untuk memperbaiki masalah ini, penginstalan campuran di wilayah baru harus dihapus dan dibuat ulang. Lihat Meng-uninstal runtime campuran. Jika penyiapan gagal, jangan mencoba melanjutkan atau mencoba bergabung ke cluster.

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  \
   -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Contoh yang menunjukkan penyiapan yang berhasil:

   Datacenter: dc-1
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.87.93   68.07 GiB  256     ?     fb51465c-167a-42f7-98c9-b6eba1de34de  c
   UN  10.132.84.94   69.9 GiB   256     ?     f621a5ac-e7ee-48a9-9a14-73d69477c642  b
   UN  10.132.84.105  76.95 GiB  256     ?     0561086f-e95b-4232-ba6c-ad519ff30336  d
   
   Datacenter: dc-2
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.0.8     71.61 GiB  256     ?     8894a98b-8406-45de-99e2-f404ab10b5d6  c
   UN  10.132.9.204   75.1 GiB   256     ?     afa0ffa3-630b-4f1e-b46f-fc3df988092e  a
   UN  10.132.3.133   68.08 GiB  256     ?     25ae39ab-b39e-4d4f-9cb7-de095ab873db  b

6. Siapkan Cassandra di semua pod di pusat data baru.
   1. Dapatkan apigeeorg dari cluster dengan perintah berikut:

      kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      

      Contoh:

      Ex: kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      "rg-hybrid-b7d3b9c"
      

   2. Buat file resource kustom (YAML) replikasi data cassandra. File dapat bernama apa saja. Dalam contoh berikut, file akan memiliki nama datareplication.yaml.

      File harus berisi hal berikut:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: REGION_EXPANSION
        namespace: NAMESPACE
      spec:
        organizationRef: APIGEEORG_VALUE
        force: false
        source:
          region: SOURCE_REGION

      Dengan keterangan:

      • REGION_EXPANSION adalah nama yang Anda berikan ke metadata ini. Anda dapat menggunakan nama apa pun.
      • NAMESPACE adalah namespace yang sama dengan yang disediakan di overrides.yaml. Nilai ini biasanya "apigee".
      • APIGEEORG_VALUE adalah output nilai dari perintah kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name" di langkah sebelumnya. Misalnya, rg-hybrid-b7d3b9c
      • SOURCE_REGION adalah region sumber, nilai datacenter di bagian cassandra dari overrides.yaml region sumber

      Contoh:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: region-expansion
        namespace: apigee
      spec:
        organizationRef: rg-hybrid-b7d3b9c
        force: false
        source:
          region: "dc-1"

   3. Terapkan CassandraDataReplication dengan perintah berikut:

      kubectl apply -f datareplication.yaml

7. Verifikasi status build ulang menggunakan perintah berikut.
   Catatan: Operasi pembuatan ulang dapat memerlukan waktu hingga beberapa jam, bergantung pada ukuran data.

   kubectl -n APIGEE_NAMESPACE get apigeeds -o json | jq ".items[].status.cassandraDataReplication"

   Hasilnya akan terlihat seperti ini:

   {
   "rebuildDetails": {
   "apigee-cassandra-default-0": {
   "state": "complete",
   "updated": 1623105760
   },
   "apigee-cassandra-default-1": {
   "state": "complete",
   "updated": 1623105765
   },
   "apigee-cassandra-default-2": {
   "state": "complete",
   "updated": 1623105770
   }
   },
   "state": "complete",
   "updated": 1623105770
   }

8. Setelah replikasi data selesai dan diverifikasi, perbarui host seed:
   1. Menghapus multiRegionSeedHost: 10.0.0.11 dari overrides-DATACENTER_NAME.yaml.

   2. Terapkan kembali perubahan untuk memperbarui CR datastore apigee:

      helm upgrade datastore apigee-datastore/ \
        --install \
        --namespace APIGEE_NAMESPACE \
        --atomic \
        -f overrides-DATACENTER_NAME.yaml
      

9. Verifikasi proses build ulang dari log. Selain itu, verifikasi ukuran data menggunakan perintah nodetool status.
   Catatan: Jika operasi pembuatan ulang menunjukkan status selesai dan log proses pembuatan ulang berisi "Semua sesi selesai", semua data telah berhasil disalin ke region baru.

   kubectl logs apigee-cassandra-default-0 -f -n APIGEE_NAMESPACE

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Tips: APIGEE_JMX_USER dan APIGEE_JMX_PASSWORD biasanya ditentukan dalam variabel lingkungan $APIGEE_JMX_USER dan $APIGEE_JMX_PASSWORD.

   Contoh berikut menunjukkan contoh entri log:

   INFO  01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens)
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB)
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed

Memeriksa status cluster Cassandra

Perintah berikut berguna untuk melihat apakah penyiapan cluster berhasil di dua pusat data. Perintah ini memeriksa status nodetool untuk kedua region.

kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status


Datacenter: dc-1
=======================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.12.1.45  112.09 KiB  256          100.0%            3c98c816-3f4d-48f0-9717-03d0c998637f  ra-1
UN  10.12.4.36  95.27 KiB  256          100.0%            0a36383d-1d9e-41e2-924c-7b62be12d6cc  ra-1
UN  10.12.5.22  88.7 KiB   256          100.0%            3561f4fa-af3d-4ea4-93b2-79ac7e938201  ra-1
Datacenter: us-west1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.0.4.33   78.69 KiB  256          100.0%              a200217d-260b-45cd-b83c-182b27ff4c99  ra-1
UN  10.0.0.21   78.68 KiB  256          100.0%              9f3364b9-a7a1-409c-9356-b7d1d312e52b  ra-1
UN  10.0.1.26   15.46 KiB  256          100.0%              1666df0f-702e-4c5b-8b6e-086d0f2e47fa  ra-1

AKS

Penting: Saat memperluas Apigee hybrid ke datacenter regional baru, pastikan untuk menginstal versi hybrid yang sama seperti yang Anda miliki di datacenter yang ada. Hindari menjalankan versi campuran yang berbeda di beberapa datacenter.

Peringatan: Jika penginstalan gagal untuk region baru, jangan lanjutkan penginstalan region. Sebagai gantinya, hapus dan buat ulang penginstalan campuran di wilayah yang gagal.

Membuat jaringan virtual di setiap region

Ikuti rekomendasi Azure untuk membuat komunikasi lintas region di sini: VNet-to-VNet: Menghubungkan Virtual Network di Azure di Berbagai Region.

Membuat cluster multi-regional

Siapkan cluster Kubernetes di beberapa region dengan blok CIDR yang berbeda. Lihat juga Langkah 1: Membuat cluster. Gunakan lokasi dan nama jaringan virtual yang Anda buat sebelumnya.

Buka port Cassandra di antara cluster Kubernetes di semua region untuk memungkinkan node pekerja di seluruh region dan pusat data berkomunikasi. Lihat Mengonfigurasi port untuk mengetahui nomor port Cassandra.

Mengonfigurasi host seed multi-region

Bagian ini menjelaskan cara memperluas cluster Cassandra yang ada ke region baru. Penyiapan ini memungkinkan region baru mem-bootstrap cluster dan bergabung dengan pusat data yang ada. Tanpa konfigurasi ini, cluster Kubernetes multi-region tidak akan saling mengetahui.

1. Untuk region pertama yang dibuat, dapatkan pod di namespace apigee Anda:

   kubectl get pods -o wide -n APIGEE_NAMESPACE
   

2. Identifikasi alamat host seed multi-region untuk Cassandra di region ini, misalnya 10.0.0.11.

3. Siapkan file overrides.yaml untuk region kedua dan tambahkan alamat IP host seed sebagai berikut:

   cassandra:
     multiRegionSeedHost: "SEED_HOST_IP_ADDRESS"
     datacenter: "DATACENTER_NAME"
     rack: "RACK_NAME"
     hostNetwork: false
     clusterName: CLUSTER_NAME

   Ganti kode berikut:

   • SEED_HOST_IP_ADDRESS dengan alamat IP host seed, misalnya 10.0.0.11.
   • DATACENTER_NAME dengan nama pusat data, misalnya dc-2.
   • RACK_NAME dengan nama rak, misalnya ra-1.
   • CLUSTER_NAME dengan nama cluster Cassandra Anda. Secara default, nilainya adalah apigeecluster. Jika menggunakan nama cluster yang berbeda, Anda harus menentukan nilai untuk cassandra.clusterName. Anda bebas memilih nilai sendiri, tetapi nilai tersebut harus sama di semua wilayah.

Mengonfigurasi region kedua

Untuk menyiapkan wilayah baru:

1. Instal cert-manager di region kedua.

2. Salin sertifikat Anda dari cluster yang ada ke cluster baru. Root CA baru digunakan oleh Cassandra dan komponen campuran lainnya untuk mTLS. Oleh karena itu, penting untuk memiliki sertifikat yang konsisten di seluruh cluster.

   1. Tetapkan konteks ke namespace asli:

      kubectl config use-context ORIGINAL_CLUSTER_NAME
      

   2. Ekspor konfigurasi namespace saat ini ke file:

      kubectl get namespace APIGEE_NAMESPACE -o yaml > apigee-namespace.yaml
      

   3. Ekspor secret apigee-ca ke file:

      kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
      

   4. Tetapkan konteks ke nama cluster region baru:

      kubectl config use-context NEW_CLUSTER_NAME
      

   5. Impor konfigurasi namespace ke cluster baru. Pastikan untuk memperbarui namespace dalam file jika Anda menggunakan namespace yang berbeda di region baru:

      kubectl apply -f apigee-namespace.yaml
      

   6. Impor secret ke cluster baru:

      kubectl -n cert-manager apply -f apigee-ca.yaml
      

3. Ikuti langkah-langkah untuk Menginstal CRD hybrid Apigee ke wilayah baru.

4. Sekarang, gunakan diagram Helm untuk menginstal Apigee hybrid di region baru dengan perintah Diagram Helm berikut (seperti yang dilakukan di region 1):

   Catatan: Anda dapat menggunakan CRD yang sama untuk konsistensi dengan menggunakan folder yang sama tempat Anda mendownload diagram, Anda juga dapat membuat file penggantian unik antara region 1 dan 2 dengan memberi nama penggantian sesuatu yang unik seperti overrides-region_name.yaml, dll.

   helm upgrade operator apigee-operator \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade datastore apigee-datastore \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade telemetry apigee-telemetry \
     --install \
     --namespace APIGEE_NAMESPACE> \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade redis apigee-redis \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ingress-manager apigee-ingress-manager \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ORG_NAME apigee-org \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env mentioned on the overrides
   helm upgrade ENV_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set env=ENV_NAME \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env group mentioned on the overrides
   helm upgrade apigee-virtualhost-ENV_GROUP_NAME apigee-virtualhost/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set envgroup=ENV_GROUP_NAME \
     -f overrides-DATACENTER_NAME.yaml
   

5. Verifikasi penyiapan cluster Cassandra dengan menjalankan perintah berikut. Output akan menampilkan pusat data yang ada dan baru.
   Peringatan: Jika output perintah ini tidak menampilkan data center yang ada dan baru, penyiapan akan gagal. Dalam hal ini, jangan melanjutkan lebih lanjut.

   Untuk memperbaiki masalah ini, penginstalan campuran di wilayah baru harus dihapus dan dibuat ulang. Lihat Meng-uninstal runtime campuran. Jika penyiapan gagal, jangan mencoba melanjutkan atau mencoba bergabung ke cluster.

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  \
   -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Contoh yang menunjukkan penyiapan yang berhasil:

   Datacenter: dc-1
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.87.93   68.07 GiB  256     ?     fb51465c-167a-42f7-98c9-b6eba1de34de  c
   UN  10.132.84.94   69.9 GiB   256     ?     f621a5ac-e7ee-48a9-9a14-73d69477c642  b
   UN  10.132.84.105  76.95 GiB  256     ?     0561086f-e95b-4232-ba6c-ad519ff30336  d
   
   Datacenter: dc-2
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.0.8     71.61 GiB  256     ?     8894a98b-8406-45de-99e2-f404ab10b5d6  c
   UN  10.132.9.204   75.1 GiB   256     ?     afa0ffa3-630b-4f1e-b46f-fc3df988092e  a
   UN  10.132.3.133   68.08 GiB  256     ?     25ae39ab-b39e-4d4f-9cb7-de095ab873db  b

6. Siapkan Cassandra di semua pod di pusat data baru.
   1. Dapatkan apigeeorg dari cluster dengan perintah berikut:

      kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      

      Contoh:

      Ex: kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      "rg-hybrid-b7d3b9c"
      

   2. Buat file resource kustom (YAML) replikasi data cassandra. File dapat bernama apa saja. Dalam contoh berikut, file akan memiliki nama datareplication.yaml.

      File harus berisi hal berikut:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: REGION_EXPANSION
        namespace: NAMESPACE
      spec:
        organizationRef: APIGEEORG_VALUE
        force: false
        source:
          region: SOURCE_REGION

      Dengan keterangan:

      • REGION_EXPANSION adalah nama yang Anda berikan ke metadata ini. Anda dapat menggunakan nama apa pun.
      • NAMESPACE adalah namespace yang sama dengan yang disediakan di overrides.yaml. Nilai ini biasanya "apigee".
      • APIGEEORG_VALUE adalah output nilai dari perintah kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name" di langkah sebelumnya. Misalnya, rg-hybrid-b7d3b9c
      • SOURCE_REGION adalah region sumber, nilai datacenter di bagian cassandra dari overrides.yaml region sumber

      Contoh:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: region-expansion
        namespace: apigee
      spec:
        organizationRef: rg-hybrid-b7d3b9c
        force: false
        source:
          region: "dc-1"

   3. Terapkan CassandraDataReplication dengan perintah berikut:

      kubectl apply -f datareplication.yaml

7. Verifikasi status build ulang menggunakan perintah berikut.
   Catatan: Operasi pembuatan ulang dapat memerlukan waktu hingga beberapa jam, bergantung pada ukuran data.

   kubectl -n APIGEE_NAMESPACE get apigeeds -o json | jq ".items[].status.cassandraDataReplication"

   Hasilnya akan terlihat seperti ini:

   {
   "rebuildDetails": {
   "apigee-cassandra-default-0": {
   "state": "complete",
   "updated": 1623105760
   },
   "apigee-cassandra-default-1": {
   "state": "complete",
   "updated": 1623105765
   },
   "apigee-cassandra-default-2": {
   "state": "complete",
   "updated": 1623105770
   }
   },
   "state": "complete",
   "updated": 1623105770
   }

8. Setelah replikasi data selesai dan diverifikasi, perbarui host seed:
   1. Menghapus multiRegionSeedHost: 10.0.0.11 dari overrides-DATACENTER_NAME.yaml.

   2. Terapkan kembali perubahan untuk memperbarui CR datastore apigee:

      helm upgrade datastore apigee-datastore/ \
        --install \
        --namespace APIGEE_NAMESPACE \
        --atomic \
        -f overrides-DATACENTER_NAME.yaml
      

9. Verifikasi proses build ulang dari log. Selain itu, verifikasi ukuran data menggunakan perintah nodetool status.
   Catatan: Jika operasi pembuatan ulang menunjukkan status selesai dan log proses pembuatan ulang berisi "Semua sesi selesai", semua data telah berhasil disalin ke region baru.

   kubectl logs apigee-cassandra-default-0 -f -n APIGEE_NAMESPACE

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Tips: APIGEE_JMX_USER dan APIGEE_JMX_PASSWORD biasanya ditentukan dalam variabel lingkungan $APIGEE_JMX_USER dan $APIGEE_JMX_PASSWORD.

   Contoh berikut menunjukkan contoh entri log:

   INFO  01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens)
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB)
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed

Memeriksa status cluster Cassandra

Perintah berikut berguna untuk melihat apakah penyiapan cluster berhasil di dua pusat data. Perintah ini memeriksa status nodetool untuk kedua region.

kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status


Datacenter: dc-1
=======================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.12.1.45  112.09 KiB  256          100.0%            3c98c816-3f4d-48f0-9717-03d0c998637f  ra-1
UN  10.12.4.36  95.27 KiB  256          100.0%            0a36383d-1d9e-41e2-924c-7b62be12d6cc  ra-1
UN  10.12.5.22  88.7 KiB   256          100.0%            3561f4fa-af3d-4ea4-93b2-79ac7e938201  ra-1
Datacenter: us-west1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.0.4.33   78.69 KiB  256          100.0%              a200217d-260b-45cd-b83c-182b27ff4c99  ra-1
UN  10.0.0.21   78.68 KiB  256          100.0%              9f3364b9-a7a1-409c-9356-b7d1d312e52b  ra-1
UN  10.0.1.26   15.46 KiB  256          100.0%              1666df0f-702e-4c5b-8b6e-086d0f2e47fa  ra-1

EKS

Penting: Saat memperluas Apigee hybrid ke datacenter regional baru, pastikan untuk menginstal versi hybrid yang sama seperti yang Anda miliki di datacenter yang ada. Hindari menjalankan versi campuran yang berbeda di beberapa datacenter. Pembatasan ini tidak berlaku saat mengupgrade beberapa pusat data ke versi baru.

Peringatan: Jika penginstalan gagal untuk region baru, jangan lanjutkan penginstalan region. Sebagai gantinya, hapus dan buat ulang penginstalan campuran di wilayah yang gagal.

Membuat jaringan virtual di setiap region

Ikuti rekomendasi AWS untuk membuat komunikasi lintas region seperti yang dijelaskan dalam: Apa yang dimaksud dengan peering VPC?. Istilah AWS untuk menggunakan region yang berbeda adalah peering VPC antar-Region.

Membuat cluster multi-regional

Siapkan cluster Kubernetes di beberapa region dengan blok CIDR yang berbeda. Lihat juga Langkah 1: Membuat cluster. Gunakan lokasi dan nama jaringan virtual yang Anda buat sebelumnya.

Buka port Cassandra di antara cluster Kubernetes di semua region untuk memungkinkan node pekerja di seluruh region dan pusat data berkomunikasi. Lihat Mengonfigurasi port untuk mengetahui nomor port Cassandra.

Mengonfigurasi host seed multi-region

Bagian ini menjelaskan cara memperluas cluster Cassandra yang ada ke region baru. Penyiapan ini memungkinkan region baru mem-bootstrap cluster dan bergabung dengan pusat data yang ada. Tanpa konfigurasi ini, cluster Kubernetes multi-region tidak akan saling mengetahui.

1. Untuk region pertama yang dibuat, dapatkan pod di namespace apigee Anda:

   kubectl get pods -o wide -n APIGEE_NAMESPACE
   

2. Identifikasi alamat host seed multi-region untuk Cassandra di region ini, misalnya 10.0.0.11.

3. Siapkan file overrides.yaml untuk region kedua dan tambahkan alamat IP host seed sebagai berikut:

   cassandra:
     multiRegionSeedHost: "SEED_HOST_IP_ADDRESS"
     datacenter: "DATACENTER_NAME"
     rack: "RACK_NAME"
     hostNetwork: false
     clusterName: CLUSTER_NAME

   Ganti kode berikut:

   • SEED_HOST_IP_ADDRESS dengan alamat IP host seed, misalnya 10.0.0.11.
   • DATACENTER_NAME dengan nama pusat data, misalnya dc-2.
   • RACK_NAME dengan nama rak, misalnya ra-1.
   • CLUSTER_NAME dengan nama cluster Cassandra Anda. Secara default, nilainya adalah apigeecluster. Jika menggunakan nama cluster yang berbeda, Anda harus menentukan nilai untuk cassandra.clusterName. Anda bebas memilih nilai sendiri, tetapi nilai tersebut harus sama di semua wilayah.

Mengonfigurasi region kedua

Untuk menyiapkan wilayah baru:

1. Instal cert-manager di region kedua.

2. Salin sertifikat Anda dari cluster yang ada ke cluster baru. Root CA baru digunakan oleh Cassandra dan komponen campuran lainnya untuk mTLS. Oleh karena itu, penting untuk memiliki sertifikat yang konsisten di seluruh cluster.

   1. Tetapkan konteks ke namespace asli:

      kubectl config use-context ORIGINAL_CLUSTER_NAME
      

   2. Ekspor konfigurasi namespace saat ini ke file:

      kubectl get namespace APIGEE_NAMESPACE -o yaml > apigee-namespace.yaml
      

   3. Ekspor secret apigee-ca ke file:

      kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
      

   4. Tetapkan konteks ke nama cluster region baru:

      kubectl config use-context NEW_CLUSTER_NAME
      

   5. Impor konfigurasi namespace ke cluster baru. Pastikan untuk memperbarui namespace dalam file jika Anda menggunakan namespace yang berbeda di region baru:

      kubectl apply -f apigee-namespace.yaml
      

   6. Impor secret ke cluster baru:

      kubectl -n cert-manager apply -f apigee-ca.yaml
      

3. Ikuti langkah-langkah untuk Menginstal CRD hybrid Apigee ke wilayah baru.

4. Sekarang, gunakan diagram Helm untuk menginstal Apigee hybrid di region baru dengan perintah Diagram Helm berikut (seperti yang dilakukan di region 1):

   Catatan: Anda dapat menggunakan CRD yang sama untuk konsistensi dengan menggunakan folder yang sama tempat Anda mendownload diagram, Anda juga dapat membuat file penggantian unik antara region 1 dan 2 dengan memberi nama penggantian sesuatu yang unik seperti overrides-region_name.yaml, dll.

   helm upgrade operator apigee-operator \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade datastore apigee-datastore \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade telemetry apigee-telemetry \
     --install \
     --namespace APIGEE_NAMESPACE> \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade redis apigee-redis \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ingress-manager apigee-ingress-manager \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ORG_NAME apigee-org \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env mentioned on the overrides
   helm upgrade ENV_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set env=ENV_NAME \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env group mentioned on the overrides
   helm upgrade apigee-virtualhost-ENV_GROUP_NAME apigee-virtualhost/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set envgroup=ENV_GROUP_NAME \
     -f overrides-DATACENTER_NAME.yaml
   

5. Verifikasi penyiapan cluster Cassandra dengan menjalankan perintah berikut. Output akan menampilkan pusat data yang ada dan baru.
   Peringatan: Jika output perintah ini tidak menampilkan data center yang ada dan baru, penyiapan akan gagal. Dalam hal ini, jangan melanjutkan lebih lanjut.

   Untuk memperbaiki masalah ini, penginstalan campuran di wilayah baru harus dihapus dan dibuat ulang. Lihat Meng-uninstal runtime campuran. Jika penyiapan gagal, jangan mencoba melanjutkan atau mencoba bergabung ke cluster.

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  \
   -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Contoh yang menunjukkan penyiapan yang berhasil:

   Datacenter: dc-1
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.87.93   68.07 GiB  256     ?     fb51465c-167a-42f7-98c9-b6eba1de34de  c
   UN  10.132.84.94   69.9 GiB   256     ?     f621a5ac-e7ee-48a9-9a14-73d69477c642  b
   UN  10.132.84.105  76.95 GiB  256     ?     0561086f-e95b-4232-ba6c-ad519ff30336  d
   
   Datacenter: dc-2
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.0.8     71.61 GiB  256     ?     8894a98b-8406-45de-99e2-f404ab10b5d6  c
   UN  10.132.9.204   75.1 GiB   256     ?     afa0ffa3-630b-4f1e-b46f-fc3df988092e  a
   UN  10.132.3.133   68.08 GiB  256     ?     25ae39ab-b39e-4d4f-9cb7-de095ab873db  b

6. Siapkan Cassandra di semua pod di pusat data baru.
   1. Dapatkan apigeeorg dari cluster dengan perintah berikut:

      kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      

      Contoh:

      Ex: kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      "rg-hybrid-b7d3b9c"
      

   2. Buat file resource kustom (YAML) replikasi data cassandra. File dapat bernama apa saja. Dalam contoh berikut, file akan memiliki nama datareplication.yaml.

      File harus berisi hal berikut:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: REGION_EXPANSION
        namespace: NAMESPACE
      spec:
        organizationRef: APIGEEORG_VALUE
        force: false
        source:
          region: SOURCE_REGION

      Dengan keterangan:

      • REGION_EXPANSION adalah nama yang Anda berikan ke metadata ini. Anda dapat menggunakan nama apa pun.
      • NAMESPACE adalah namespace yang sama dengan yang disediakan di overrides.yaml. Nilai ini biasanya "apigee".
      • APIGEEORG_VALUE adalah output nilai dari perintah kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name" di langkah sebelumnya. Misalnya, rg-hybrid-b7d3b9c
      • SOURCE_REGION adalah region sumber, nilai datacenter di bagian cassandra dari overrides.yaml region sumber

      Contoh:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: region-expansion
        namespace: apigee
      spec:
        organizationRef: rg-hybrid-b7d3b9c
        force: false
        source:
          region: "dc-1"

   3. Terapkan CassandraDataReplication dengan perintah berikut:

      kubectl apply -f datareplication.yaml

7. Verifikasi status build ulang menggunakan perintah berikut.
   Catatan: Operasi pembuatan ulang dapat memerlukan waktu hingga beberapa jam, bergantung pada ukuran data.

   kubectl -n APIGEE_NAMESPACE get apigeeds -o json | jq ".items[].status.cassandraDataReplication"

   Hasilnya akan terlihat seperti ini:

   {
   "rebuildDetails": {
   "apigee-cassandra-default-0": {
   "state": "complete",
   "updated": 1623105760
   },
   "apigee-cassandra-default-1": {
   "state": "complete",
   "updated": 1623105765
   },
   "apigee-cassandra-default-2": {
   "state": "complete",
   "updated": 1623105770
   }
   },
   "state": "complete",
   "updated": 1623105770
   }

8. Setelah replikasi data selesai dan diverifikasi, perbarui host seed:
   1. Menghapus multiRegionSeedHost: 10.0.0.11 dari overrides-DATACENTER_NAME.yaml.

   2. Terapkan kembali perubahan untuk memperbarui CR datastore apigee:

      helm upgrade datastore apigee-datastore/ \
        --install \
        --namespace APIGEE_NAMESPACE \
        --atomic \
        -f overrides-DATACENTER_NAME.yaml
      

9. Verifikasi proses build ulang dari log. Selain itu, verifikasi ukuran data menggunakan perintah nodetool status.
   Catatan: Jika operasi pembuatan ulang menunjukkan status selesai dan log proses pembuatan ulang berisi "Semua sesi selesai", semua data telah berhasil disalin ke region baru.

   kubectl logs apigee-cassandra-default-0 -f -n APIGEE_NAMESPACE

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Tips: APIGEE_JMX_USER dan APIGEE_JMX_PASSWORD biasanya ditentukan dalam variabel lingkungan $APIGEE_JMX_USER dan $APIGEE_JMX_PASSWORD.

   Contoh berikut menunjukkan contoh entri log:

   INFO  01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens)
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB)
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed

Memeriksa status cluster Cassandra

Perintah berikut berguna untuk melihat apakah penyiapan cluster berhasil di dua pusat data. Perintah ini memeriksa status nodetool untuk kedua region.

kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status


Datacenter: dc-1
=======================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.12.1.45  112.09 KiB  256          100.0%            3c98c816-3f4d-48f0-9717-03d0c998637f  ra-1
UN  10.12.4.36  95.27 KiB  256          100.0%            0a36383d-1d9e-41e2-924c-7b62be12d6cc  ra-1
UN  10.12.5.22  88.7 KiB   256          100.0%            3561f4fa-af3d-4ea4-93b2-79ac7e938201  ra-1
Datacenter: us-west1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.0.4.33   78.69 KiB  256          100.0%              a200217d-260b-45cd-b83c-182b27ff4c99  ra-1
UN  10.0.0.21   78.68 KiB  256          100.0%              9f3364b9-a7a1-409c-9356-b7d1d312e52b  ra-1
UN  10.0.1.26   15.46 KiB  256          100.0%              1666df0f-702e-4c5b-8b6e-086d0f2e47fa  ra-1

OpenShift

Penting: Saat memperluas Apigee hybrid ke datacenter regional baru, pastikan untuk menginstal versi hybrid yang sama seperti yang Anda miliki di datacenter yang ada. Hindari menjalankan versi campuran yang berbeda di beberapa datacenter.

Peringatan: Jika penginstalan gagal untuk region baru, jangan lanjutkan penginstalan region. Sebagai gantinya, hapus dan buat ulang penginstalan campuran di wilayah yang gagal.

Mengonfigurasi host seed multi-region

Bagian ini menjelaskan cara memperluas cluster Cassandra yang ada ke region baru. Penyiapan ini memungkinkan region baru mem-bootstrap cluster dan bergabung dengan pusat data yang ada. Tanpa konfigurasi ini, cluster Kubernetes multi-region tidak akan saling mengetahui.

1. Untuk region pertama yang dibuat, dapatkan pod di namespace apigee Anda:

   kubectl get pods -o wide -n APIGEE_NAMESPACE
   

2. Identifikasi alamat host seed multi-region untuk Cassandra di region ini, misalnya 10.0.0.11.

3. Siapkan file overrides.yaml untuk region kedua dan tambahkan alamat IP host seed sebagai berikut:

   cassandra:
     multiRegionSeedHost: "SEED_HOST_IP_ADDRESS"
     datacenter: "DATACENTER_NAME"
     rack: "RACK_NAME"
     hostNetwork: false
     clusterName: CLUSTER_NAME

   Ganti kode berikut:

   • SEED_HOST_IP_ADDRESS dengan alamat IP host seed, misalnya 10.0.0.11.
   • DATACENTER_NAME dengan nama pusat data, misalnya dc-2.
   • RACK_NAME dengan nama rak, misalnya ra-1.
   • CLUSTER_NAME dengan nama cluster Cassandra Anda. Secara default, nilainya adalah apigeecluster. Jika menggunakan nama cluster yang berbeda, Anda harus menentukan nilai untuk cassandra.clusterName. Anda bebas memilih nilai sendiri, tetapi nilai tersebut harus sama di semua wilayah.

Mengonfigurasi region kedua

Untuk menyiapkan wilayah baru:

1. Instal cert-manager di region kedua.

2. Salin sertifikat Anda dari cluster yang ada ke cluster baru. Root CA baru digunakan oleh Cassandra dan komponen campuran lainnya untuk mTLS. Oleh karena itu, penting untuk memiliki sertifikat yang konsisten di seluruh cluster.

   1. Tetapkan konteks ke namespace asli:

      kubectl config use-context ORIGINAL_CLUSTER_NAME
      

   2. Ekspor konfigurasi namespace saat ini ke file:

      kubectl get namespace APIGEE_NAMESPACE -o yaml > apigee-namespace.yaml
      

   3. Ekspor secret apigee-ca ke file:

      kubectl -n cert-manager get secret apigee-ca -o yaml > apigee-ca.yaml
      

   4. Tetapkan konteks ke nama cluster region baru:

      kubectl config use-context NEW_CLUSTER_NAME
      

   5. Impor konfigurasi namespace ke cluster baru. Pastikan untuk memperbarui namespace dalam file jika Anda menggunakan namespace yang berbeda di region baru:

      kubectl apply -f apigee-namespace.yaml
      

   6. Impor secret ke cluster baru:

      kubectl -n cert-manager apply -f apigee-ca.yaml
      

3. Ikuti langkah-langkah untuk Menginstal CRD hybrid Apigee ke wilayah baru.

4. Sekarang, gunakan diagram Helm untuk menginstal Apigee hybrid di region baru dengan perintah Diagram Helm berikut (seperti yang dilakukan di region 1):

   Catatan: Anda dapat menggunakan CRD yang sama untuk konsistensi dengan menggunakan folder yang sama tempat Anda mendownload diagram, Anda juga dapat membuat file penggantian unik antara region 1 dan 2 dengan memberi nama penggantian sesuatu yang unik seperti overrides-region_name.yaml, dll.

   helm upgrade operator apigee-operator \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade datastore apigee-datastore \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade telemetry apigee-telemetry \
     --install \
     --namespace APIGEE_NAMESPACE> \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade redis apigee-redis \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ingress-manager apigee-ingress-manager \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   helm upgrade ORG_NAME apigee-org \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env mentioned on the overrides
   helm upgrade ENV_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set env=ENV_NAME \
     -f overrides-DATACENTER_NAME.yaml
   # repeat the below command for each env group mentioned on the overrides
   helm upgrade apigee-virtualhost-ENV_GROUP_NAME apigee-virtualhost/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     --set envgroup=ENV_GROUP_NAME \
     -f overrides-DATACENTER_NAME.yaml
   

5. Verifikasi penyiapan cluster Cassandra dengan menjalankan perintah berikut. Output akan menampilkan pusat data yang ada dan baru.
   Peringatan: Jika output perintah ini tidak menampilkan data center yang ada dan baru, penyiapan akan gagal. Dalam hal ini, jangan melanjutkan lebih lanjut.

   Untuk memperbaiki masalah ini, penginstalan campuran di wilayah baru harus dihapus dan dibuat ulang. Lihat Meng-uninstal runtime campuran. Jika penyiapan gagal, jangan mencoba melanjutkan atau mencoba bergabung ke cluster.

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  \
   -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Contoh yang menunjukkan penyiapan yang berhasil:

   Datacenter: dc-1
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.87.93   68.07 GiB  256     ?     fb51465c-167a-42f7-98c9-b6eba1de34de  c
   UN  10.132.84.94   69.9 GiB   256     ?     f621a5ac-e7ee-48a9-9a14-73d69477c642  b
   UN  10.132.84.105  76.95 GiB  256     ?     0561086f-e95b-4232-ba6c-ad519ff30336  d
   
   Datacenter: dc-2
   ====================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address        Load       Tokens  Owns  Host ID                               Rack
   UN  10.132.0.8     71.61 GiB  256     ?     8894a98b-8406-45de-99e2-f404ab10b5d6  c
   UN  10.132.9.204   75.1 GiB   256     ?     afa0ffa3-630b-4f1e-b46f-fc3df988092e  a
   UN  10.132.3.133   68.08 GiB  256     ?     25ae39ab-b39e-4d4f-9cb7-de095ab873db  b

6. Siapkan Cassandra di semua pod di pusat data baru.
   1. Dapatkan apigeeorg dari cluster dengan perintah berikut:

      kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      

      Contoh:

      Ex: kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name"
      "rg-hybrid-b7d3b9c"
      

   2. Buat file resource kustom (YAML) replikasi data cassandra. File dapat bernama apa saja. Dalam contoh berikut, file akan memiliki nama datareplication.yaml.

      File harus berisi hal berikut:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: REGION_EXPANSION
        namespace: NAMESPACE
      spec:
        organizationRef: APIGEEORG_VALUE
        force: false
        source:
          region: SOURCE_REGION

      Dengan keterangan:

      • REGION_EXPANSION adalah nama yang Anda berikan ke metadata ini. Anda dapat menggunakan nama apa pun.
      • NAMESPACE adalah namespace yang sama dengan yang disediakan di overrides.yaml. Nilai ini biasanya "apigee".
      • APIGEEORG_VALUE adalah output nilai dari perintah kubectl get apigeeorg -n APIGEE_NAMESPACE -o json | jq ".items[].metadata.name" di langkah sebelumnya. Misalnya, rg-hybrid-b7d3b9c
      • SOURCE_REGION adalah region sumber, nilai datacenter di bagian cassandra dari overrides.yaml region sumber

      Contoh:

      apiVersion: apigee.cloud.google.com/v1alpha1
      kind: CassandraDataReplication
      metadata:
        name: region-expansion
        namespace: apigee
      spec:
        organizationRef: rg-hybrid-b7d3b9c
        force: false
        source:
          region: "dc-1"

   3. Terapkan CassandraDataReplication dengan perintah berikut:

      kubectl apply -f datareplication.yaml

7. Verifikasi status build ulang menggunakan perintah berikut.
   Catatan: Operasi pembuatan ulang dapat memerlukan waktu hingga beberapa jam, bergantung pada ukuran data.

   kubectl -n APIGEE_NAMESPACE get apigeeds -o json | jq ".items[].status.cassandraDataReplication"

   Hasilnya akan terlihat seperti ini:

   {
   "rebuildDetails": {
   "apigee-cassandra-default-0": {
   "state": "complete",
   "updated": 1623105760
   },
   "apigee-cassandra-default-1": {
   "state": "complete",
   "updated": 1623105765
   },
   "apigee-cassandra-default-2": {
   "state": "complete",
   "updated": 1623105770
   }
   },
   "state": "complete",
   "updated": 1623105770
   }

8. Setelah replikasi data selesai dan diverifikasi, perbarui host seed:
   1. Menghapus multiRegionSeedHost: 10.0.0.11 dari overrides-DATACENTER_NAME.yaml.

   2. Terapkan kembali perubahan untuk memperbarui CR datastore apigee:

      helm upgrade datastore apigee-datastore/ \
        --install \
        --namespace APIGEE_NAMESPACE \
        --atomic \
        -f overrides-DATACENTER_NAME.yaml
      

9. Verifikasi proses build ulang dari log. Selain itu, verifikasi ukuran data menggunakan perintah nodetool status.
   Catatan: Jika operasi pembuatan ulang menunjukkan status selesai dan log proses pembuatan ulang berisi "Semua sesi selesai", semua data telah berhasil disalin ke region baru.

   kubectl logs apigee-cassandra-default-0 -f -n APIGEE_NAMESPACE

   kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status

   Tips: APIGEE_JMX_USER dan APIGEE_JMX_PASSWORD biasanya ditentukan dalam variabel lingkungan $APIGEE_JMX_USER dan $APIGEE_JMX_PASSWORD.

   Contoh berikut menunjukkan contoh entri log:

   INFO  01:42:24 rebuild from dc: dc-1, (All keyspaces), (All tokens)
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Executing streaming plan for Rebuild
   INFO  01:42:24 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.1.45
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.432KiB), sending 0 files(0.000KiB)
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.1.45 is complete
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.4.36
   INFO  01:42:25 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Starting streaming to /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 1 files(0.693KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.4.36 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889, ID#0] Beginning stream session with /10.12.5.22
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889 ID#0] Prepare completed. Receiving 3 files(0.720KiB), sending 0 files(0.000KiB)
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] Session with /10.12.5.22 is complete
   INFO  01:42:26 [Stream #3a04e810-580d-11e9-a5aa-67071bf82889] All sessions completed

Memeriksa status cluster Cassandra

Perintah berikut berguna untuk melihat apakah penyiapan cluster berhasil di dua pusat data. Perintah ini memeriksa status nodetool untuk kedua region.

kubectl exec apigee-cassandra-default-0 -n APIGEE_NAMESPACE  -- nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status


Datacenter: dc-1
=======================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.12.1.45  112.09 KiB  256          100.0%            3c98c816-3f4d-48f0-9717-03d0c998637f  ra-1
UN  10.12.4.36  95.27 KiB  256          100.0%            0a36383d-1d9e-41e2-924c-7b62be12d6cc  ra-1
UN  10.12.5.22  88.7 KiB   256          100.0%            3561f4fa-af3d-4ea4-93b2-79ac7e938201  ra-1
Datacenter: us-west1
====================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load       Tokens       Owns (effective)  Host ID                               Rack
UN  10.0.4.33   78.69 KiB  256          100.0%              a200217d-260b-45cd-b83c-182b27ff4c99  ra-1
UN  10.0.0.21   78.68 KiB  256          100.0%              9f3364b9-a7a1-409c-9356-b7d1d312e52b  ra-1
UN  10.0.1.26   15.46 KiB  256          100.0%              1666df0f-702e-4c5b-8b6e-086d0f2e47fa  ra-1

Pemecahan masalah

Lihat Kegagalan replikasi data Cassandra.