Upgrade di Apigee hybrid alla versione 1.10

Questa procedura riguarda l'upgrade dalla versione ibrida di Apigee dalla versione 1.9.x ad quella ibrida di Apigee versione 1.10.4 e dalle release precedenti dell'ibrido 1.10.x alla versione 1.10.4.

Utilizza le stesse procedure per gli upgrade delle versioni secondarie (ad esempio dalla versione 1.9 alla versione 1.10) e per gli upgrade delle release delle patch (ad esempio dalla versione 1.10.0 alla versione 1.10.4).

Panoramica dell'upgrade alla versione 1.10.4

Le procedure per l'upgrade di Apigee hybrid sono organizzate nelle seguenti sezioni:

  1. Preparati per l'upgrade.
  2. Installa la versione del runtime ibrido 1.10.4.

Prerequisiti

Queste istruzioni per l'upgrade presuppongono che sia installata la versione ibrida di Apigee 1.9.x e che vuoi eseguirne l'upgrade alla versione 1.10.4. Se stai eseguendo l'aggiornamento da una versione precedente, consulta le istruzioni per eseguire l'upgrade di Apigee hybrid alla versione 1.9.

Preparati per l'upgrade alla versione 1.10

  1. Queste istruzioni utilizzano la variabile di ambiente APIGEECTL_HOME per la directory nel file system in cui hai installato apigeectl. Se necessario, cambia directory nella directory apigeectl e definisci la variabile con il seguente comando:

    Linux 

    export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME

    Mac OS 

    export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME

    Windows 

    set APIGEECTL_HOME=%CD%
echo %APIGEECTL_HOME%
  2. Crea una copia di backup della directory $APIGEECTL_HOME/ della versione 1.9. Ad esempio: 
    tar -czvf $APIGEECTL_HOME/../apigeectl-v1.9-backup.tar.gz $APIGEECTL_HOME
  3. Esegui il backup del database Cassandra seguendo le istruzioni in Backup e ripristino di Cassandra.

Esegui l'upgrade della versione di Kubernetes

Controlla la versione della piattaforma Kubernetes e, se necessario, esegui l'upgrade della piattaforma Kubernetes a una versione supportata sia da hybrid 1.9 che da hybrid 1.10. Se hai bisogno di assistenza, segui la documentazione della piattaforma.

