Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 10: installa Apigee hybrid utilizzando Helm

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. Vedi helm 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:

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.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).
1. 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 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 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 in entrata Apigee ed eseguirai il deployment di un proxy per testare l'installazione.

(SUCCESSIVO) Passaggio 1: esponi Apigee Ingress 2