Installa i componenti del runtime di Apigee hybrid
In questo passaggio utilizzerai Helm per installare i seguenti componenti di Apigee hybrid:
- Operatore Apigee
- Datastore Apigee
- Telemetria Apigee
- Apigee Redis
- Gestore in entrata Apigee
- Organizzazione Apigee
- I tuoi ambienti Apigee
Installerai i grafici per ogni ambiente uno alla volta. La sequenza in cui installi i componenti è importante.
Note pre-installazione
- Se non hai ancora installato Helm 3.10 o versioni successive, segui le istruzioni riportate in Installazione di Helm.
-
Apigee hybrid utilizza i sistemi di protezione Helm per verificare la configurazione prima di installare o eseguire l'upgrade di un grafico. Potresti visualizzare informazioni specifiche per i guardrail nell'output di ciascuno dei comandi in questa sezione, ad esempio:
# 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
Se uno dei comandi
helm upgrade
ha esito negativo, puoi utilizzare l'output dei sistemi di protezione diagnosticare la causa. Consulta Diagnosticare i problemi relativi ai guardrail. - Prima di eseguire uno dei comandi di upgrade/installazione di Helm,
utilizza la funzionalità di prova di Helm aggiungendo
--dry-run
alla fine del command. Vedihelm install --h
per elencare i comandi, le opzioni e i comandi supportati e sull'utilizzo.
Procedura di installazione
- In caso contrario, passa alla directory
APIGEE_HELM_CHARTS_HOME
. Esegui i seguenti comandi da quella directory. - Installa l'operatore/il controller Apigee:
Prova:
helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml
Verifica l'installazione di Apigee Operator:
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.1 1.13.1
Verifica che sia attivo e funzionante controllandone la disponibilità:
kubectl -n APIGEE_NAMESPACE get deploy apigee-controller-manager
NAME READY UP-TO-DATE AVAILABLE AGE apigee-controller-manager 1/1 1 1 7d20h
-
Installa datastore Apigee:
Prova:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml \ --dry-run=server
Installa il grafico:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml
Verifica che
apigeedatastore
sia attivo controllandone lo stato prima di procedere con il passaggio successivo:kubectl -n APIGEE_NAMESPACE get apigeedatastore default
NAME STATE AGE default running 2d
-
Installa la telemetria di Apigee:
Prova:
helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml
Verifica che sia attivo e funzionante controllandone lo stato:
kubectl -n APIGEE_NAMESPACE get apigeetelemetry apigee-telemetry
NAME STATE AGE apigee-telemetry running 2d
-
Installa Apigee Redis:
Prova:
helm upgrade redis apigee-redis/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade redis apigee-redis/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml
Verifica che sia attivo e funzionante controllandone lo stato:
kubectl -n APIGEE_NAMESPACE get apigeeredis default
NAME STATE AGE default running 2d
-
Installa il gestore in entrata Apigee:
Prova:
helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml
Verifica che sia attivo e funzionante controllandone la disponibilità:
kubectl -n APIGEE_NAMESPACE get deployment apigee-ingressgateway-manager
NAME READY UP-TO-DATE AVAILABLE AGE apigee-ingressgateway-manager 2/2 2 2 2d
-
Installa l'organizzazione Apigee. Se hai impostato la variabile di ambiente $ORG_NAME nella shell, puoi utilizzarla nei seguenti comandi:
Prova:
helm upgrade $ORG_NAME apigee-org/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade $ORG_NAME apigee-org/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml
Verifica che sia attivo e funzionante controllando lo stato dell'organizzazione corrispondente:
kubectl -n APIGEE_NAMESPACE get apigeeorg
NAME STATE AGE apigee-org1-xxxxx running 2d
-
Installa l'ambiente.
Devi installare un ambiente alla volta. Specifica l'ambiente con
--set env=
ENV_NAME. Se hai impostato la variabile di ambiente $ENV_NAME nella shell, puoi utilizzarla nei seguenti comandi:Prova:
helm upgrade $ENV_NAME apigee-env/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ --set env=$ENV_NAME \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade $ENV_NAME apigee-env/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ --set env=$ENV_NAME \ -f overrides.yaml
Verifica che sia attivo controllando lo stato del rispettivo env:
kubectl -n APIGEE_NAMESPACE get apigeeenv
NAME STATE AGE GATEWAYTYPE apigee-org1-dev-xxx running 2d
-
Installa i gruppi di ambienti (
virtualhosts
).- Devi installare un gruppo di ambienti (virtualhost) alla volta. Specifica l'ambiente
gruppo con
--set envgroup=
ENV_GROUP. Se hai impostato il parametro $ENV_GROUP nella tua shell, puoi utilizzarla nella i seguenti comandi. Ripeti i seguenti comandi per ogni gruppo env menzionato nel fileoverrides.yaml
:Prova:
helm upgrade $ENV_GROUP apigee-virtualhost/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=$ENV_GROUP \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade $ENV_GROUP apigee-virtualhost/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=$ENV_GROUP \ -f overrides.yaml
- Controlla lo stato di ApigeeRoute (AR).
L'installazione del
virtualhosts
crea ApigeeRouteConfig (ARC), che internamente crea ApigeeRoute (AR) quando lo watcher di Apigee estrae i dettagli relativi al gruppo di ambienti dal control plane. Pertanto, verifica che i valori corrispondenti Lo stato dell'AR è in esecuzione: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
- Devi installare un gruppo di ambienti (virtualhost) alla volta. Specifica l'ambiente
gruppo con
Passaggio successivo
Installazioni che utilizzano Workload Identity
Se installi Apigee hybrid su GKE e stai configurando Workload Identity per l'autenticazione degli account di servizio, nel prossimo nel passaggio successivo, configurerai le associazioni tra gli account di servizio Kubernetes e gli account di servizio Google per il tuo cluster.
1 2 3 4 5 6 7 8 9 10 (AVANTI) Passaggio 11: configura Workload IdentityTutte le altre installazioni
Nel passaggio successivo configurerai il gateway in entrata Apigee ed eseguirai il deployment di un proxy per testare l'installazione.
(SUCCESSIVO) Passaggio 1: esponi Apigee Ingress 2