Atualizar versões do sistema operacional (SO) no AKS

Este artigo descreve as versões do sistema operativo disponíveis para nós do Azure Kubernetes Service (AKS) e as melhores práticas para testar e atualizar a versão do seu sistema operativo.

Importante

A partir de 17 de março de 2027, Azure Kubernetes Service (AKS) já não suporta nem fornece atualizações de segurança para o Ubuntu 20.04. Quaisquer imagens de nós existentes serão apagadas e não conseguirás escalar pools de nós a correr Ubuntu 20.04. Migre para uma versão suportada do Ubuntu atualizando os seus pools de nós para a versão 1.35+ do Kubernetes. Para mais informações sobre esta descontinuação, consulte a questão Retirement no GitHub e o anúncio de descontinuação nas Atualizações do Azure. Para se manter informado sobre anúncios e atualizações, siga as Notas de Lançamento do AKS.

Importante

A partir de 30 de junho de 2027, Azure Kubernetes Service (AKS) já não suporta nem fornece atualizações de segurança para o Ubuntu 22.04. Para evitar interrupções, faça a transição para o Ubuntu 24.04 ou posterior até essa data. Entre agora e 30 de junho de 2027, pode continuar a usar o Ubuntu 22.04 no AKS sem interrupções. Se não migrar até 30 de junho de 2027, não poderá criar novos pools de nós, o AKS não produzirá novas imagens de nós e você deixará de receber patches de segurança para pools de nós existentes. Se quiser ativar suporte a longo prazo (LTS) com Kubernetes versão 1.33 ou posterior, atualize primeiro os seus pools de nós para Ubuntu 24.04. A 30 de abril de 2028, o AKS irá remover as imagens dos nós do Ubuntu 22.04 e o código existente, o que causará falhas nas operações de escalonamento e remediação. Para evitar interrupções do serviço como vulnerabilidades de segurança, falhas em atualizações de imagem de nós e falhas de escalabilidade, migre para o Ubuntu 24.04 ou posterior até 30 de junho de 2027. As suas opções de migração incluem:

  • SKU do Sistema Operativo Predefinido (OSSku): Se estiver a usar Ubuntu, migrará automaticamente para o Ubuntu 24.04 quando atualizar a sua versão Kubernetes para a 1.35 ou posterior.
  • OSSku versionado: Se estiveres a usar Ubuntu2204, atualiza o teu OSSku para Ubuntu Kubernetes 1.35 ou posterior, ou Ubuntu2404 para Kubernetes 1.32 ou posterior.

Para mais informações sobre esta reforma, consulte a issue Retirement GitHub e a postagem de Atualizações do Azure. Para se manter informado sobre anúncios e atualizações, siga as Notas de Lançamento do AKS.

Importante

A partir de 30 de novembro de 2025, Azure Kubernetes Service (AKS) já não suporta nem fornece atualizações de segurança para Azure Linux 2.0. A imagem Azure do nó Linux 2.0 está congelada na versão 202512.06.0. A partir de 31 de março de 2026, as imagens dos nós serão removidas e não poderá ajustar o tamanho dos seus pools de nós. Migre para uma versão Azure Linux suportada atualizando os seus pools de nós para uma versão Kubernetes suportada ou migrando para osSku AzureLinux3. Para mais informações, consulte a issue de reforma do GitHub e o anúncio de retirada das atualizações do Azure. Para se manter informado sobre anúncios e atualizações, siga as Notas de Lançamento do AKS.

Versões de SO suportadas

Cada imagem de nó corresponde a uma versão do sistema operativo, que você pode especificar usando a SKU do sistema operativo. Você pode especificar os seguintes parâmetros ao criar clusters e pools de nós:

  • --os-type: tipo de sistema operativo, incluindo Linux ou Windows. Não podes especificar o tipo de Windows sistema operativo durante a criação do cluster ou a atualização .
  • --os-sku: Usado para especificar a versão do sistema operacional ou a variante do sistema operacional. Não podes especificar o SKU do Windows OS durante a criação ou atualização do cluster. Para mais informações sobre as opções de SKUs de SO suportadas, veja Azure AKS CLI ou API.
  • --kubernetes-version: Versão do Kubernetes a ser usada para criar o pool ou cluster de nós.

Orientações sobre boas práticas

