Atualizar o Apigee Hybrid

Atualizar para uma nova versão

Siga estes passos para atualizar o Apigee hybrid para uma nova versão:

Transfira e instale uma nova versão da app apigeectl.

apigeectl é a interface de linhas de comando (CLI) para instalar e gerir o Apigee Hybrid num cluster do Kubernetes.

Transfira a versão do apigeectl para a qual quer atualizar:

1. Transfira o pacote de lançamento para o seu sistema operativo:

   Mac 64 bits:

   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 de 32 bits:

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

   Linux de 32 bits

   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 Hybrid foi instalado originalmente. O diretório base é o diretório no qual reside o diretório $APIGEEGTL_HOME. No exemplo seguinte, o diretório base é /Users/myhome/hybrid:

   echo $APIGEECTL_HOME
   /Users/myhome/hybrid/apigeectl

3. Extraia o conteúdo do ficheiro gzip transferido para o diretório base do Apigee Hybrid:

   tar xvzf filename.tar.gz -C path-to-base-directory

4. cd para o diretório base.

5. Por predefinição, o conteúdo do ficheiro TAR é expandido para um diretório com a versão e a plataforma no nome. Por exemplo: ./apigeectl_1.2.0-f7b96a8_linux_64.

6. Mude o nome do diretório apigeectl atual. Por exemplo, se a versão atual for 1.1.1, mude o nome do diretório apigeectl para apigeectl_1.1.1.
7. Mude o nome do diretório de instalação recém-extraído para apigeectl. É aqui que o ambiente $APIGEECTL_HOME aponta.
8. Limpe as tarefas concluídas para o espaço de nomes de tempo de execução híbrido, em que namespace é o espaço de nomes especificado no ficheiro de substituições, se tiver especificado um espaço de nomes. Caso contrário, o espaço de nomes predefinido é apigee:

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

9. Limpe as tarefas concluídas para o espaço de nomes apigee-system:

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

10. Limpe as tarefas concluídas para o espaço de nomes 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 o apigeectl para a nova versão:

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

13. Verifique para determinar quando a inicialização está concluída:

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

14. Quando check-ready passa, execute apigeectl apply:

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

15. Execute novamente check-ready para determinar quando a atualização está concluída.

Reverter uma atualização

Siga estes passos para reverter uma atualização anterior:

1. Limpe tarefas concluídas:

   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 quer reverter, execute apigeectl init e, de seguida, execute apigeectl apply:

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