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:
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órioapigeectl
paraapigeectl_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}')
cd
para o diretório./hybrid-files
:- 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, executeapigeectl apply
:$APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
- Execute
check-ready
novamente para determinar quando o upgrade será concluído.
Como reverter um upgrade
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, executeapigeectl apply
:$APIGEECTL_HOME
/apigeectl init -f my-overrides.yaml$APIGEECTL_HOME
/apigeectl apply -f my-overrides.yaml