Menambahkan beberapa organisasi hybrid ke cluster

Saat ini Anda melihat versi 1.11 dari dokumentasi Apigee Hybrid. This version is end of life. You should upgrade to a newer version. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.11 

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Topik ini membahas cara menambahkan organisasi (org.) Apigee hybrid kedua ke cluster Kubernetes yang sudah ada. Dalam konfigurasi multi-org ini, kedua org menggunakan dan membagikan ring Cassandra yang sama. Setiap org dapat memiliki beberapa lingkungan dan grup lingkungan yang dikonfigurasi.

Peringatan: Konfigurasi multi-org per cluster didukung dengan batasan tertentu. Hingga keterbatasan ini diatasi, sebaiknya Anda tidak menggunakan konfigurasi ini.

Catatan: Jika Anda sudah menggunakan cluster multi-org dan ingin memigrasikan organisasi ke cluster org tunggal, lihat Memigrasikan organisasi ke cluster lain.

Batasan

Konfigurasi multi-org per cluster didukung dengan batasan berikut. Hingga batasan ini diatasi, sebaiknya Anda tidak menggunakan konfigurasi ini:

Catatan: Jumlah maksimum organisasi yang dapat Anda tambahkan ke satu cluster dibatasi. Lihat Batas untuk mengetahui detailnya.

• Jika Anda akan memiliki beberapa instance hybrid Apigee, setiap instance harus memiliki cluster-nya sendiri. Beberapa instance hybrid Apigee yang berjalan di cluster kubernetes yang sama dapat menyebabkan masalah ketidakstabilan yang berpotensi menyebabkan periode nonaktif.
• Semua logging dari pod dikirim ke project Google Cloud pertama yang dikonfigurasi. Batasan ini paling terlihat di alat Cloud Logging. Log untuk organisasi Apigee lainnya tidak akan dikirim ke project Google Cloud yang cocok. Log masih dicatat di tingkat pod dan dapat diambil dengan perintah kubectl. Namun, log tersebut tidak dikirim ke project Cloud yang benar melalui Cloud Logging.
• Anda tidak dapat menghapus data organisasi di database Cassandra hanya untuk satu organisasi. Artinya, Anda tidak dapat menghapus organisasi secara selektif. Setiap modifikasi pada konfigurasi database akan memengaruhi semua organisasi yang di-deploy ke cluster tersebut.
• Prosedur upgrade hybrid mengupgrade seluruh cluster sekaligus.
• Pencadangan dan pemulihan dilakukan sebagai cluster, dan tidak dapat dilakukan untuk organisasi tertentu.
• Fitur Pemantauan API Apigee (Linimasa, Terbaru, Selidiki) hanya berfungsi untuk organisasi pertama yang dikonfigurasi dan di-deploy. Hal ini tidak akan berfungsi untuk organisasi lain dalam cluster multi-organisasi.

Opsi multi-org

Bagian ini menjelaskan cara Dukungan Apigee menangani cluster multi-org yang ada dan rekomendasi untuk deployment mendatang:

• Jika Anda memiliki cluster Kubernetes multi-org yang sudah di-deploy dalam konteks non-produksi dan produksi, Dukungan Apigee akan terus mendukungnya. Namun, perhatikan batasan teknis yang diuraikan di bagian berikutnya. Sebaiknya ubah semua deployment produksi mendatang agar menggunakan satu org Apigee per cluster.
• Jika Anda memiliki cluster multi-org yang ada dalam konteks non-produksi, Dukungan Apigee akan terus mendukungnya. Sebaiknya Anda memigrasikan semua cluster produksi ke konfigurasi baru yang menggunakan satu organisasi Apigee per cluster.

Prasyarat

Sebelum melanjutkan, perhatikan hal berikut:

• Anda harus memiliki organisasi hybrid yang sudah ada dengan satu atau beberapa lingkungan yang diinstal dan dikonfigurasi di cluster Kubernetes yang sudah ada. Lihat petunjuk penginstalan hybrid.
• Saat menggabungkan beberapa organisasi dalam satu cluster, semua versi hybrid harus cocok. Sebelum menambahkan organisasi kedua ke cluster, upgrade penginstalan hybrid yang ada, jika perlu. Lihat Mengupgrade Apigee Hybrid.

