Atualizar um cluster para um cluster avançado

Neste documento, mostramos como atualizar um cluster para um cluster avançado a partir da versão 1.32.

Pré-requisitos

  • Sempre diagnostique seu cluster antes de atualizá-lo.

  • Verifique se os clusters usam apenas os recursos recomendados.

  • Verifique se os clusters não usam recursos sem suporte de clusters avançados antes de iniciar a atualização. Se algum recurso sem suporte estiver ativo, desative-o usando a atualização.

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

  • É necessário atualizar o cluster de administrador para um cluster avançado antes de atualizar os clusters de usuário.

Atualizar o cluster de administrador para avançado

Atualizar

  1. Prepare-se para 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 recria 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-se para 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 administrativo.

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

  • Os clusters de usuários não avançados continuam funcionando normalmente.

  • Só é possível criar clusters de usuários 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 depois para manter um ambiente consistente e com todos os recursos.

Atualizar o cluster de usuário para 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-se para 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ários.

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-se para 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 recria todos os nós no cluster de usuários.