A versão padrão do sistema operacional é a versão validada mais recente.

  • Para o Ubuntu, recomendamos criar clusters e pools de nós ao especificar --os-type Linux e --os-sku Ubuntu. Isso irá atualizá-lo automaticamente para a versão padrão mais recente do Ubuntu com base na sua versão do Kubernetes.
  • Para Azure Linux, recomendamos criar clusters e pools de nós especificando --os-type Linux e --os-sku AzureLinux. Isto irá atualizá-lo automaticamente para a versão padrão mais recente do Azure Linux com base na sua versão do Kubernetes.
  • Para Windows, recomendamos criar pools de nós ao especificar --os-type Windows e --os-sku Windows2022. Você precisa atualizar manualmente os pools de nós para a próxima versão do sistema operacional quando ela for lançada.
Tipo de SO OS Código de Armazenamento (SKU) Versões do Kubernetes suportadas Versionamento padrão
Linux Ubuntu Este OS SKU é suportado em todas as versões do Kubernetes. A versão do SO para este OS SKU muda com base na sua versão do Kubernetes. Ubuntu 22.04 é o padrão para as versões Kubernetes 1.25 a 1.34. O Ubuntu 24.04 é o padrão para as versões 1.35+ do Kubernetes.
Linux Ubuntu2404 Este SKU do SO só será suportado no Kubernetes 1.32 a 1.38. Recomendamos este SKU de sistema operativo versionado se quiser migrar para a nova versão do sistema operativo sem atualizar a sua versão do Kubernetes. O Ubuntu 24.04 é o padrão quando se usa --os-sku Ubuntu em versões 1.35+ do Kubernetes.
Linux Ubuntu2204 Este SKU do sistema operativo é suportado nas versões Kubernetes 1.25 a 1.36. Recomendamos este SKU de sistema operativo versionado se precisares de voltar ao Ubuntu 22.04. Ubuntu 22.04 é o padrão ao usar --os-sku Ubuntu nas versões 1.25 a 1.35 do Kubernetes.
Linux AzureLinux Este OS SKU é suportado em todas as versões do Kubernetes. A versão do SO para este OS SKU muda com base na sua versão do Kubernetes. O Azure Linux 2.0 é o padrão para Kubernetes versões 1.27 a 1.31. O Azure Linux 3.0 é o padrão para a versão 1.32+ do Kubernetes. Quando o sinalizador de recurso AzureLinuxV3Preview está ativado no AKS 1.31, --os-sku AzureLinux o padrão é 3.0.
Linux AzureLinux3 Este OS SKU é compatível com o Kubernetes 1.28 a 1.36. Recomendamos este OS SKU se você quiser testar a nova versão do sistema operacional sem atualizar sua versão do Kubernetes. Também pode usar este SKU do sistema operativo para migrar do Azure Linux 2.0 para o Azure Linux 3.0.
Linux AzureLinuxOSGuard Este OS SKU é suportado nas versões 1.32 e superiores do Kubernetes. Azure Linux com versões OS Guard são atualizadas por meio de upgrades de imagem de nós. Para mais informações, consulte Azure Linux com OS Guard para AKS.
Linux Carro plano Este OS SKU é suportado em todas as versões do Kubernetes. As versões do Flatcar são atualizadas por meio de atualizações da imagem do nó. Para obter mais informações, consulte Flatcar Container Linux for AKS.
Windows Windows2019 1.14 a 1.32 Tipo predefinido para o sistema operativo Windows nas versões 1.14 a 1.24 do Kubernetes.
Windows Windows2022 1.23 a 1.34 Tipo predefinido para o sistema operativo Windows nas versões do Kubernetes de 1.25 a 1.34.

Migrar para uma nova versão do SO

Quando uma nova versão do sistema operativo é lançada no AKS, é inicialmente suportada em pré-visualização. Após alguns meses de testes em pré-visualização, o AKS disponibiliza a nova versão do sistema operativo de forma geral (GA) e depois atualiza o SKU padrão do SO (Ubuntu ou AzureLinux) para a versão mais recente do GA. Esta atualização por defeito ocorre com o lançamento de uma nova versão do Kubernetes.

Recomendamos testar as suas cargas de trabalho não produtivas com a nova versão do sistema operativo quando esta estiver disponível na pré-visualização. Para aceder às funções de pré-visualização, certifique-se de que tem a extensão de pré-visualização instalada. Você pode instalar a extensão usando o az extension add --name aks-preview comando.

