Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 11: installa Apigee hybrid utilizzando Helm

Installa i componenti di runtime ibridi di Apigee

In questo passaggio, utilizzerai Helm per installare i seguenti componenti ibridi Apigee:

Operatore Apigee
Datastore Apigee
Telemetria Apigee
Apigee Redis
Gestore Ingress Apigee
Organizzazione Apigee
I tuoi ambienti Apigee

Installerai i grafici per ogni ambiente uno alla volta. La sequenza in cui installi i componenti è importante.

Nota: prima di eseguire qualsiasi comando di upgrade/installazione di Helm, utilizza la funzionalità di prova di Helm aggiungendo --dry-run alla fine del comando. Consulta la pagina helm install --h per elencare i comandi, le opzioni e l'utilizzo supportati.

Attenzione: se stai installando i grafici su un cluster di cui hai eseguito la migrazione dalla gestione apigeectl alla gestione Helm con lo strumento di migrazione Apigee Helm, ometti il flag --atomic da tutti i seguenti comandi.

Nota sui guardrail di Helm: Apigee hybrid utilizza i guardrail di Helm per verificare la configurazione prima di installare o eseguire l'upgrade di un grafico. Potresti vedere informazioni specifiche per il guardrail nell'output di ciascuno dei comandi di 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 o più comandi helm upgrade non funzionano, puoi utilizzare l'output dei guardrail per diagnosticare la causa. Consulta la sezione Diagnostica dei problemi relativi ai sistemi di protezione.

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

Installa l'operatore/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 \
  --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.0   1.12.0

Verifica che sia attivo e funzionante controllando 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 il 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 esecuzione controllandone lo stato prima di procedere con il passaggio successivo:

kubectl -n apigee get apigeedatastore default

NAME      STATE       AGE
default   running    2d

Installa la telemetria di 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 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 controllandone lo stato:

kubectl -n apigee get apigeeredis default

NAME      STATE     AGE
default   running   2d

Installa il gestore Ingress 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 controllando 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 la variabile di ambiente $ORG_NAME nella shell, puoi utilizzarla nei 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 in esecuzione controllando lo stato della rispettiva organizzazione:

kubectl -n apigee get apigeeorg

NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d

Installare 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 \
  --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 in esecuzione controllando lo stato dell'ambiente corrispondente:

kubectl -n apigee 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 la variabile di ambiente $ENV_GROUP nella shell, puoi utilizzarla nei comandi seguenti. Ripeti i seguenti comandi per ogni gruppo env menzionato nel file overrides.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
```
  Nota: ENV_GROUP deve essere univoco all'interno dello spazio dei nomi apigee. Ad esempio, se hai un envgroup e un envgroup prod, devi impostare questo nome su prod-envgroup. Il nome del gruppo di ambienti successivi deve ancora essere prod.
2. Controlla lo stato di ApigeeRoute (AR).
  L'installazione di virtualhosts crea ApigeeRouteConfig (ARC), che crea internamente ApigeeRoute (AR) dopo che il watcher Apigee estrae i dettagli relativi al gruppo env dal piano di controllo. Verifica quindi che lo stato dell'AR corrispondente sia 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
```

Passaggio successivo

Installazioni che utilizzano Workload Identity

Se stai installando Apigee hybrid su GKE e stai configurando Workload Identity per autenticare gli account di servizio, 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

Tutte le altre installazioni

Nel passaggio successivo configurerai il gateway in entrata Apigee ed eseguirai il deployment di un proxy per testare l'installazione.

(AVANTI) Passaggio 1: espone Apigee Ingress 2