Atualizar um cluster do Azure Kubernetes Service (AKS)

Aplica-se a: AKS em Azure Local

Como parte do gerenciamento do ciclo de vida do aplicativo e do cluster, convém atualizar para a versão mais recente disponível do Kubernetes. Uma atualização envolve uma mudança para uma versão mais recente do Kubernetes, a aplicação de atualizações de versão do sistema operacional (SO) (patching) ou ambas. O AKS suporta a atualização (ou aplicação de patches) de nós num cluster de cargas de trabalho com as atualizações mais recentes do sistema operativo e do runtime.

Todas as atualizações são executadas de forma contínua e contínua para garantir a disponibilidade ininterrupta das cargas de trabalho. Quando um novo nó de trabalho do Kubernetes com uma compilação mais recente ingressa no cluster, o processo move recursos do nó antigo para o novo nó. Depois que essa etapa for concluída com êxito, o processo será descomissionado e removerá o nó antigo do cluster.

Antes de começares

Se estiver a usar a CLI do Azure, este artigo requer a versão 2.34.1 ou posterior da CLI do Azure. Executar az --version para localizar a versão. Se você precisar instalar ou atualizar a CLI, consulte Instalar a CLI do Azure.

Verifique se há atualizações disponíveis

Verifique quais versões do Kubernetes estão disponíveis para seu cluster usando o seguinte comando:

az aksarc get-upgrades --resource-group myResourceGroup --name myAKSCluster

O exemplo de saída a seguir mostra a versão atual como 1.24.11 e lista as versões disponíveis em upgrades:

{  
  "agentPoolProfiles": [  
    {  
      "kubernetesVersion": "1.24.11",  
      "upgrades": [  
        {  
          "kubernetesVersion": "1.25.7"  
        }  
      ]  
    }  
  ],  
  "controlPlaneProfile": {  
    "kubernetesVersion": "1.24.11",  
    "name": "aksarc-testupgrade",  
    "osType": "Linux",  
    "upgrades": [  
      {  
        "kubernetesVersion": "1.25.7"  
      }  
    ]  
  },  
  ...  
  "provisioningState": "Succeeded",  
  ...  
}

Atualizar a versão do Kubernetes

Ao atualizar um cluster AKS suportado, você não pode ignorar as versões secundárias do Kubernetes. Você deve executar todas as atualizações sequencialmente pelo número da versão principal. Por exemplo, você pode atualizar de 1.24.x para 1.25.x ou de 1.25.x para 1.26.x. Não é possível atualizar de 1.24.x para 1.26.x.

Note

Se não especificares uma versão de patch, o cluster será automaticamente atualizado para o patch GA mais recente da versão secundária especificada. Por exemplo, a configuração --kubernetes-version como 1.25 atualiza o cluster para 1.25.7.

Use o seguinte comando para atualizar seu cluster:

az aksarc upgrade \
  --resource-group myResourceGroup \
  --name myAKSCluster \
  --kubernetes-version <KUBERNETES_VERSION>

Use o show comando para confirmar que a atualização foi bem-sucedida:

az aksarc show --resource-group myResourceGroup --name myAKSCluster

A saída de exemplo a seguir mostra que o cluster agora executa 1.25.7:

{  
"extendedLocation": {  
  "name":
"/subscriptions/<subscription>/resourcegroups/<resource group>/providers/microsoft.extendedlocation/customlocations/<custom
location>",  
  "type": "CustomLocation"  
},  
"id": "/subscriptions/<subscription>/resourceGroups/<resource group>/providers/Microsoft.Kubernetes/connectedClusters/aksarc-testupgrade/providers/Microsoft.HybridContainerService/provisionedClusterInstances/default",  
"name": "default",  
"properties": {  
  "agentPoolProfiles": [  
    {  
    }  
  ],  
  "controlPlane": {  
    "availabilityZones": null,  
    "controlPlaneEndpoint": {  
      "hostIp": null,  
      "port": null  
    },  
    "count": 1,  
    "linuxProfile": {  
      "ssh": {  
        "publicKeys": null  
      }  
    },  
    "name": null,  
    "nodeImageVersion": null,  
    "osSku": "CBLMariner",  
    "osType": "Linux",  
    "vmSize": "Standard_A4_v2"  
  },  
  "kubernetesVersion": "1.25.7",  
...  
  "provisioningState": "Succeeded",  
  ...  
},  
....  
"type": "microsoft.hybridcontainerservice/provisionedclusterinstances"  
}

Importante

Se você atualizar de uma versão sem suporte que ignora duas ou mais versões secundárias, a atualização pode não funcionar corretamente. Se a sua versão estiver significativamente desatualizada, recomendamos que você recrie o cluster.

Durante uma operação de atualização, os provisioningState indicadores e currentState exibem uma mensagem de atualização para refletir o processo em andamento. No entanto, se a operação expirar, provisioningState mostrará Falha, enquanto currentState continua a mostrar Atualizando à medida que a atualização continua em segundo plano. Nenhuma ação é necessária; A atualização continua até ser concluída.

Atualizar a versão do sistema operacional (SO)

Você pode atualizar os nós de trabalho para uma versão mais recente da imagem do nó sem alterar a versão do Kubernetes somente se a nova imagem não exigir uma versão diferente do Kubernetes. Atualmente, o AKS não suporta atualizações apenas com imagem de nós em todas as versões suportadas do Kubernetes. Se precisar atualizar a imagem do nó, atualize o cluster para a versão mais recente do Kubernetes para garantir que todas as atualizações de imagem do nó sejam incorporadas.

Importante

Se você tentar usar o node-image-only sinalizador, receberá uma mensagem indicando que esse recurso ainda não é suportado.

Passos seguintes