Corrigir e atualizar um cluster AKS

  • 30 minutos

No exercício a seguir, você implanta um cluster AKS para representar o cluster AKS que a equipe de implantação do Nod Publishers configurou anteriormente. Em seguida, você aplica atualizações de patch e atualiza o cluster AKS para a versão mais recente suportada do Kubernetes.

Diagrama mostrando o processo de laboratório: aplicando atualizações de patch para a versão fora de suporte antes de atualizar para a versão suportada mais recente.

Nota

Este exercício é opcional. Se quiser concluir este exercício, terá de criar uma subscrição do Azure antes de começar. Se você não tiver uma conta do Azure ou não quiser criar uma no momento, leia as instruções para entender as informações que estão sendo apresentadas.

Criar um cluster do AKS

  1. No Azure Cloud Shell, crie um grupo de recursos usando o az group create comando.

    az group create -l westus -n myResourceGroup

  2. Verifique a lista atual de versões do Kubernetes que o AKS suporta usando o az aks get-versions comando.

    az aks get-versions -l westus -o table

    Você deve obter uma lista semelhante à abaixo:

    Captura de tela que mostra a lista de versões atuais do Kubernetes suportadas pelo Serviço Kubernetes do Azure.

  3. Encontre a versão mais antiga suportada do Kubernetes na lista e armazene-a dentro de uma variável chamada KV.

    KV=1.24.9

    Captura de tela que mostra a lista de versões atuais do Kubernetes suportadas pelo Serviço Kubernetes do Azure com a versão mais antiga com suporte descrita em uma caixa vermelha.

  4. Obtenha o nome do grupo de recursos e armazene dentro de uma variável chamada RG.

    az group list -o table 
RG=myResourceGroup

    Uma captura de tela que mostra a saída esperada do comando deve mostrar o nome, o local e o status do grupo de recursos usado no laboratório.

  5. Crie um cluster AKS usando o az aks create comando.

    CLUSTERNAME=myAKSCluster
az aks create -n $CLUSTERNAME -g $RG --kubernetes-version $KV --generate-ssh-keys

Atualizar o cluster AKS

  1. Verifique se há atualizações de cluster disponíveis usando o az aks get-upgrades comando.

    az aks get-upgrades -n $CLUSTERNAME -g $RG -o table

    Você verá que as versões disponíveis para atualizações são as próximas três versões suportadas do Kubernetes da versão atual do cluster AKS.

    Por exemplo:

    A captura de tela que mostra a saída esperada do comando deve mostrar a lista de versões atual do Kubernetes suportada pelo Serviço Kubernetes do Azure com as versões n-1 e n-2 descritas em uma caixa vermelha.

  2. Tente atualizar imediatamente para a versão mais recente suportada do Kubernetes usando o az aks upgrade comando e substitua [latest-version] pela versão mais recente do Kubernetes da etapa anterior.

    az aks upgrade -n $CLUSTERNAME -g $RG -k [latest-version]

    Você deve receber uma mensagem de erro semelhante à abaixo:

    Operation failed with status: 'Bad Request'. Details: Upgrading Kubernetes version 1.18.17 to 1.21.1 is not allowed. Available upgrades: 1.18.19,1.19.9,1.19.11. Please see https://aka.ms/aks-supported-k8s-ver for version details.

    Você não pode pular versões secundárias ao atualizar seu cluster AKS. Isso significa que, se você estiver executando a versão 1.24.x, não poderá atualizar imediatamente para a versão 1.26.x e superior. No entanto, você pode ignorar atualizações de versão de patch em uma versão secundária.

Aplicar atualizações de patches

  1. Aplique atualizações de patch ao cluster AKS usando o az aks upgrade comando e substitua [next-patch-version] pela próxima versão de patch da seção anterior.

    az aks upgrade -n $CLUSTERNAME -g $RG --no-wait -k [next-patch-version]

    Nota

    É possível aplicar atualizações apenas ao plano de controle no cluster AKS ou apenas aos nós no cluster AKS incluindo os parâmetros --control-plane-only opcionais ou --node-image-only ao executar o comando upgrade. Se os parâmetros opcionais não estiverem incluídos, o plano de controle e os nós no cluster AKS serão atualizados.

  2. Confirme a atualização do patch usando o az aks show comando.

    az aks show -n $CLUSTERNAME -g $RG -o table

Atualize para a próxima versão secundária

  1. Atualize o cluster AKS para a próxima versão secundária do Kubernetes suportada usando o az aks upgrade comando e substitua [next-minor-version] pela próxima versão secundária da seção anterior.

    az aks upgrade -n $CLUSTERNAME -g $RG --no-wait -k [next-minor-version]

  2. Confirme a atualização usando o az aks show comando.

    az aks show -n $CLUSTERNAME -g $RG -o table

  3. Atualize o cluster para a versão estável mais recente do Kubernetes que o AKS suporta usando o az aks upgrade comando e substitua [latest-stable-version] pela versão estável mais recente da seção anterior.

    az aks upgrade -n $CLUSTERNAME -g $RG --no-wait -k [latest-stable-version]

  4. Confirme a atualização usando o az aks show comando.

    az aks show -n $CLUSTERNAME -g $RG -o table

Limpar os recursos

Neste módulo, criou recursos através da sua subscrição do Azure. As etapas a seguir mostram como limpar esses recursos para que você não incorra em custos do Azure depois de concluir este módulo.

  1. Navegue para o portal do Azure.
  2. Selecione Grupos>de recursos myResourceGroup.
  3. Selecione Excluir grupo de recursos e insira o nome do grupo de recursos a confirmar.
  4. Selecione Excluir>excluir.