Existem duas formas de migrar para uma nova versão do sistema operativo:

  • SKU do sistema operativo predefinido: Se estiver a usar um SKU do sistema operativo, como Ubuntu ou AzureLinux, obtém automaticamente a versão mais recente do GA ao atualizar a sua versão do Kubernetes. Não são necessárias alterações manuais para migrar para uma nova versão do sistema operativo. Clusters e pools de nós que usam o Ubuntu SKU do SO migram automaticamente para o Ubuntu 24.04 ao atualizar a versão do Kubernetes para a 1.35 ou superior.
  • SKU de SO versionado: Se estiver a usar um SKU de SO versionado como Ubuntu2404, AzureLinux3, ou Windows2025, precisa de migrar manualmente para uma nova versão do sistema operativo para evitar atualizações bloqueadas do Kubernetes. Se estiver a usar um sistema operativo Linux, pode atualizar o SKU do sistema operativo num pool de nós existente para migrar manualmente.

Atualizar o SKU do sistema operacional em um pool de nós existente

Atualize o os-sku em um pool de nós existente usando o az aks nodepool update comando. Nos casos em que há uma nova versão do sistema operacional disponível na visualização, essa funcionalidade permite que você migre seu pool de nós para a nova versão do sistema operacional sem precisar atualizar sua versão do Kubernetes.

Observação

Os seguintes valores não são suportados para o comando de atualização do pool de nós:

  • --os-sku Windows2019
  • --os-sku Windows2022
  • --os-sku Windows2025

Em vez disso, você precisa adicionar pools de nós ao cluster com o correspondente --os-sku que você pretende usar.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku Ubuntu \
    --name $NODE_POOL_NAME \
    --node-count 1

Você pode usar o az aks nodepool update comando para migrar entre qualquer Linux os-skusuportado. O comando pode falhar se o SO de destino não tiver uma imagem de nó compatível para a sua versão do Kubernetes, tamanho da VM ou compatibilidade FIPS.

Migrar para o Ubuntu 24.04

O Ubuntu 24.04 é o padrão nas --os-sku Ubuntu versões Kubernetes 1.35+. Também pode usar o Ubuntu 24.04 especificando --os-sku Ubuntu2404.

Observação

Tenha em mente as seguintes informações ao migrar para --os-sku Ubuntu2404:

  • FIPS não é suportado.
  • O Ubuntu 24.04 é suportado nas versões Kubernetes 1.32 a 1.38.
  • As imagens de nós do Ubuntu 24.04 no AKS usam o containerd 2.0 por defeito. Cargas de trabalho que dependam do comportamento de runtime do contentor devem ser validadas com o containerd 2.0 ao migrar para o Ubuntu 24.04.
  • Você precisa atualizar seu SKU do sistema operacional para uma opção de sistema operacional suportada antes de atualizar sua versão do Kubernetes para 1.39+. --os-sku Ubuntu2404 é uma opção e destina-se a testar a nova versão do sistema operacional Linux sem exigir que você atualize sua versão do Kubernetes.
  • Precisas da pré-visualização CLI do Azure versão 18.0.0b5 ou posterior para prévia e da versão 2.82.0 para GA instalada e configurada. Para encontrar a versão da CLI, execute az --version. Se precisares de instalar ou atualizar, vê Install CLI do Azure.

Atualize para --os-sku Ubuntu2404 num grupo de nós existente usando o comando az aks nodepool update.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku Ubuntu2404 \
    --kubernetes-version 1.32.0 \
    --name $NODE_POOL_NAME \
    --node-count 1

Migrar para Azure Linux 3.0

Azure Linux 3.0 é o padrão para --os-sku AzureLinux nas versões Kubernetes 1.32 a 1.36. Também pode usar Azure Linux 3.0 especificando --os-sku AzureLinux3.

Observação

Tenha em mente as seguintes informações ao migrar para --os-sku AzureLinux3:

  • --os-sku AzureLinux3 é suportado nas versões 1.28 a 1.36 do Kubernetes.
  • --os-sku AzureLinux3 destina-se a migrar para Azure Linux 3.0 sem atualizar a versão do Kubernetes. Você precisa atualizar seu SKU do sistema operacional para uma opção de sistema operacional suportada antes de atualizar sua versão do Kubernetes para 1.37+.
  • Precisa da versão CLI do Azure 18.0.0b36 ou posterior para prévia e da versão 2.78.0 ou posterior para GA instalada e configurada. Para encontrar a versão da CLI, execute az --version. Se precisares de instalar ou atualizar, vê Install CLI do Azure.

Atualize para --os-sku AzureLinux3 num grupo de nós existente usando o comando az aks nodepool update.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku AzureLinux3 \
    --kubernetes-version 1.30.0 \
    --name $NODE_POOL_NAME \
    --node-count 1

