Atualize sua versão do cluster do Azure

Esta página explica como atualizar a versão do Kubernetes dos seus clusters do GKE no Azure.

Pré-requisitos

Atualizar a versão do Kubernetes do seu cluster é um caso específico da operação de atualização de cluster mais geral. Você pode ler sobre as operações de atualização de cluster em geral na página "Atualize seu cluster" . Para atualizar a versão do seu cluster:

  • Você deve atualizar todas as versões secundárias entre a versão atual e a de destino. Por exemplo, para atualizar da versão 1.20 para a 1.22, você deve primeiro atualizar da 1.20 para a 1.21 e, em seguida, atualizar da 1.21 para a 1.22.
  • Você deve ter a permissão gkemulticloud.googleapis.com/azureClusters.update Gerenciamento de Identidade e Acesso.

Como o GKE no Azure realiza atualizações

Como a atualização de um cluster exige a reinicialização dos nós do plano de controle, o GKE no Azure executa uma "atualização contínua" com as seguintes etapas:

  1. Selecione uma instância do plano de controle para atualizar. O GKE no Azure atualiza instâncias com problemas de integridade, se houver, antes das íntegras.
  2. Exclua a instância. O GKE no Azure recria a instância e ela é inicializada com a nova configuração.
  3. Execute verificações de integridade na nova instância.
  4. Se as verificações de integridade forem bem-sucedidas, selecione outra instância e execute as mesmas etapas nela. Repita esse ciclo até que todas as instâncias sejam reiniciadas ou recriadas. Se a verificação de integridade falhar, o GKE no Azure colocará o cluster em um estado DEGRADED e interromperá a atualização. Para obter mais informações, consulte a seção a seguir.

Quando uma atualização falha

Após uma atualização, o GKE no Azure executa uma verificação de integridade no cluster. Se a verificação de integridade falhar, o cluster será marcado como DEGRADED . Você pode exibir o status do seu cluster com o seguinte comando da Google Cloud CLI:

gcloud container azure clusters describe CLUSTER_NAME \
  --location=GOOGLE_CLOUD_LOCATION

Substitua o seguinte:

  • CLUSTER_NAME : o nome do seu cluster
  • GOOGLE_CLOUD_LOCATION : o Google Cloud região que gerencia seu cluster

Executar a atualização

Verifique a versão do seu cluster

Antes de atualizar a versão do seu cluster, use o seguinte comando para verificar quais versões estão disponíveis na sua região:

gcloud container azure get-server-config \
    --location=GOOGLE_CLOUD_LOCATION

Substitua GOOGLE_CLOUD_LOCATION por Google Cloudlocal de onde você gerencia seus clusters.

Escolha um método de atualização

Você pode atualizar a versão do seu cluster por meio do Google Cloud console, a Google Cloud CLI ou a API Multi-Cloud do GKE. Se quiser usar o console para atualizar um cluster, primeiro você precisa escolher e configurar um método de autenticação para fazer login no cluster. Para obter mais informações, consulte Conectar e autenticar no seu cluster .

Console

  1. No Google Cloud console, acesse a página de visão geral dos clusters do Google Kubernetes Engine .

    Ir para clusters do GKE

  2. Selecione o Google Cloud projeto em que o cluster está.

  3. Na lista de clusters, selecione o nome do cluster e, em seguida, selecione Exibir detalhes no painel lateral.

  4. Na guia Detalhes , selecione atualização .

  5. Na caixa de diálogo "Atualizar a versão do Kubernetes para o cluster" , selecione a versão para a qual deseja atualizar e clique em Concluído . Observe que você deve atualizar todas as versões secundárias ao atualizar seu cluster.

gcloud

Para atualizar a versão do Kubernetes do seu cluster, execute o seguinte comando:

gcloud container azure clusters update CLUSTER_NAME \
    --location=GOOGLE_CLOUD_LOCATION \
    --cluster-version=CLUSTER_VERSION

Substitua o seguinte:

API

Para atualizar seu cluster por meio da API, use uma operação PATCH na API Multi-Cloud do GKE.

  1. Crie um arquivo JSON chamado cluster_update.json com o seguinte conteúdo:

    {
    "controlPlane": {
       "version": "CLUSTER_VERSION",
    },
}

    Substitua o seguinte:

  2. Atualize essas configurações por meio da API GKE Multi-Cloud com o seguinte comando.

    curl -d @cluster_update.json -X PATCH \
   ENDPOINT/projects/PROJECT_ID/locations/GOOGLE_CLOUD_LOCATION/azureClusters/CLUSTER_ID?update_mask=controlPlane.Version

Substitua o seguinte:

Para obter mais informações, consulte a documentação do método projects.locations.azureClusters.patch .

Atualize seus pools de nós

Após atualizar a versão do seu cluster, atualize os pools de nós para concluir o processo. Para saber como, consulte Atualizar um pool de nós .

O que vem a seguir