Atualize um cluster não avançado e mantenha-o como não avançado

Por predefinição, um cluster não avançado é atualizado automaticamente para um cluster avançado quando atualiza para a versão 1.33. Embora recomendemos que atualize um cluster não avançado para um cluster avançado, se precisar de atualizar da versão 1.32 para a 1.33 e manter o cluster como não avançado, siga os passos descritos neste documento.

Consulte o seguinte para mais informações:

• Para obter informações sobre a atualização para a versão 1.32 e anteriores, consulte o artigo Atualize um cluster.

• Para ver informações sobre como atualizar um cluster não avançado para um cluster avançado, consulte o artigo Atualize ou atualize um cluster para um cluster avançado.

Pré-requisitos

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

  • Se necessário, consulte a secção Transferir gkectl para obter uma versão suportada do gkectl.

• Diagnostique sempre o cluster antes de o atualizar.

• Certifique-se de que os seus clusters usam apenas funcionalidades recomendadas.

• Tem de atualizar o cluster de administrador antes de atualizar quaisquer clusters de utilizadores.

Atualize o cluster de administrador

1. Atualize a sua estação de trabalho de administração 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 o seguinte:

   • BUNDLE_PATH: o caminho do ficheiro do pacote. Este ficheiro encontra-se na estação de trabalho do administrador em /var/lib/gke/bundles/. Por exemplo:

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

   • ADMIN_CLUSTER_KUBECONFIG: o caminho do ficheiro kubeconfig do cluster de administrador.

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

4. Certifique-se de que o campo bundlepath no ficheiro de configuração do cluster de administrador corresponde ao caminho do pacote para o qual quer fazer a atualização.

5. Atualize o 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 o seguinte:

   • ADMIN_CLUSTER_KUBECONFIG: o caminho do ficheiro kubeconfig do cluster de administrador.
   • ADMIN_CLUSTER_CONFIG: o caminho do ficheiro de configuração do cluster de administrador.

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

Atualize o cluster de utilizadores

Importante: certifique-se de que 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 o seguinte:

   • BUNDLE_PATH: o caminho do ficheiro do pacote. Este ficheiro encontra-se na estação de trabalho do administrador em /var/lib/gke/bundles/. Por exemplo:

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

   • ADMIN_CLUSTER_KUBECONFIG: o caminho do ficheiro kubeconfig do cluster de administrador.

2. Defina enableAdvancedCluster no ficheiro de configuração do cluster de utilizadores como false.

3. Certifique-se de que o campo gkeOnPremVersion no ficheiro de configuração do cluster de utilizadores corresponde à versão de destino da atualização.

4. Atualize o cluster de utilizadores e mantenha-o como um cluster não avançado:

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

   Substitua o seguinte:

   • ADMIN_CLUSTER_KUBECONFIG: o caminho do ficheiro kubeconfig do cluster de administrador.
   • USER_CLUSTER_CONFIG: o caminho do ficheiro de configuração do cluster de utilizadores.

   O comando recria todos os nós no cluster de utilizadores.