Atualizar um cluster para um cluster avançado

Neste documento, mostramos como atualizar ou fazer upgrade de um cluster para um cluster avançado da versão 1.32.

Pré-requisitos

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

  • Verifique se os clusters usam apenas os recursos recomendados.

  • Verifique se os clusters não usam nenhum recurso não compatível com clusters avançados antes de iniciar a atualização ou o upgrade. Se algum recurso sem suporte estiver ativo, desative-o usando update primeiro.

    • Embora os clusters de usuário de alta disponibilidade (HA) sejam necessários em clusters avançados, ainda é possível atualizar ou fazer upgrade de um cluster de usuário não HA para um cluster avançado de HA seguindo este guia.

  • É necessário atualizar ou fazer upgrade do cluster de administrador para um cluster avançado antes de atualizar ou fazer upgrade de clusters de usuário.

Atualizar ou fazer upgrade do cluster de administrador para um cluster avançado

Atualizar

  1. Prepare o cluster avançado:

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

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

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

    gkectl update 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

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

  2. Prepare o cluster avançado:

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

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

  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 para o cluster 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.

Depois que o cluster de administrador for atualizado ou fizer upgrade para um cluster avançado:

  • Os clusters de usuário não avançados atuais vão continuar funcionando normalmente.

  • Só é possível criar clusters de usuário avançados gerenciados pelo cluster de administrador avançado.

Recomendamos que você faça upgrade de todos os clusters de usuário para clusters avançados logo em seguida para manter um ambiente consistente e com todos os recursos.

Atualizar ou fazer upgrade do cluster de usuário para um cluster avançado

Atualizar

  1. Se o plano de controle do cluster de usuário não estiver altamente disponível (HA):

    1. Mude masterNode.replicas de 1 para 3.

    2. Adicione os endereços IP estáticos para os nós do plano de controle do cluster de usuário à seção network.controlPlaneIPBlock.ips.

  2. Prepare o cluster avançado:

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

    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.32.0-gke.1085-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 usuário como true.

  4. Atualize o cluster de usuário para o cluster avançado:

    gkectl update 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.

Fazer upgrade

  1. Se o plano de controle do cluster de usuário não estiver altamente disponível (HA):

    1. Mude masterNode.replicas de 1 para 3.

    2. Adicione os endereços IP estáticos para os nós do plano de controle do cluster de usuário à seção network.controlPlaneIPBlock.ips.

  2. Prepare o cluster avançado:

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

    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.32.0-gke.1085-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 usuário como true.

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

  5. Faça upgrade do cluster de usuário para o cluster 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.

Principais diferenças após a migração para clusters avançados

Fazer upgrade ou atualizar seu cluster para um cluster avançado apresenta várias diferenças importantes em comparação com os clusters padrão. Confira as principais mudanças nos clusters avançados:

  • Localização do recurso: os recursos de cluster e máquina não estão mais localizados em clusters de usuários. Esses recursos estão localizados exclusivamente no cluster de administrador.

  • 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 você instalou o cert-manager no cluster, a atualização ou o upgrade para o cluster avançado o substitui pela versão avançada.

Para uma visão geral completa das diferenças entre os recursos, consulte a tabela de comparação de recursos.