Upgrade di Apigee hybrid

Upgrade a una nuova versione

Segui questi passaggi per eseguire l'upgrade di Apigee hybrid a una nuova versione:

Scarica e installa una nuova versione di apigeectl.

apigeectl è l'interfaccia a riga di comando (CLI) per l'installazione e la gestione di Apigee hybrid in un cluster Kubernetes.

Scarica la versione di apigeectl a cui vuoi eseguire l'upgrade:

  1. Scarica il pacchetto di release per il tuo sistema operativo:

    Mac a 64 bit:

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

    Linux a 64 bit

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

    Mac 32 bit:

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

    Linux a 32 bit

    curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_linux_32.tar.gz
  2. Identifica la directory di installazione di base creata quando Apigee hybrid è stato installato in origine. La directory di base è la directory in cui si trova la directory $APIGEEGTL_HOME. Nell'esempio seguente, la directory di base è /Users/myhome/hybrid:

    echo $APIGEECTL_HOME
/Users/myhome/hybrid/apigeectl

  3. Estrai il contenuto del file gzip scaricato nella directory di base ibrida di Apigee:

    tar xvzf filename.tar.gz -C path-to-base-directory
  4. cd alla directory di base.

  5. Per impostazione predefinita, i contenuti tar vengono espansi in una directory il cui nome contiene la versione e la piattaforma. Ad esempio: ./apigeectl_1.2.0-f7b96a8_linux_64.

  6. Rinomina la directory apigeectl attuale. Ad esempio, se la versione corrente è 1.1.1, rinomina la directory apigeectl in apigeectl_1.1.1.
  7. Rinomina la directory di installazione appena estratta in apigeectl. Questo è ora il punto a cui rimanda l'ambiente $APIGEECTL_HOME.
  8. Esegui la pulizia dei job completati per lo spazio dei nomi del runtime ibrido, dove namespace è lo spazio dei nomi specificato nel file degli 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}')
  9. Esegui la pulizia dei 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}')
  10. Esegui la pulizia dei job completati per lo spazio dei nomi istio-system: 
    kubectl delete job -n istio-system \
  $(kubectl get job -n istio-system -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  11. cd alla directory ./hybrid-files:
  12. Inizializza apigeectl per la nuova versione: 
    $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
  13. Controlla per determinare quando l'inizializzazione è completa: 
    $APIGEECTL_HOME/apigeectl check-ready -f my-overrides.yaml
  14. Quando viene superato il criterio check-ready, esegui apigeectl apply: 
    $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
  15. Esegui di nuovo check-ready per determinare quando l'upgrade è completo.

Rollback di un upgrade in corso...

Per eseguire il rollback di un upgrade precedente:

  1. Esegui la pulizia dei job completati: 
    kubectl delete job -n namespace $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  2. Nella directory root dell'installazione di cui vuoi eseguire il rollback, esegui apigeectl init, quindi esegui apigeectl apply: 
      $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
  $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml