Atualize um cluster do Tanzu Kubernetes atualizando a versão do Kubernetes.

Você pode atualizar um cluster do Tanzu Kubernetes atualizando a versão do Kubernetes. Para fazer isso, altere a versão de distribuição do cluster nas propriedades .spec.distribution.version e .spec.distribution.fullVersion do manifesto do cluster.

Pré-requisitos

Consulte a lista de versões compatíveis do Tanzu Kubernetes para obter recomendações de compatibilidade e atualização.

Essa tarefa usa o comando kubectl edit tanzukubernetescluster/CLUSTER-NAME para atualizar o manifesto do cluster. O comando kubectl edit abre o manifesto do cluster no editor de texto definido pela variável de ambiente KUBE_EDITOR ou EDITOR. Quando você salva o arquivo, o cluster é atualizado com as alterações. Consulte o Especificar um editor de texto padrão para o Kubectl.

Procedimento

  1. Autentique-se com o Supervisor Cluster. Consulte o Conecte-se ao Supervisor Cluster como um usuário do vCenter Single Sign-On.
    kubectl vsphere login --server=IP-ADDRESS --vsphere-username USERNAME
  2. Alterne o contexto para o vSphere Namespace onde o cluster Tanzu Kubernetes de destino está provisionado.
    kubectl config use-context SUPERVISOR-NAMESPACE
  3. Obtenha o cluster e a versão de destino do Tanzu Kubernetes.
    kubectl get tanzukubernetescluster
    Por exemplo:
    kubectl get tanzukubernetescluster
    NAME             CONTROL PLANE   WORKER   DISTRIBUTION                     AGE   PHASE
    tkgs-cluster-1   3               3        v1.17.8+vmware.1-tkg.1.5417466   19h   running
  4. Liste as versões de Tanzu Kubernetes disponíveis executando qualquer um dos seguintes comandos.
    kubectl get tanzukubernetesreleases
    kubectl get virtualmachineimages
    Neste cenário de exemplo, atualizamos um cluster Tanzu Kubernetes da v1.17.8 para a v1.18.5.
  5. Execute o seguinte comando para editar o manifesto do cluster.
    kubectl edit tanzukubernetescluster/CLUSTER-NAME
  6. Edite o manifesto alterando a cadeia de caracteres version e removendo ou anulando o fullVersion para evitar uma possível incompatibilidade de versão durante a descoberta.
    Por exemplo, altere o manifesto do seguinte:
    spec:
      distribution:
        fullVersion: v1.17.8+vmware.1-tkg.1.5417466
        version: v1.17.8
    Para o seguinte:
    spec:
      distribution:
        fullVersion: null
        version: v1.18.5
  7. Salve as alterações feitas no arquivo de manifesto.
    Quando você salva o arquivo, o kubectl aplica as alterações ao cluster. Em segundo plano, o Serviço de Máquina Virtual no Cluster de Supervisor provisiona o novo nó de trabalhador.
  8. Verifique se o kubectl informa que as edições do manifesto foram registradas com êxito.
    kubectl edit tanzukubernetescluster/tkgs-cluster-1
    tanzukubernetescluster.run.tanzu.vmware.com/tkgs-cluster-1 edited
    Observação: Se você receber um erro ou o kubectl não relatar que o manifesto do cluster foi editado com êxito, verifique se você configurou corretamente seu editor de texto padrão usando a variável de ambiente KUBE_EDITOR. Consulte o Especificar um editor de texto padrão para o Kubectl.
  9. Verifique se o cluster está sendo atualizado.
    kubectl get tanzukubernetescluster
    NAME             CONTROL PLANE   WORKER   DISTRIBUTION                     AGE   PHASE
    tkgs-cluster-1   3               3        v1.18.5+vmware.1-tkg.1.c40d30d   21h   updating
  10. Verifique se o cluster está atualizado.
    kubectl get tanzukubernetescluster
    NAME             CONTROL PLANE   WORKER   DISTRIBUTION                     AGE   PHASE
    tkgs-cluster-1   3               3        v1.18.5+vmware.1-tkg.1.c40d30d   22h   running