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:

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:

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

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
```
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
```
cd ao diretório base.
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.
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.
Renomeie o diretório de instalação recém-criado para apigeectl. É para ele que o ambiente $APIGEECTL_HOME aponta agora.
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}')
```

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}')

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}')

Inicialize apigeectl para a nova versão:

$APIGEECTL_HOME/apigeectl init -f my-overrides.yaml

Verifique se a inicialização foi concluída:

$APIGEECTL_HOME/apigeectl check-ready -f my-overrides.yaml

Quando check-ready for aprovado, execute apigeectl apply:
```
$APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
```
Execute check-ready novamente para determinar quando o upgrade será concluído.

Siga estas etapas para reverter um upgrade anterior:

Para limpar os jobs concluídos:

kubectl delete job -n namespace $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

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
```