Halaman ini diterjemahkan oleh Cloud Translation API.

Langkah 11: Menginstal Apigee hybrid Menggunakan Helm

Menginstal komponen runtime Apigee hybrid

Pada langkah ini, Anda akan menggunakan Helm untuk menginstal komponen Apigee Hybrid 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 Prapenginstalan

Jika Anda belum menginstal Helm v3.14.2+, ikuti petunjuk di Menginstal Helm.
Apigee hybrid menggunakan guardrail Helm untuk memverifikasi konfigurasi sebelum menginstal atau mengupgrade diagram. Anda mungkin melihat informasi khusus pembatasan 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 guardrail untuk membantu mendiagnosis penyebabnya. Lihat Mendiagnosis masalah dengan pembatasan.
Sebelum menjalankan salah satu 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.
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.

Langkah-langkah penginstalan

Pastikan Anda memiliki helm versi yang sesuai.
```
helm version
```
Versi helm yang diperlukan untuk penginstalan ini adalah v3.14.2+. Jika versi yang ditampilkan tidak memuaskan, upgrade helm dengan menjalankan perintah di bawah. 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
```
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 \
  --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.12.3   1.12.3

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

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

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

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

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

Instal organisasi Apigee. Jika telah menetapkan variabel lingkungan $ORG_NAME di shell, Anda dapat menggunakannya dalam 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 sudah aktif dan berjalan dengan memeriksa status organisasi masing-masing:

kubectl -n apigee get apigeeorg

NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d

Instal lingkungan.

Anda harus menginstal satu lingkungan dalam satu waktu. Tentukan lingkungan dengan --set env=ENV_NAME. Jika telah menetapkan variabel lingkungan $ENV_NAME di shell, Anda dapat menggunakannya dalam perintah berikut:

Uji coba:
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=$ENV_NAME \
  -f overrides.yaml \
  --dry-run
```
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
```
Instal grup lingkungan (virtualhosts).
1. Anda harus menginstal satu grup lingkungan (virtualhost) dalam satu waktu. Tentukan grup lingkungan dengan --set envgroup=ENV_GROUP. Jika telah menetapkan variabel lingkungan $ENV_GROUP di shell, Anda dapat menggunakannya dalam perintah berikut. 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 \
  -f overrides.yaml \
  --dry-run
```
  Instal diagram:
```
helm upgrade $ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=$ENV_GROUP \
  -f overrides.yaml
```
  Catatan: ENV_GROUP 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
```

Langkah berikutnya

Penginstalan menggunakan 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