Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 10: installa Apigee hybrid utilizzando Helm

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

Dovrai installare i grafici per ogni ambiente uno alla volta. La sequenza con cui installi i componenti è importante.

Note di preinstallazione

Se non hai già installato Helm v3.10+, segui le istruzioni in Installare Helm.
Apigee Hybrid utilizza i guardrail di 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_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 Diagnostica dei 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 helm install --h per un elenco dei comandi, delle opzioni e dell'utilizzo supportati.

Procedura di installazione

In caso contrario, vai alla directory APIGEE_HELM_CHARTS_HOME. Esegui i seguenti comandi da quella directory.

Installa l'operatore/il controller Apigee:

Nota: questo passaggio richiede autorizzazioni cluster elevate. Esegui helm -h o helm install -h per i dettagli

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.0   1.13.0

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 il data store 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 controllando lo stato della rispettiva organizzazione:

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 e funzionante controllando lo stato del rispettivo ambiente:

kubectl -n APIGEE_NAMESPACE get apigeeenv

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

Installa i gruppi di ambienti (virtualhosts).
1. Devi installare un gruppo di ambienti (virtualhost) alla volta. Specifica il gruppo di ambienti con --set envgroup=ENV_GROUP. Se hai impostato il parametro $ENV_GROUP nella tua shell, puoi utilizzarla nella i seguenti comandi. Ripeti quanto segue per ogni gruppo env menzionato nel tuo file overrides.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
```
  Nota: ENV_GROUP deve essere univoco all'interno del dello spazio dei nomi apigee. Ad esempio, se hai un env prod e un envgroup, devi impostare questo nome su prod-envgroup. Il gruppo di ambienti successivi deve essere comunque prod.
2. 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
```

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 Identity

Tutte le altre installazioni

Nel passaggio successivo, configurerai il gateway di ingresso Apigee e eseguirai il deployment di un proxy per testare l'installazione.

(PASSAGGIO SUCCESSIVO) Passaggio 1: esponi l'ingresso Apigee 2