Atualize um cluster para um cluster avançado

Este documento mostra como atualizar ou fazer uma atualização para um cluster avançado a partir da versão 1.32.

Importante: os agrupamentos não avançados vão ser atualizados automaticamente para agrupamentos avançados na versão 1.33.

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.

• Verifique se os seus clusters não usam funcionalidades não suportadas por clusters avançados antes de iniciar a atualização. Se existirem funcionalidades não suportadas ativas, desative-as primeiro através do comando update.

  • Embora os clusters de utilizadores de alta disponibilidade (HA) sejam necessários em clusters avançados, ainda pode atualizar ou fazer a atualização de um cluster de utilizadores não HA para um cluster avançado HA seguindo este guia.

• Tem de atualizar ou fazer a atualização do cluster de administrador para um cluster avançado antes de atualizar ou fazer a atualização de quaisquer clusters de utilizadores.

Atualize o cluster de administrador para um cluster avançado

Atualizar

Importante: certifique-se de que a versão do cluster é, pelo menos, 1.32.0.

1. Prepare-se para o cluster avançado:

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

   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.32.0-gke.1085-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 administrador para true.

3. Atualize o cluster de administrador para o cluster avançado:

   gkectl update 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 recria todos os nós no cluster de administrador.

Atualizar

Aviso: se o seu cluster estiver a usar cos ou cos_cgv2 como o tipo de imagem do SO do plano de controlo ou o tipo de imagem do SO do conjunto de nós, certifique-se de que a versão do cluster é, pelo menos, 1.32.0 antes da atualização. Caso contrário, certifique-se de que a versão do cluster é, pelo menos, 1.31.100.

1. Atualize a sua estação de trabalho de administrador se necessário.

2. Prepare-se para o cluster avançado:

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

   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.32.0-gke.1085-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 true.

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 para o cluster 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. Com a estratégia de implementação de recriação da implementação, os nós são atualizados um de cada vez. Durante a atualização do nó, a VM é eliminada e, em seguida, recriada com a nova versão.

Depois de o cluster de administrador ter sido atualizado ou alterado para um cluster avançado:

• Os seus clusters de utilizadores não avançados existentes continuam a funcionar normalmente.

• Só pode criar clusters de utilizadores avançados geridos pelo cluster de administrador avançado.

Recomendamos que atualize todos os clusters de utilizadores para clusters avançados logo depois para manter um ambiente consistente e com todas as funcionalidades.

Atualize o cluster de utilizadores para o cluster avançado

Importante: certifique-se de que o cluster de administrador já foi atualizado ou atualizado para o cluster avançado.

Atualizar

Importante: certifique-se de que a versão do cluster é, pelo menos, 1.32.0.

1. Se o plano de controlo do cluster de utilizadores não estiver altamente disponível (HA):

   Aviso: devido a um problema conhecido com o campo masterNode.replicas, para atualizar um cluster de utilizadores não HA da versão 1.32 ou da versão 1.33 para um cluster avançado HA, o cluster tem de estar numa versão superior a 1.32.600 ou superior a 1.33.100, respetivamente.

   1. Alterar masterNode.replicas de 1 para 3.

   2. Adicione os endereços IP estáticos dos nós do plano de controlo do cluster de utilizadores à secção network.controlPlaneIPBlock.ips.

2. Prepare-se para o cluster avançado:

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

   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.32.0-gke.1085-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 utilizadores como true.

4. Atualize o cluster de utilizadores para o cluster avançado:

   gkectl update 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 vai implementar novamente todos os nós no cluster de utilizadores. Com a estratégia de implementação de recriação de implementação, os nós são atualizados um de cada vez. Durante a atualização do nó, a VM é eliminada e, em seguida, recriada com a nova configuração.

Atualizar

Aviso: se o seu cluster estiver a usar cos ou cos_cgv2 como o tipo de imagem do SO do plano de controlo ou o tipo de imagem do SO do conjunto de nós, certifique-se de que a versão do cluster é, pelo menos, 1.32.0 antes da atualização. Caso contrário, certifique-se de que a versão do cluster é, pelo menos, 1.31.100.

1. Se o plano de controlo do cluster de utilizadores não estiver altamente disponível (HA):

   1. Alterar masterNode.replicas de 1 para 3.

   2. Adicione os endereços IP estáticos dos nós do plano de controlo do cluster de utilizadores à secção network.controlPlaneIPBlock.ips.

2. Prepare-se para o cluster avançado:

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

   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.32.0-gke.1085-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 utilizadores como true.

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

5. Atualize o cluster de utilizadores para o cluster 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.

Principais diferenças após a mudança para clusters avançados

A atualização do cluster para um cluster avançado introduz várias diferenças importantes em comparação com os clusters padrão. Seguem-se as principais alterações nos clusters avançados:

• Localização dos recursos: os recursos de cluster e de máquina já não estão localizados em clusters de utilizadores. Estes recursos estão localizados exclusivamente no cluster de administração.

• NodeExternalIP: o NodeExternalIP não está definido nos nós.

• Instalação do cert-manager: o cert-manager é instalado automaticamente em clusters avançados. Se instalou o cert-manager no seu cluster, a atualização para o cluster avançado substitui-o pela versão do cluster avançado.

Para uma vista geral abrangente das diferenças entre funcionalidades, consulte a tabela de comparação de funcionalidades.