Reverter a versão do sistema operativo

Nas versões do Kubernetes em que várias versões do sistema operacional são suportadas, você pode usar o comando para reverter para uma versão anterior do az aks nodepool update sistema operacional.

Talvez você queira reverter a versão do sistema operacional nos seguintes cenários:

  • Se estiver a testar uma nova versão do SO e tiver problemas.
  • Depois de atualizar para uma versão do Kubernetes que suporte a nova versão do sistema operativo como padrão, poderá querer reverter para o SKU de sistema operativo padrão Ubuntu ou AzureLinux. Isso permite que você obtenha versões futuras do sistema operacional como parte de suas atualizações do Kubernetes, em vez de exigir uma atualização do pool de nós.

Restaurar a versão do sistema operativo para o SKU predefinido do sistema operativo

Você pode usar o comando az aks nodepool update para atualizar o os-sku em um pool de nós existente. Nos casos em que há uma versão anterior do sistema operacional suportada na versão do Kubernetes, essa funcionalidade pode permitir que você reverta a versão do sistema operacional.

Observação

Os seguintes valores não são suportados para o comando de atualização do pool de nós:

  • --os-sku Windows2019
  • --os-sku Windows2022
  • --os-sku Windows2025

Em vez disso, você precisa adicionar pools de nós ao cluster com o correspondente --os-sku que você pretende usar.

OS Código de Armazenamento (SKU) Versão padrão do sistema operacional
Ubuntu Quando você tem OS SKU Ubuntu, Ubuntu 22.04 é a versão padrão do sistema operacional se sua versão do Kubernetes é 1.25 a 1.34. Ubuntu 24.04 é o padrão para o Ubuntu no Kubernetes 1.35 a 1.37.
AzureLinux Quando tens o SKU do SO AzureLinux, Azure Linux 2.0 é o padrão para AzureLinux no Kubernetes 1.26 a 1.31. Azure Linux 3.0 é o padrão para AzureLinux no Kubernetes 1.32 a 1.36.

Atualize o SKU do seu sistema operacional para o Ubuntu em um pool de nós existente

Ao atualizar seu pool de nós para usar o OS SKU Ubuntu, você obterá a versão padrão do sistema operacional com base na sua versão do Kubernetes. Isso pode acionar uma nova imagem automática se a versão do sistema operacional for alterada durante o comando de atualização do pool de nós.

Atualize para --os-sku Ubuntuem um pool de nós existente usando o az aks nodepool update comando.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku Ubuntu \
    --name $NODE_POOL_NAME \
    --node-count 1

Você pode usar o az aks nodepool update comando para migrar entre qualquer Linux os-skusuportado. O comando pode falhar se o SO de destino não tiver uma imagem de nó compatível para a sua versão do Kubernetes, tamanho da VM ou compatibilidade FIPS.

Atualize o SKU do seu sistema operativo para Azure Linux num pool de nós existente

Ao atualizar seu pool de nós para usar o OS SKU AzureLinux, você obterá a versão padrão do sistema operacional com base na sua versão do Kubernetes. Isso pode acionar uma nova imagem automática se a versão do sistema operacional for alterada durante o comando de atualização do pool de nós.

Atualize para --os-sku AzureLinux num grupo de nós existente usando o comando az aks nodepool update.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku AzureLinux \
    --name $NODE_POOL_NAME \
    --node-count 1

Reverter para o Ubuntu 22.04

Observação

Tenha em mente as seguintes informações ao migrar para --os-sku Ubuntu2204:

  • FIPS e CVM não são suportados.
  • O Ubuntu 22.04 é suportado nas versões 1.25 a 1.36 do Kubernetes.
  • --os-sku Ubuntu2204 destina-se a reverter para o Ubuntu 22.04 na sua versão atual do Kubernetes. Precisas de atualizar o SKU do teu sistema operativo para uma opção de SO suportada para atualizar a versão Kubernetes para a 1.37 e superior.

Reverter para --os-sku Ubuntu2204 no pool de nós existente usando o comando az aks nodepool update.

az aks nodepool update \
    --resource-group $RESOURCE_GROUP \
    --cluster-name $CLUSTER_NAME \
    --os-sku Ubuntu2204 \
    --kubernetes-version 1.32.0 \
    --name $NODE_POOL_NAME \
    --node-count 1

Próximos passos

Para saber mais sobre imagens de nós, atualizações de conjuntos de nós e configurações de nós no AKS, consulte os seguintes recursos: