Como fazer upgrade do Apigee híbrido

Upgrade para uma nova versão

Siga estas etapas para fazer upgrade do Apigee híbrido para uma nova versão:

Faça o download e instale uma nova versão do apigeectl.

apigeectl é a interface de linha de comando (CLI, na sigla em inglês) para instalar e gerenciar o híbrido da Apigee em um cluster do Kubernetes.

Faça o download da versão de apigeectl que você quer fazer upgrade:

  1. Faça o download do pacote de lançamento para seu sistema operacional:

    Mac 64 bit:

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

    Linux de 64 bits

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

    Mac 32 bits:

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

    Linux 32 bit

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_linux_32.tar.gz
  2. Identifique o diretório de instalação base que foi criado quando o Apigee híbrido foi instalado originalmente. O diretório base é o diretório em que o diretório $APIGEEGTL_HOME reside. No exemplo a seguir, o diretório base é /Users/myhome/hybrid:

    echo $APIGEECTL_HOME
    /Users/myhome/hybrid/apigeectl
  3. Extraia o conteúdo do arquivo gzip transferido por download no diretório base do Apigee híbrido:

    tar xvzf filename.tar.gz -C path-to-base-directory
  4. cd ao diretório base.
  5. O conteúdo dos arquivos tar é, por padrão, expandido em um diretório com a versão e a plataforma no nome. Por exemplo, ./apigeectl_1.2.0-f7b96a8_linux_64.

  6. Renomeie o diretório apigeectl atual. Por exemplo, se a versão atual for 1.1.1, renomeie o diretório apigeectl para apigeectl_1.1.1.
  7. Renomeie o diretório de instalação recém-criado para apigeectl. É para ele que o ambiente $APIGEECTL_HOME aponta agora.
  8. Limpe os jobs concluídos do namespace do ambiente de execução híbrido, em que namespace é o namespace especificado no arquivo de modificações, se você especificou um namespace. Caso contrário, o namespace padrão é apigee:
    kubectl delete job -n namespace \
      $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  9. Limpe jobs concluídos do namespace apigee-system:
    kubectl delete job -n apigee-system \
      $(kubectl get job -n apigee-system -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  10. Limpe jobs concluídos do namespace istio-system:
    kubectl delete job -n istio-system \
      $(kubectl get job -n istio-system -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  11. cd para o diretório ./hybrid-files:
  12. Inicialize apigeectl para a nova versão:
    $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
  13. Verifique se a inicialização foi concluída:
    $APIGEECTL_HOME/apigeectl check-ready -f my-overrides.yaml
  14. Quando check-ready for aprovado, execute apigeectl apply:
    $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
  15. Execute check-ready novamente para determinar quando o upgrade será concluído.

Como reverter um upgrade

Siga estas etapas para reverter um upgrade anterior:

  1. Para limpar os jobs concluídos:
    kubectl delete job -n namespace $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  2. No diretório raiz da instalação para a qual você quer reverter, execute apigeectl init e, em seguida, execute apigeectl apply:
      $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
      $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml