Installa i componenti di runtime di Apigee hybrid
In questo passaggio, utilizzerai Helm per installare i seguenti componenti ibridi di Apigee:
- 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 con cui installi i componenti sono importanti.
Note pre-installazione
- Se non hai già installato Helm v3.10+, segui le istruzioni in Installare Helm.
-
Apigee hybrid utilizza i sistemi di protezione Helm per verificare la configurazione prima di installare o eseguire l'upgrade di un grafico. Nell'output potresti vedere informazioni specifiche del guardrail di ognuno 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-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
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 qualsiasi comando di upgrade/installazione di Helm,
usa la funzionalità di prova di Helm aggiungendo
--dry-run
alla fine il comando. Consulta la sezionehelm install --h
per elencare i comandi, le opzioni e i comandi supportati e sull'utilizzo. - Se stai installando i grafici su un cluster che hai
è stata eseguita la migrazione dalla gestione di
apigeectl
alla gestione Helm con Strumento di migrazione Apigee Helm, ometti il flag--atomic
da tutti i seguenti comandi.
Procedura di installazione
Verifica di avere una versione di Helm adatta.
helm version
La versione di Helm richiesta per questa installazione è la 3.10+. Se la versione mostrata non è soddisfacente, esegui l'upgrade di Helm eseguendo i comandi seguenti. Lo script
get_helm.sh
recupererà la versione più recente e la installerà.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
Dopodiché, controlla di nuovo la versione di Helm.
helm version
- Vai alla directory
APIGEE_HELM_CHARTS_HOME
. Esegui l' i seguenti comandi da quella directory. - Installa l'operatore/il controller Apigee:
Prova:
helm upgrade operator apigee-operator/ \ --install \ --create-namespace \ --namespace apigee-system \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade operator apigee-operator/ \ --install \ --create-namespace \ --namespace apigee-system \ --atomic \ -f overrides.yaml
Verifica l'installazione dell'operatore 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
Verifica che sia attivo e funzionante controllandone la disponibilità:
kubectl -n apigee-system 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 \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade datastore apigee-datastore/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Verifica che
apigeedatastore
sia attivo e in funzione controllandone lo stato prima vai al passaggio successivo:kubectl -n apigee get apigeedatastore default
NAME STATE AGE default running 2d
-
Installa la telemetria Apigee:
Prova:
helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade telemetry apigee-telemetry/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Verifica che sia attivo e funzionante controllandone lo stato:
kubectl -n apigee get apigeetelemetry apigee-telemetry
NAME STATE AGE apigee-telemetry running 2d
-
Installa Apigee Redis:
Prova:
helm upgrade redis apigee-redis/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade redis apigee-redis/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Verifica che sia attivo e funzionante controllandone lo stato:
kubectl -n apigee 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 \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade ingress-manager apigee-ingress-manager/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Verifica che sia attivo e funzionante controllandone la disponibilità:
kubectl -n apigee 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 $ORG_NAME nella tua shell, puoi utilizzarla nella seguenti comandi:
Prova:
helm upgrade $ORG_NAME apigee-org/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade $ORG_NAME apigee-org/ \ --install \ --namespace apigee \ --atomic \ -f overrides.yaml
Verifica che sia attivo e funzionante controllando lo stato dell'organizzazione corrispondente:
kubectl -n apigee 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 $ENV_NAME nella tua shell, puoi utilizzarla nella seguenti comandi:Prova:
helm upgrade $ENV_NAME apigee-env/ \ --install \ --namespace apigee \ --atomic \ --set env=$ENV_NAME \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade $ENV_NAME apigee-env/ \ --install \ --namespace apigee \ --atomic \ --set env=$ENV_NAME \ -f overrides.yaml
Verifica che sia attivo e funzionante controllando lo stato del rispettivo ambiente:
kubectl -n apigee get apigeeenv
NAME STATE AGE GATEWAYTYPE apigee-org1-dev-xxx running 2d
-
Installa i gruppi di ambienti (
virtualhosts
).- Devi installare un gruppo di ambiente (virtualhost) alla volta. Specifica l'ambiente
gruppo con
--set envgroup=
ENV_GROUP. Se hai impostato $ENV_GROUP nella tua shell, puoi utilizzarla nella i seguenti comandi. Ripeti quanto segue per ogni gruppo env menzionato nel tuo fileoverrides.yaml
:Prova:
helm upgrade $ENV_GROUP apigee-virtualhost/ \ --install \ --namespace apigee \ --atomic \ --set envgroup=$ENV_GROUP \ -f overrides.yaml \ --dry-run
Installa il grafico:
helm upgrade $ENV_GROUP apigee-virtualhost/ \ --install \ --namespace apigee \ --atomic \ --set envgroup=$ENV_GROUP \ -f overrides.yaml
- Controlla lo stato di ApigeeRoute (AR).
Installazione di
virtualhosts
crea ApigeeRouteConfig (ARC), che crea internamente ApigeeRoute (AR) dopo che l'osservatore Apigee ha eseguito il pull del gruppo env correlato i dettagli dal piano di controllo. Pertanto, verifica che i valori corrispondenti Lo stato dell'AR è in esecuzione: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
- Devi installare un gruppo di ambiente (virtualhost) alla volta. Specifica l'ambiente
gruppo con
Passaggio successivo
Installazioni con 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 11 (SUCCESSIVO) Passaggio 12: 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