installa il runtime ibrido 1.10.4

  1. Assicurati di essere nella directory di base ibrida (la directory padre della directory in cui si trova il file eseguibile apigeectl): 
    cd $APIGEECTL_HOME/..

  2. Scarica il pacchetto di release per il tuo sistema operativo utilizzando il seguente comando. Assicurati di selezionare la tua piattaforma nella seguente tabella:

    Linux

    Linux a 64 bit:

    curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.10.4/apigeectl_linux_64.tar.gz

    Mac OS

    Mac 64 bit:

    curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.10.4/apigeectl_mac_64.tar.gz

    Windows

    Windows a 64 bit:

    curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.10.4/apigeectl_windows_64.zip
  3. Rinomina la directory apigeectl/ attuale in un nome di directory di backup. Ad esempio:

    Linux 

    mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.9/

    Mac OS 

    mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.9/

    Windows 

    rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.9

  4. Estrai il contenuto del file gzip scaricato nella directory base ibrida. La directory di base ibrida è la directory in cui si trova la directory apigeectl-v1.9 rinominata:

    Linux 

    tar xvzf filename.tar.gz -C ./

    Mac OS 

    tar xvzf filename.tar.gz -C ./

    Windows 

    tar xvzf filename.zip -C ./

  5. I contenuti tar vengono, per impostazione predefinita, espansi in una directory che contiene la versione e la piattaforma nel nome. Ad esempio: ./apigeectl_1.10.4-xxxxxxx_linux_64. Rinomina la directory in apigeectl utilizzando il seguente comando:

    Linux 

    mv apigeectl_1.10.4-xxxxxxx_linux_64 apigeectl

    Mac OS 

    mv apigeectl_1.10.4-xxxxxxx_mac_64 apigeectl

    Windows 

    rename apigeectl_1.10.4-xxxxxxx_windows_64 apigeectl
  6. Passa alla directory apigeectl: 
    cd ./apigeectl

    Questa è la home directory apigeectl. È qui che si trova il comando eseguibile apigeectl.

  7. Queste istruzioni utilizzano la variabile di ambiente $APIGEECTL_HOME per la directory nel file system in cui è installata l'utilità apigeectl. Se necessario, cambia directory nella directory apigeectl e definisci la variabile con il seguente comando:

    Linux 

    export APIGEECTL_HOME=$PWD
    echo $APIGEECTL_HOME

    Mac OS 

    export APIGEECTL_HOME=$PWD
    echo $APIGEECTL_HOME

    Windows 

    set APIGEECTL_HOME=%CD%
    echo %APIGEECTL_HOME%
  8. Verifica la versione di apigeectl con il comando version: 
    ./apigeectl version
    Version: 1.10.4
  9. Crea una directory hybrid-base-directory/hybrid-files e quindi spostala al suo interno. La directory hybrid-files è la posizione dei file di configurazione, come il file di override, i certificati e gli account di servizio. Ad esempio:

    Linux 

    mkdir $APIGEECTL_HOME/../hybrid-files
    cd $APIGEECTL_HOME/../hybrid-files

    Mac OS 

    mkdir $APIGEECTL_HOME/../hybrid-files
    cd $APIGEECTL_HOME/../hybrid-files

    Windows 

    mkdir %APIGEECTL_HOME%/../hybrid-files
    cd %APIGEECTL_HOME%/../hybrid-files
  10. Verifica che kubectl sia impostato sul contesto corretto utilizzando il seguente comando. Il contesto attuale deve essere impostato sul cluster in cui stai eseguendo l'upgrade di Apigee hybrid. 
    kubectl config get-contexts | grep \*
  11. Nella directory hybrid-files:
    1. Aggiorna i seguenti link simbolici a $APIGEECTL_HOME. Questi link ti consentono di eseguire il comando apigeectl appena installato dall'interno della directory hybrid-files: 
      ln -nfs $APIGEECTL_HOME/tools tools