Buat org untuk ditambahkan ke cluster yang ada

Untuk membuat org tambahan, ikuti langkah-langkah di Bagian 1: Penyiapan project dan org.

Catatan: Jika Anda memiliki org yang sudah ada yang ingin ditambahkan ke penginstalan hybrid Apigee, Anda dapat langsung membuka Konfigurasi org baru.

Mengonfigurasi organisasi baru

Pada langkah-langkah berikut, Anda akan membuat file penggantian baru dan mengonfigurasinya untuk organisasi baru. File overrides.yaml hanya dapat mendukung informasi satu organisasi. Oleh karena itu, Anda harus membuat file overrides.yaml baru dan menerapkannya ke cluster Kubernetes yang ada.

1. Buat akun layanan untuk digunakan dengan organisasi baru. Lihat Membuat akun layanan.
2. Catat file sertifikat TLS (.key dan .pem) di direktori certs Anda. Jika Anda perlu membuatnya lagi, Anda dapat mengikuti petunjuk di Membuat sertifikat TLS.
3. Salin overrides.yaml yang ada ke file baru untuk digunakan sebagai titik awal untuk mengonfigurasi organisasi baru Anda. Contoh: new-overrides.yaml.
4. Edit file penggantian baru dengan konfigurasi berikut:

   org: "new-org-name"
   instanceID: "instance-id"   ## Must match the instanceID of your existing org.
   
   multiOrgCluster: true ## Enables exporting metrics for this org to the Google Cloud Project named with gcp:projectID
   
   k8sCluster:
     name: "existing-cluster-name"
     region: "existing-cluster-analytics-region"
   
   gcp:
     projectID: "new-project-id"
     name: "new-project-id"
     region: "new-project-default-location"
   
   namespace: namespace ## must be the same for both new and existing orgs
   
   virtualhosts:
     - name: new-environment-group-name
       selector:
         app: apigee-ingressgateway
         ingress_name: old-ingress-name
       sslCertPath: ./certs/cert-file-name # .crt or .pem
       sslKeyPath: ./certs/key-file-name # .key
   
   envs:
     - name: new-environment-name
       serviceAccountPaths:
         runtime: ./new-service-accounts-directory/new-project-id-apigee-runtime.json
         synchronizer: ./new-service-accounts-directory/new-project-id-apigee-synchronizer.json
         udca: ./new-service-accounts-directory/new-project-id-apigee-udca.json
   
   connectAgent:
     serviceAccountPath: ./new-service-accounts-directory/new-project-id-apigee-mart.json
   
   mart:
     serviceAccountPath: ./new-service-accounts-directory/new-project-id-apigee-mart.json
   
   metrics:
     serviceAccountPath: ./new-service-accounts-directory/new-project-id-apigee-metrics.json
   
   watcher:
     serviceAccountPath: ./new-service-accounts-directory/new-project-id-apigee-watcher.json

   Tabel berikut menjelaskan setiap nilai properti yang harus Anda berikan dalam file penggantian. Untuk mengetahui informasi selengkapnya, lihat Referensi properti konfigurasi.

   Variabel	Deskripsi
   new-org-name	Nama organisasi baru Anda.
   instance-id	Semua org dalam cluster ini harus memiliki ID instance yang sama. Oleh karena itu, nilai ini harus cocok dengan entri instanceID dalam file penggantian untuk org. asli Anda. Untuk penginstalan multi-region, setiap region memerlukan clusternya sendiri, karena cluster individual tidak mencakup beberapa region. Oleh karena itu, setiap cluster harus memiliki ID instance uniknya sendiri yang dibagikan oleh setiap organisasi dalam cluster.
   existing-cluster-name	Nama cluster yang Anda tambahi organisasi ini. Nilai ini harus cocok dengan entri k8sCluster.name dalam file penggantian untuk cluster asli Anda.
   existing-cluster-analytics-region	Region tempat cluster asli disediakan. Harus cocok dengan entri k8sCluster.region dalam file penggantian untuk cluster asli Anda.
   new-project-id	Project ID project baru Anda. Project ID dan nama organisasi sama.
   new-project-default-location	Wilayah analisis yang Anda tentukan saat membuat organisasi baru. Region ini tidak harus sama dengan region organisasi yang sudah ada.
   namespace	Semua organisasi di cluster harus memiliki namespace yang sama. Pastikan untuk menggunakan ruang nama yang sama dengan yang digunakan untuk organisasi asli. Namespace untuk sebagian besar penginstalan adalah apigee.
   new-environment-group-name	Grup lingkungan baru yang Anda buat untuk organisasi baru. Perhatian: Nama grup lingkungan untuk organisasi baru tidak boleh sama dengan nama grup lingkungan untuk organisasi lain. Jika Anda menggunakan diagram Helm untuk mengelola Apigee hybrid, nama rilis untuk env dapat sama, sehingga akan menyulitkan pengelolaan diagram.
   cert-file-name dan key-file-name	File sertifikat dan kunci TLS untuk cluster yang Anda periksa atau buat di langkah 1 di bagian ini.
   new-environment-name	Nama lingkungan yang Anda buat untuk organisasi baru. Perhatian: Nama lingkungan untuk organisasi baru tidak boleh sama dengan nama lingkungan untuk organisasi lain.
   new-service-accounts-directory	Direktori tempat file kunci akun layanan yang Anda buat untuk organisasi baru berada.

