Fazer upgrade de um cluster não avançado e mantê-lo assim

Por padrão, um cluster não avançado será atualizado para um cluster avançado automaticamente quando você fizer upgrade para a versão 1.33. Embora recomendemos que você faça upgrade de um cluster não avançado para um avançado, se precisar fazer upgrade da versão 1.32 para a 1.33 e manter o cluster como não avançado, siga as etapas neste documento.

Para saber mais, consulte os seguintes artigos:

• Para informações sobre como fazer upgrade para a versão 1.32 e anteriores, consulte Fazer upgrade de um cluster.

• Para informações sobre como fazer upgrade de um cluster não avançado para um avançado, consulte Atualizar ou fazer upgrade de um cluster para um avançado.

Pré-requisitos

• A versão do gkectl precisa ser igual à versão do cluster de destino.

  • Se necessário, consulte Baixar o gkectl para ter uma versão compatível do gkectl.

• Sempre diagnostique o cluster antes de atualizar ou fazer upgrade.

• Verifique se os clusters usam apenas os recursos recomendados.

• É necessário fazer upgrade do cluster de administrador antes de fazer upgrade dos clusters de usuário.

Fazer upgrade do cluster de administrador

1. Faça upgrade da estação de trabalho do administrador se necessário.

2. Importe imagens do SO para o vSphere:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   Substitua:

   • BUNDLE_PATH: o caminho do arquivo do pacote. Esse arquivo está na estação de trabalho do administrador em /var/lib/gke/bundles/. Exemplo:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador

3. Defina enableAdvancedCluster no arquivo de configuração do cluster de administrador como false.

4. Verifique se o campo bundlepath no arquivo de configuração do cluster de administrador corresponde ao caminho do pacote que você quer fazer upgrade.

5. Faça upgrade do cluster de administrador e mantenha-o como um cluster não avançado:

   gkectl upgrade admin \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config ADMIN_CLUSTER_CONFIG
   

   Substitua:

   • ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador
   • ADMIN_CLUSTER_CONFIG: é o caminho do arquivo de configuração do cluster de administrador

   O comando vai recriar todos os nós no cluster de administrador.

Fazer upgrade do cluster de usuário

Importante: confira se o cluster de administrador já foi atualizado.

1. Importe imagens do SO para o vSphere:

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   Substitua:

   • BUNDLE_PATH: o caminho do arquivo do pacote. Esse arquivo está na estação de trabalho do administrador em /var/lib/gke/bundles/. Exemplo:

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador

2. Defina enableAdvancedCluster no arquivo de configuração do cluster de usuário como false.

3. Verifique se o campo gkeOnPremVersion no arquivo de configuração do cluster de usuário corresponde à versão de destino do upgrade.

4. Faça upgrade do cluster de usuário e mantenha-o como um cluster não avançado:

   gkectl upgrade cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config USER_CLUSTER_CONFIG
   

   Substitua:

   • ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador
   • USER_CLUSTER_CONFIG: o caminho do arquivo de configuração do cluster de usuário.

   O comando vai recriar todos os nós no cluster de usuário.