Halaman ini diterjemahkan oleh Cloud Translation API.

Langkah 10: 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 pemasangan komponen itu penting.

Catatan Pra-penginstalan

Jika Anda belum menginstal Helm v3.10+, ikuti petunjuknya di Menginstal Helm.
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_NAMESPACE
  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.
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.

Langkah-langkah penginstalan

Jika belum, buka direktori APIGEE_HELM_CHARTS_HOME Anda. Jalankan perintah berikut dari direktori tersebut.

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 \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f overrides.yaml \
  --dry-run

Instal diagram:

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

Verifikasi penginstalan Operator Apigee:

helm ls -n APIGEE_NAMESPACE

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

Pastikan aplikasi tersebut aktif dan berjalan dengan memeriksa ketersediaannya:

kubectl -n APIGEE_NAMESPACE get deploy apigee-controller-manager

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

Instal datastore Apigee:

Uji coba:

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

Instal diagram:

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

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

kubectl -n APIGEE_NAMESPACE get apigeedatastore default

NAME      STATE       AGE
default   running    2d

Instal telemetri Apigee:

Uji coba:

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

Instal diagram:

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

Pastikan aplikasi tersebut aktif dan berjalan dengan memeriksa statusnya:

kubectl -n APIGEE_NAMESPACE get apigeetelemetry apigee-telemetry

NAME               STATE     AGE
apigee-telemetry   running   2d

Instal Apigee Redis:

Uji coba:

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

Instal diagram:

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

Pastikan aplikasi tersebut aktif dan berjalan dengan memeriksa statusnya:

kubectl -n APIGEE_NAMESPACE get apigeeredis default

NAME      STATE     AGE
default   running   2d

Instal ingress manager Apigee:

Uji coba:

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

Instal diagram:

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

Pastikan aplikasi tersebut aktif dan berjalan dengan memeriksa ketersediaannya:

kubectl -n APIGEE_NAMESPACE get deployment apigee-ingressgateway-manager

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

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_NAMESPACE \
  --atomic \
  -f overrides.yaml \
  --dry-run

Instal diagram:

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

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

kubectl -n APIGEE_NAMESPACE get apigeeorg

NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d

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_NAMESPACE \
  --atomic \
  --set env=$ENV_NAME \
  -f overrides.yaml \
  --dry-run

Instal diagram:

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

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

kubectl -n APIGEE_NAMESPACE get apigeeenv

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

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_NAMESPACE \
  --atomic \
  --set envgroup=$ENV_GROUP \
  -f overrides.yaml \
  --dry-run
```
  Instal diagram:
```
helm upgrade $ENV_GROUP apigee-virtualhost/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  --set envgroup=$ENV_GROUP \
  -f overrides.yaml
```
  Catatan: ENV_GROUP harus unik dalam apigee. Misalnya, jika Anda memiliki env prod dan envgroup, Anda harus menetapkan nama ini ke prod-envgroup. Grup env berikutnya nama harus tetap prod.
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_NAMESPACE get arc
```
```
NAME                                STATE   AGE
apigee-org1-dev-egroup                       2d
```
```
kubectl -n APIGEE_NAMESPACE 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 (NEXT) Langkah 11: 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