ln -nfs $APIGEECTL_HOME/config config
ln -nfs $APIGEECTL_HOME/templates templates
ln -nfs $APIGEECTL_HOME/plugins plugins
    2. Per verificare che i link simbolici siano stati creati correttamente, esegui il comando seguente e assicurati che i percorsi dei link rimandino alle posizioni corrette: 
      ls -l | grep ^l
  12. Esegui un'inizializzazione di prova per verificare la presenza di errori: 
    ${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client

    Dove OVERRIDES_FILE è il nome del file di override, ad esempio ./overrides/overrides.yaml.

  13. Se non sono presenti errori, inizializza l'ibrido 1.10.4: 
    $APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
  14. Controlla lo stato di inizializzazione: 
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

    Se l'operazione riesce, l'output dice: All containers ready. 

    kubectl describe apigeeds -n apigee

    Cerca State: running nell'output.

  15. Verifica la presenza di errori con una prova del comando apply utilizzando il flag --dry-run: 
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
  16. Se non sono presenti errori, applica gli override. Seleziona e segui le istruzioni per gli ambienti di produzione o non di produzione, a seconda dell'installazione.

    Produzione

    Per gli ambienti di produzione, esegui l'upgrade di ogni componente ibrido singolarmente e controlla lo stato del componente sottoposto ad upgrade prima di passare al componente successivo.

    1. Assicurati di essere nella directory hybrid-files.
    2. Applica gli override per eseguire l'upgrade di Cassandra: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --datastore
    3. Completamento del controllo: 
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

      Procedi al passaggio successivo solo quando i pod sono pronti.

    4. Applica gli override per eseguire l'upgrade dei componenti di telemetria e controlla il completamento: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --telemetry
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    5. Visualizza i componenti Redis: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --redis
    6. Applica gli override per eseguire l'upgrade dei componenti a livello di organizzazione (MART, Watcher e Apigee Connect) e verifica il completamento: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --org
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    7. Applica gli override per eseguire l'upgrade dei tuoi ambienti. Hai due possibilità:
      • Ambiente per ambiente: applica gli override a un ambiente alla volta e verifica il completamento. Ripeti questo passaggio per ogni ambiente: 
        $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --env ENV_NAME
        $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

        Dove ENV_NAME è il nome dell'ambiente di cui stai eseguendo l'upgrade.

      • Tutti gli ambienti contemporaneamente: applica gli override a tutti gli ambienti contemporaneamente e verifica il completamento: 
        $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --all-envs
        $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    8. Applica gli override per eseguire l'upgrade dei componenti virtualhosts e controlla il completamento: 
      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --settings virtualhosts
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

    Non di produzione

    Nella maggior parte degli ambienti non di produzione, demo o sperimentali, puoi applicare gli override a tutti i componenti contemporaneamente. Se il tuo ambiente non di produzione è di grandi dimensioni e complesso o riproduce da vicino un ambiente di produzione, puoi utilizzare le istruzioni per eseguire l'upgrade degli ambienti di produzione.

    1. Assicurati di essere nella directory hybrid-files.
    2. $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE
    3. Controlla lo stato: 
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
  17. Installa 1.10.3-hotfix.1. Per ulteriori informazioni, consulta ibrid 1.10.3-hotfix.1 nelle note di rilascio di Apigee.
  18. Installa 1.10.3-hotfix.2. Per ulteriori informazioni, consulta ibrid 1.10.3-hotfix.2 nelle note di rilascio di Apigee.
  19. Installa 1.10.3-hotfix.3. Per ulteriori informazioni, consulta ibrid 1.10.3-hotfix.3 nelle note di rilascio di Apigee.
  20. Installa 1.10.3-hotfix.4. Per ulteriori informazioni, consulta ibrid 1.10.3-hotfix.4 nelle note di rilascio di Apigee.

Installazione di 1.10.4-hotfix.1

Utilizza i seguenti comandi per installare la release di aggiornamento rapido, 1.10.4-hotfix.1. Per ulteriori informazioni, consulta ibrid 1.10.4-hotfix.1 nelle note di rilascio di Apigee.

  1. Apri il file di override.
  2. Innanzitutto, aggiorna il file di override. Segui le istruzioni appropriate per lo strumento che stai utilizzando per gestire Apigee hybrid, Helm o apigeectl:

    Helm

    1. Nella stanza istiod, cambia la versione del tag immagine (se presente) in versione 1.17.8. Ad esempio: 
      istiod:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-istiod"
    tag: "1.17.8-asm.20-distroless"
    2. Nella stanza apigeeIngressGateway, cambia la versione del tag immagine (se presente) in versione 1.17.8. Ad esempio: 
      apigeeIngressGateway:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
    tag: "1.17.8-asm.20-distroless"
    3. Salva il file.

    apigeectl

    1. Nella stanza istiod, cambia la versione del tag immagine (se presente) in versione 1.17.8. Ad esempio: 
      istiod:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-istiod"
    tag: "1.17.8-asm.20-distroless"
    2. A seconda di come hai scelto di installare Apigee hybrid, potresti avere una stanza ingressGateway o ingressGateways. Individua la stanza visualizzata nel file di override e modifica la versione del tag immagine (se presente) in versione 1.17.8. Ad esempio, se hai una stanza ingressGateway: 
      ingressGateway:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
    tag: "1.17.8-asm.20-distroless"

      oppure, se hai una ingressGateways stanza:

      ingressGateways:
  - name: gateway1
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.8-asm.20-distroless"
    ...
  - name: gateway2
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.8-asm.20-distroless"
    ...
    3. Salva il file.
  3. Quindi, applica le modifiche. Segui le istruzioni appropriate per lo strumento che stai utilizzando per gestire Apigee hybrid, Helm o apigeectl:

    Helm

    1. Installa il grafico apigee-ingress-manager con il seguente comando: 
      helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace "YOUR_APIGEE_NAMESPACE" \
  --atomic \
  -f OVERRIDES_FILE
    2. Installa il grafico apigee-org con il seguente comando: 
      helm upgrade ORG_NAME apigee-org/ \
    --install \
    --namespace "YOUR_APIGEE_NAMESPACE" \
    --atomic \
    -f OVERRIDES_FILE
    3. Verifica lo stato dei pod: 
      kubectl get pods -n YOUR_APIGEE_NAMESPACE

    apigeectl

    1. Esegui questo comando per inizializzare il componente istiod: 
      $APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    2. Esegui questo comando per applicare le modifiche ai componenti Apigee Ingress. Se disponi di più organizzazioni, ripeti questo comando per ognuna: 
      $APIGEECTL_HOME/apigeectl apply --org -f OVERRIDES_FILE
      $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    3. Verifica lo stato dei pod: 
      kubectl get pods -n YOUR_APIGEE_NAMESPACE

Rollback di un upgrade

Per eseguire il rollback di un upgrade precedente, segui questi passaggi:

  1. Esegui la pulizia dei job completati per lo spazio dei nomi del runtime ibrido, dove NAMESPACE è lo spazio dei nomi specificato nel file di override, se hai specificato uno spazio dei nomi. In caso contrario, lo spazio dei nomi predefinito è apigee: 
    kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  2. Pulisci i job completati per lo spazio dei nomi apigee-system: 
    kubectl delete job -n apigee-system \
  $(kubectl get job -n apigee-system \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  3. Modifica la variabile APIGEECTL_HOME in modo che punti alla directory che contiene la versione precedente di apigeectl. Ad esempio: 
    export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
  4. Nella directory root dell'installazione di cui vuoi eseguire il rollback, esegui apigeectl apply, controlla lo stato dei pod, quindi esegui apigeectl init. Assicurati di utilizzare il file di override originale per la versione a cui vuoi eseguire il rollback:
    1. Nella directory dei file ibridi, esegui apigeectl apply: 
      $APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE

      Dove ORIGINAL_OVERRIDES_FILE è il percorso e il nome file relativi del file di override per l'installazione ibrida della versione precedente, ad esempio ./overrides/overrides1.9.yaml.

    2. Controlla lo stato dei pod: 
      kubectl -n NAMESPACE get pods

      Dove NAMESPACE è lo spazio dei nomi ibrido di Apigee.

    3. Controlla lo stato di apigeeds: 
      kubectl describe apigeeds -n apigee

      L'output dovrebbe essere simile al seguente: 

      Status:
  Cassandra Data Replication:
  Cassandra Pod Ips:
    10.8.2.204
  Cassandra Ready Replicas:  1
  Components:
    Cassandra:
      Last Successfully Released Version:
        Revision:  v1-f8aa9a82b9f69613
        Version:   v1
      Replicas:
        Available:  1
        Ready:      1
        Total:      1
        Updated:    1
      State:        running
  Scaling:
    In Progress:         false
    Operation:
    Requested Replicas:  0
  State:                 running

      Procedi al passaggio successivo solo quando il pod apigeeds è in esecuzione.

    4. Esegui questo comando per prendere nota dei valori del conteggio delle nuove repliche per il processore di messaggi dopo l'upgrade. Se questi valori non corrispondono a quelli che hai impostato in precedenza, modifica i valori nel file di override in modo che corrispondano alla configurazione precedente. 
      apigeectl apply -f ORIGINAL_OVERRIDES_FILE --dry-run=client --print-yaml --env ENV_NAME 2>/dev/null |grep "runtime:" -A 25 -B 1| grep "autoScaler" -A 2

      L'output dovrebbe essere simile al seguente: 

            autoScaler:
        minReplicas: 2
        maxReplicas: 10
    5. Esecuzione apigeectl init: 
      $APIGEECTL_HOME/apigeectl init -f ORIGINAL_OVERRIDES_FILE