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

  1. Se non hai ancora installato Helm 3.14.2 o versioni successive, segui le istruzioni riportate in Installazione di Helm.
  2. 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.

  3. 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.
  4. 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

  1. 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
  2. Vai alla directory APIGEE_HELM_CHARTS_HOME. Esegui i seguenti comandi da quella directory.
  3. 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.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
    
  4. 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
    
  5. 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
    
  6. 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
    
  7. 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
    
  8. 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
    
  9. 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
    
  10. 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
      
    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