Terapkan konfigurasi:

Terapkan konfigurasi organisasi baru ke cluster Anda:

1. Lakukan penginstalan uji coba untuk memeriksa apakah ada masalah:

   Helm

   helm upgrade ORG_NAME apigee-org/ \
     --install \
     --namespace apigee \
     --atomic \
     -f NEW_OVERRIDES_FILE.yaml \
     --dry-run
   

   apigeectl

   $APIGEECTL_HOME/apigeectl apply -f NEW_OVERRIDES_FILE.yaml --org --dry-run=client

   Catatan: Sebaiknya lakukan uji coba sebelum menerapkan konfigurasi untuk menentukan apakah ada masalah.
2. Jika tidak ada masalah, terapkan komponen tingkat org. Langkah ini menginstal tugas Cassandra (pengguna dan skema), Apigee Connect, Apigee Watcher, dan layanan MART:

   Helm

   helm upgrade ORG_NAME apigee-org/ \
     --install \
     --namespace apigee \
     --atomic \
     -f NEW_OVERRIDES_FILE.yaml
   

   apigeectl

   $APIGEECTL_HOME/apigeectl apply -f NEW_OVERRIDES_FILE.yaml --org

3. Instal lingkungan. Langkah ini menginstal komponen apigee-runtime, synchronizer, dan UDCA, per lingkungan:

   Helm

   helm upgrade ENV_NAME apigee-env/ \
     --install \
     --namespace apigee \
     --atomic \
     --set env=ENV_NAME \
     -f NEW_OVERRIDES_FILE.yaml \
     --dry-run
   

   helm upgrade ENV_NAME apigee-env/ \
     --install \
     --namespace apigee \
     --atomic \
     --set env=ENV_NAME \
     -f NEW_OVERRIDES_FILE.yaml
   

   apigeectl

   $APIGEECTL_HOME/apigeectl apply -f NEW_OVERRIDES_FILE --env $ENV_NAME --dry-run=client

   $APIGEECTL_HOME/apigeectl apply -f NEW_OVERRIDES_FILE --env $ENV_NAME

   Catatan: Jika Anda memiliki beberapa lingkungan di organisasi baru, ulangi langkah ini untuk setiap lingkungan.
