Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 11: installa Apigee hybrid utilizzando Helm

Installa i componenti del runtime di Apigee hybrid

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

Operatore Apigee
Datastore Apigee
Telemetria di 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 di preinstallazione

Se non hai ancora installato Helm 3.14.2 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. 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 non va a buon fine, puoi utilizzare l'output dei guardrail per aiutarti a diagnosticare la causa. Consulta Diagnostica dei 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. Consulta helm install --h per un elenco dei comandi, delle opzioni e dell'utilizzo supportati.
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 Helm di Apigee, ometti il flag --atomic da tutti i comandi seguenti.

Procedura di installazione

Verifica di avere una versione di Helm adatta.
```
helm version
```
La versione di Helm richiesta per questa installazione è la v3.14.2+. 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 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 \
  --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.2   1.12.2

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 il data store 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 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 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 Apigee Ingress Manager:

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

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 il parametro $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).
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 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 disponi di un ambiente prod e 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 lo stato corrispondente dell'AR 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 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 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.

(SUCCESSIVO) Passaggio 1: esponi Apigee Ingress 2