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
- 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-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. - Sebelum menjalankan perintah {i>upgrade/install<i} Helm,
gunakan fitur uji coba Helm dengan menambahkan
--dry-run
di akhir perintah tersebut. Lihathelm install --h
untuk menampilkan daftar perintah, opsi yang didukung, dan penggunaannya. - 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
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
- Buka direktori
APIGEE_HELM_CHARTS_HOME
Anda. Jalankan perintah berikut dari direktori tersebut. - 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
-
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
Pastikan aplikasi tersebut 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
Pastikan aplikasi tersebut aktif dan berjalan dengan memeriksa statusnya:
kubectl -n apigee 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 \ --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
-
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
-
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
-
Instal grup lingkungan (
virtualhosts
).- 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 fileoverrides.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
- 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
- Anda harus menginstal grup lingkungan (virtualhost) dalam satu waktu. Menentukan lingkungan
grup dengan
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 IdentitySemua 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