Documentação do Oracle Cloud Infrastructure

Fazendo Upgrade da Versão do Kubernetes em Nós de Plano de Controle de um Cluster

Descubra como fazer upgrade da versão do Kubernetes em execução nos nós de plano de controle dos clusters que você cria usando o Kubernetes Engine (OKE).

Quando o Kubernetes Engine suporta uma versão mais recente do Kubernetes do que a que está em execução no momento nos nós de plano de controle de um cluster, você pode fazer upgrade da versão do Kubernetes executada nos nós de plano de controle.

Para fazer upgrade da versão do Kubernetes em execução nos nós de plano de controle de um cluster, todos os nós de trabalho devem estar em um estado READY. Se o upgrade falhar, revise a solicitação de serviço CLUSTER_UPDATE com falha para obter mais informações. Consulte Exibindo Solicitações de Serviço.

Observe que quando você faz upgrade da versão do Kubernetes em execução nos nós de plano de controle, os nós virtuais em cada pool de nós virtuais no cluster também são automaticamente submetidos a upgrade para essa versão do Kubernetes. Para obter mais informações sobre upgrade de nó virtual, consulte Fazendo Upgrade de Nós Virtuais para uma Versão Mais Recente do Kubernetes.

Importante

Depois de fazer upgrade dos nós de plano de controle para uma versão mais recente do Kubernetes, você não poderá fazer downgrade dos nós de plano de controle para uma versão anterior do Kubernetes. Portanto, antes de fazer upgrade da versão do Kubernetes em execução nos nós do plano de controle, teste se os aplicativos implantados no cluster são compatíveis com a nova versão do Kubernetes.

    1. Na página de lista Clusters, localize o cluster cujo upgrade você deseja fazer na versão do Kubernetes em execução nos nós de plano de controle. Se precisar de ajuda para localizar a página de lista ou o cluster, consulte Listando Clusters.

      Em que o Kubernetes Engine suporta uma versão mais recente do Kubernetes que a versão em execução no momento nos nós de plano de controle de um cluster:

      • Um label Recomendado para upgrade aparecerá ao lado do cluster se a versão do Kubernetes em execução no momento no plano de controle não for a versão mais recente suportada pelo Kubernetes Engine, mas a versão ainda for suportada pelo Kubernetes Engine. Nesse caso, uma opção Upgrade disponível é mostrada no menu Ações (três pontos) na página de lista Clusters.
      • Um label Upgrade fortemente recomendado aparecerá ao lado do cluster se a versão do Kubernetes em execução no momento no plano de controle não for mais suportada pelo Kubernetes Engine. Nesse caso, uma opção Fazer Upgrade recomendado é mostrada no menu Ações (três pontos) na página de lista Clusters.

      Em ambos os casos, uma opção equivalente (Nova versão do Kubernetes disponível) também é mostrada no menu Ações na página de detalhes do cluster.

    2. Na página da lista Clusters, selecione Upgrade disponível ou Upgrade recomendado (conforme apropriado) no menu Ações (três pontos).
    3. Na opção Fazer Upgrade do plano de controle do cluster, selecione a versão do Kubernetes para a qual os nós do plano de controle serão submetidos a upgrade e selecione Fazer Upgrade.

    O upgrade da versão do Kubernetes em execução nos nós de plano de controle é feito. A nova versão do Kubernetes aparece como uma opção quando você está definindo novos pools de nós para o cluster.

  • Use o comando ce cluster update e os parâmetros necessários para fazer upgrade dos nós de plano de controle:

    oci ce cluster update --cluster-id <cluster-ocid> --kubernetes-version <kubernetes-version-number>  [OPTIONS]

    Por exemplo: 

    oci ce cluster update --cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd --kubernetes-version v1.24.1

    Para ver uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Comando CLI.

  • Execute a operação UpdateCluster para fazer upgrade da versão do Kubernetes executada nos nós de plano de controle.