Langkah 11: Instal Apigee Hybrid Menggunakan Helm

Menginstal komponen runtime hybrid Apigee

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

  • Operator Apigee
  • Datastore Apigee
  • Telemetri Apigee
  • Redis Apigee
  • Pengelola traffic masuk Apigee
  • Organisasi Apigee
  • Lingkungan Apigee Anda

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

Catatan Pra-penginstalan

  1. Jika Anda belum menginstal Helm v3.10+, ikuti petunjuknya di Menginstal Helm.
  2. Apigee Hybrid menggunakan pagar pembatas Helm untuk memverifikasi konfigurasi sebelum menginstal atau memperbarui bagan. Anda mungkin melihat informasi khusus pagar pembatas di output setiap perintah di bagian ini, misalnya:

    # Source: apigee-operator/templates/apigee-operators-guardrails.yaml
    apiVersion: v1
    kind: Pod
    metadata:
      name: apigee-hybrid-helm-guardrail-operator
      namespace: apigee-system
      annotations:
        helm.sh/hook: pre-install,pre-upgrade
        helm.sh/hook-delete-policy: before-hook-creation,hook-succeeded
      labels:
        app: apigee-hybrid-helm-guardrail
    

    Jika salah satu perintah helm upgrade gagal, Anda dapat menggunakan output pagar pembatas untuk membantu mendiagnosis penyebabnya. Lihat Mendiagnosis masalah dengan pagar pembatas.

  3. Sebelum menjalankan perintah {i>upgrade/install<i} Helm, gunakan fitur uji coba Helm dengan menambahkan --dry-run di akhir perintah tersebut. Lihat helm install --h untuk menampilkan daftar perintah, opsi yang didukung, dan penggunaannya.
  4. Jika Anda menginstal diagram pada cluster, Anda harus dimigrasikan dari pengelolaan apigeectl ke pengelolaan Helm dengan Alat migrasi Apigee Helm, hapus tanda --atomic dari semua perintah berikut.

Langkah-langkah penginstalan

  1. Pastikan Anda memiliki versi helm yang sesuai.

    helm version

    Versi helm yang diperlukan untuk instalasi ini adalah v3.10+. Jika versi yang ditampilkan tidak memuaskan, upgrade helm dengan menjalankan perintah di bawah ini. Skrip get_helm.sh akan mengambil versi terbaru dan menginstalnya.

    curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
    chmod 700 get_helm.sh
    ./get_helm.sh

    Setelah itu, periksa kembali versi helm.

    helm version
  2. Buka direktori APIGEE_HELM_CHARTS_HOME Anda. Jalankan perintah berikut dari direktori tersebut.
  3. Instal Operator/Pengontrol Apigee:

    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 Operator Apigee:

    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.12.1   1.12.1
    

    Pastikan aplikasi tersebut 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
    
  4. 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
    
  5. 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
    

    Pastikan aplikasi tersebut aktif dan berjalan dengan memeriksa statusnya:

    kubectl -n apigee get apigeetelemetry apigee-telemetry
    
    NAME               STATE     AGE
    apigee-telemetry   running   2d
    
  6. 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
    

    Pastikan aplikasi tersebut aktif dan berjalan dengan memeriksa statusnya:

    kubectl -n apigee get apigeeredis default
    
    NAME      STATE     AGE
    default   running   2d
    
  7. Instal ingress manager 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 aplikasi tersebut 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
    
  8. Instal organisasi Apigee. Jika Anda telah menyetel variabel lingkungan $ORG_NAME di shell, Anda bisa menggunakannya di perintah berikut:

    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 aktif dan berjalan dengan memeriksa status organisasi masing-masing:

    kubectl -n apigee get apigeeorg
    
    NAME                      STATE     AGE
    apigee-org1-xxxxx          running   2d
    
  9. Instal lingkungan.

    Anda harus menginstal lingkungan satu per satu. Tentukan lingkungan dengan --set env=ENV_NAME Jika Anda telah menyetel variabel lingkungan $ENV_NAME di shell, Anda bisa menggunakannya di perintah berikut:

    Uji coba:

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

    Instal diagram:

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

    Pastikan bahwa lingkungan sudah aktif dan berjalan dengan memeriksa status lingkungan masing-masing:

    kubectl -n apigee get apigeeenv
    
    NAME                          STATE       AGE   GATEWAYTYPE
    apigee-org1-dev-xxx            running     2d
    
  10. Instal grup lingkungan (virtualhosts).
    1. Anda harus menginstal grup lingkungan (virtualhost) dalam satu waktu. Menentukan lingkungan grup dengan --set envgroup=ENV_GROUP. Jika Anda telah menyetel variabel lingkungan $ENV_GROUP di shell, Anda bisa menggunakannya di perintah berikut. Ulangi langkah berikut untuk setiap grup env yang disebutkan dalam file overrides.yaml Anda:

      Uji coba:

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

      Instal diagram:

      helm upgrade $ENV_GROUP apigee-virtualhost/ \
        --install \
        --namespace apigee \
        --atomic \
        --set envgroup=$ENV_GROUP \
        -f overrides.yaml
      
    2. Periksa status ApigeeRoute (AR).

      Menginstal virtualhosts membuat ApigeeRouteConfig (ARC) yang membuat ApigeeRoute (AR) setelah watcher Apigee mengambil grup env terkait detail dari bidang kontrol. Oleh karena itu, periksa bahwa nilai Status AR 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
      

Langkah berikutnya

Penginstalan menggunakan Workload Identity

Jika Anda menginstal Apigee Hybrid di GKE dan mengonfigurasi Workload Identity untuk mengautentikasi akun layanan, selanjutnya Anda akan mengonfigurasi pengaitan antara akun layanan Kubernetes dan akun layanan Google untuk cluster Anda.

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

Semua penginstalan lainnya

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

(BERIKUTNYA) Langkah 1: Ekspos traffic masuk Apigee 2