Esta página foi traduzida pela API Cloud Translation.

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