Langkah 11: Instal Apigee hybrid Menggunakan diagram Helm

Anda saat ini melihat versi 1.11 dokumentasi Apigee hybrid. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.11 

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                                         

Menginstal diagram Helm Apigee hybrid

Pada langkah ini, Anda akan menggunakan Helm untuk menginstal komponen hybrid Apigee berikut:

• Operator Apigee
• Datastore Apigee
• Telemetri Apigee
• Redis Apigee
• Pengelola ingress Apigee
• Organisasi Apigee
• Lingkungan Apigee Anda

Anda akan menginstal diagram untuk setiap lingkungan satu per satu. Urutan penginstalan komponen itu penting.

Catatan: Sebelum menjalankan perintah upgrade/penginstalan Helm, gunakan fitur dry-run Helm dengan menambahkan --dry-run di akhir perintah. Lihat helm install --h untuk mencantumkan perintah, opsi, dan penggunaan yang didukung.

Perhatian: Jika Anda menginstal diagram di cluster yang telah dimigrasikan dari pengelolaan apigeectl ke pengelolaan Helm dengan alat migrasi Helm Apigee, hapus tanda --atomic dari semua perintah berikut.

1. Jika belum, buka direktori APIGEE_HELM_CHARTS_HOME. Jalankan perintah berikut dari direktori tersebut.
2. Instal Operator/Pengontrol Apigee:
   Catatan: Langkah ini memerlukan izin cluster yang ditingkatkan. Jalankan helm -h atau helm install -h untuk mengetahui detailnya

   Uji coba:

   helm upgrade operator apigee-operator/ \
     --install \
     --create-namespace \
     --namespace apigee-system \
     --atomic \
     -f overrides.yaml \
     --dry-run
   

   Instal diagram:

   helm upgrade operator apigee-operator/ \
     --install \
     --create-namespace \
     --namespace apigee-system \
     --atomic \
     -f overrides.yaml
   

   Verifikasi penginstalan Apigee Operator:

   helm ls -n apigee-system
   

   NAME           NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
   operator    apigee-system   3               2023-06-26 00:42:44.492009 -0800 PST    deployed        apigee-operator-1.11.2   1.11.2

   Pastikan server sudah aktif dan berjalan dengan memeriksa ketersediaannya:

   kubectl -n apigee-system get deploy apigee-controller-manager
   

   NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
   apigee-controller-manager   1/1     1            1           7d20h

3. Instal datastore Apigee:

   Uji coba:

   helm upgrade datastore apigee-datastore/ \
     --install \
     --namespace apigee \
     --atomic \
     -f overrides.yaml \
     --dry-run
   

   Instal diagram:

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

   Pastikan apigeedatastore sudah aktif dan berjalan dengan memeriksa statusnya sebelum melanjutkan ke langkah berikutnya:

   kubectl -n apigee get apigeedatastore default
   

   NAME      STATE       AGE
   default   running    2d

4. Instal telemetri Apigee:

   Uji coba:

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

   Instal diagram:

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

   Verifikasi bahwa aplikasi sudah aktif dan berjalan dengan memeriksa statusnya:

   kubectl -n apigee get apigeetelemetry apigee-telemetry
   

   NAME               STATE     AGE
   apigee-telemetry   running   2d

5. Instal Apigee Redis:

   Uji coba:

   helm upgrade redis apigee-redis/ \
     --install \
     --namespace apigee \
     --atomic \
     -f overrides.yaml \
     --dry-run
   

   Instal diagram:

   helm upgrade redis apigee-redis/ \
     --install \
     --namespace apigee \
     --atomic \
     -f overrides.yaml
   

   Verifikasi bahwa aplikasi sudah aktif dan berjalan dengan memeriksa statusnya:

   kubectl -n apigee get apigeeredis default
   

   NAME      STATE     AGE
   default   running   2d

6. Instal pengelola ingress Apigee:

   Uji coba:

   helm upgrade ingress-manager apigee-ingress-manager/ \
     --install \
     --namespace apigee \
     --atomic \
     -f overrides.yaml \
     --dry-run
   

   Instal diagram:

   helm upgrade ingress-manager apigee-ingress-manager/ \
     --install \
     --namespace apigee \
     --atomic \
     -f overrides.yaml
   

   Pastikan server sudah aktif dan berjalan dengan memeriksa ketersediaannya:

   kubectl -n apigee get deployment apigee-ingressgateway-manager
   

   NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
   apigee-ingressgateway-manager   2/2     2            2           2d