4. Terapkan perubahan load balancer. Langkah ini mengonfigurasi ingress untuk memproses host virtual baru untuk organisasi kedua:
   Penting: Jangan menduplikasi nama host/nama domain di antara dua organisasi, karena hal ini dapat menyebabkan perutean yang tidak dapat diprediksi.

   Helm

   helm upgrade NEW_ENV_GROUP_NAME apigee-virtualhost/ \
     --install \
     --namespace apigee \
     --atomic \
     --set envgroup=NEW_ENV_GROUP_NAME \
     -f NEW_OVERRIDES_FILE.yaml \
     --dry-run
   

   helm upgrade NEW_ENV_GROUP_NAME apigee-virtualhost/ \
     --install \
     --namespace apigee \
     --atomic \
     --set envgroup=NEW_ENV_GROUP_NAME \
     -f NEW_OVERRIDES_FILE.yaml
   

   apigeectl

   $APIGEECTL_HOME/apigeectl apply -f NEW_OVERRIDES_FILE --settings virtualhosts --dry-run=client

   $APIGEECTL_HOME/apigeectl apply -f NEW_OVERRIDES_FILE --settings virtualhosts

5. Aktifkan akses penyinkron untuk organisasi baru Anda dengan mengikuti langkah-langkah di Mengaktifkan akses Penyinkron.
6. Secara default, saat Anda pertama kali menginstal runtime Apigee hybrid, komponen Telemetry dikonfigurasi dengan multiOrgCluster dinonaktifkan. Gunakan langkah-langkah berikut untuk mengaktifkan telemetri multi-org untuk setiap org di cluster Anda:
   1. Hapus komponen Telemetri yang ada dengan perintah berikut:

      Helm

      helm delete telemetry -n APIGEE_NAMESPACE
      

      apigeectl

      Lakukan uji coba terlebih dahulu:

      $APIGEECTL_HOME/apigeectl delete -f FIRST_OVERRIDES_FILE.yaml --telemetry --dry-run=client

      Jika uji coba berhasil, hapus komponen Telemetri:

      $APIGEECTL_HOME/apigeectl delete -f FIRST_OVERRIDES_FILE.yaml --telemetry

      Catatan: Menghapus komponen Telemetri akan menghentikan metrik yang diekspor ke Google Monitoring. Lakukan langkah-langkah berikut untuk mengaktifkan kembali metrik.
   2. Tambahkan baris berikut ke file overrides.yaml untuk org. yang sudah ada.

      multiOrgCluster: true

   3. Terapkan perubahan untuk menginstal komponen Telemetri untuk organisasi.

      Lakukan uji coba terlebih dahulu:

      Helm

      helm upgrade telemetry apigee-telemetry/ \
        --install \
        --namespace apigee \
        --atomic \
        -f FIRST_OVERRIDES_FILE.yaml \
        --dry-run
      

      apigeectl

      $APIGEECTL_HOME/apigeectl apply -f FIRST_OVERRIDES_FILE.yaml --telemetry --dry-run=client

      Jika uji coba berhasil, terapkan perubahan dan instal komponen Telemetri:

      Helm

      helm upgrade telemetry apigee-telemetry/ \
        --install \
        --namespace apigee \
        --atomic \
        -f FIRST_OVERRIDES_FILE.yaml
      

      apigeectl

      $APIGEECTL_HOME/apigeectl apply -f FIRST_OVERRIDES_FILE.yaml --telemetry

   4. Pastikan baris berikut ada di file overrides.yaml untuk setiap organisasi baru.

      multiOrgCluster: true

   5. Terapkan perubahan untuk menginstal komponen Telemetri untuk setiap organisasi baru. Ulangi langkah ini untuk setiap org baru di cluster multi-org Anda.

      Lakukan uji coba terlebih dahulu:

      Helm

      helm upgrade telemetry apigee-telemetry/ \
        --install \
        --namespace apigee \
        --atomic \
        -f NEW_OVERRIDES_FILE.yaml \
        --dry-run
      

      apigeectl

      $APIGEECTL_HOME/apigeectl apply -f NEW_OVERRIDES_FILE.yaml --telemetry --dry-run=client

      Jika uji coba berhasil, terapkan perubahan dan instal komponen Telemetri:

      Helm

      helm upgrade telemetry apigee-telemetry/ \
        --install \
        --namespace apigee \
        --atomic \
        -f NEW_OVERRIDES_FILE.yaml
      

      apigeectl

      $APIGEECTL_HOME/apigeectl apply -f NEW_OVERRIDES_FILE.yaml --telemetry