7. Menginstal organisasi Apigee:

   Uji coba:

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

   Instal diagram:

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

   Pastikan aplikasi tersebut sudah aktif dan berjalan dengan memeriksa status organisasi masing-masing:

   kubectl -n apigee get apigeeorg
   

   NAME                      STATE     AGE
   apigee-org1-xxxxx          running   2d

8. Instal lingkungan.

   Anda harus menginstal satu lingkungan dalam satu waktu. Tentukan lingkungan dengan --set env=ENV_NAME:

   Uji coba:

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

   ENV_RELEASE_NAME adalah nama yang digunakan untuk melacak penginstalan dan upgrade bagan apigee-env. Nama ini harus unik dari nama rilis Helm lainnya dalam penginstalan Anda. Biasanya, ini sama dengan ENV_NAME. Namun, jika lingkungan Anda memiliki nama yang sama dengan grup lingkungan, Anda harus menggunakan nama rilis yang berbeda untuk lingkungan dan grup lingkungan, misalnya dev-env-release dan dev-envgroup-release. Untuk mengetahui informasi selengkapnya tentang rilis di Helm, lihat Tiga konsep besar dalam dokumentasi Helm.

   Instal diagram:

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

   Pastikan aplikasi sudah aktif dan berjalan dengan memeriksa status setiap lingkungan:

   kubectl -n apigee get apigeeenv
   

   NAME                          STATE       AGE   GATEWAYTYPE
   apigee-org1-dev-xxx            running     2d

9. Instal grup lingkungan (virtualhosts).
   1. Anda harus menginstal satu grup lingkungan (virtualhost) dalam satu waktu. Tentukan grup lingkungan dengan --set envgroup=ENV_GROUP_NAME. Ulangi perintah berikut untuk setiap grup env yang disebutkan dalam file overrides.yaml Anda:

      Uji coba:

      helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
        --install \
        --namespace apigee \
        --atomic \
        --set envgroup=ENV_GROUP_NAME \
        -f overrides.yaml \
        --dry-run
      

      ENV_GROUP_RELEASE_NAME adalah nama yang digunakan untuk melacak penginstalan dan upgrade bagan apigee-virtualhosts. Nama ini harus unik dari nama rilis Helm lainnya dalam penginstalan Anda. Biasanya, ini sama dengan ENV_GROUP. Namun, jika grup lingkungan Anda memiliki nama yang sama dengan lingkungan dalam penginstalan, Anda harus menggunakan nama rilis yang berbeda untuk grup lingkungan dan lingkungan, misalnya dev-envgroup-release dan dev-env-release. Untuk mengetahui informasi selengkapnya tentang rilis di Helm, lihat Tiga konsep besar dalam dokumentasi Helm.

      Instal diagram:

      helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
        --install \
        --namespace apigee \
        --atomic \
        --set envgroup=ENV_GROUP_NAME \
        -f overrides.yaml
      

      Catatan: ENV_GROUP_NAME harus unik dalam namespace apigee. Misalnya, jika Anda memiliki env prod dan envgroup, Anda harus menetapkan nama ini ke prod-envgroup. Nama grup env berikutnya harus tetap prod.
   2. Periksa status ApigeeRoute (AR).

      Menginstal virtualhosts akan membuat ApigeeRouteConfig (ARC) yang secara internal membuat ApigeeRoute (AR) setelah pengamat Apigee mengambil detail terkait grup env dari bidang kontrol. Oleh karena itu, pastikan status AR yang sesuai sedang berjalan:

      kubectl -n apigee get arc
      

      NAME                                STATE   AGE
      apigee-org1-dev-egroup                       2d

      kubectl -n apigee get ar
      

      NAME                                        STATE     AGE
      apigee-org1-dev-egroup-xxxxxx                running   2d

Selamat!

Anda telah berhasil menginstal dan mengonfigurasi platform runtime Apigee Hybrid.

GKE dengan Workload Identity

Jika Anda menginstal Apigee hybrid di GKE dan mengonfigurasi Workload Identity untuk mengautentikasi akun layanan, pada langkah berikutnya, Anda akan mengonfigurasi pengaitan antara akun layanan Kubernetes dan akun layanan Google untuk cluster Anda.

1 2 3 4 5 6 7 8 9 11 (BERIKUTNYA) Langkah 12: Menyiapkan Workload Identity

Semua penginstalan lainnya

Pada langkah berikutnya, Anda akan mengonfigurasi gateway masuk Apigee dan men-deploy proxy untuk menguji penginstalan.

(BERIKUTNYA) Langkah 1: Mengekspos ingress Apigee 2