Compartilhar via

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

Este artigo descreve as versões de SO disponíveis para os nós do Serviço de Kubernetes do Azure (AKS) e as práticas recomendadas para testar e atualizar sua versão de SO.

Importante

A partir do March 17, 2027, AKS (Serviço de Kubernetes do Azure) não dá mais suporte ou fornece atualizações de segurança para o Ubuntu 20.04. Todas as imagens de nós existentes serão excluídas e você não poderá dimensionar quaisquer pools de nós que estejam executando o Ubuntu 20.04. Migre para uma versão do Ubuntu com suporte atualizando seus grupos de nós para a versão 1.35+ do Kubernetes. Para obter mais informações sobre essa desativação, consulte o issue do GitHub e o comunicado de desativação das Atualizações do Azure. Para se manter informado sobre anúncios e atualizações, acompanhe as notas de versão do AKS.

Importante

A partir do June 30, 2027, AKS (Serviço de Kubernetes do Azure) não dá mais suporte ou 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, você pode continuar a usar o Ubuntu 22.04 no AKS sem interrupções. Se você não migrar até 30 de junho de 2027, não será possível criar novos pools de nós, o AKS não gerará novas imagens de nó e você deixará de receber patches de segurança para os pools de nós existentes. Se você quiser habilitar o LTS (suporte a longo prazo) com o Kubernetes versão 1.33 ou posterior, primeiro atualize os pools de nós para o Ubuntu 24.04. Em 30 de abril de 2028, o AKS removerá as imagens de nós Ubuntu 22.04 e o código existente, causando falha nas operações de dimensionamento e correção. Para evitar interrupções de serviço, como vulnerabilidades de segurança, falhas ao atualizar imagens de nós e falhas de dimensionamento, migre para o Ubuntu 24.04 ou posterior até 30 de junho de 2027. As opções de migração incluem:

  • SKU do Sistema Operacional Padrão (OSSku): se você estiver usando Ubuntu, você migrará automaticamente para o Ubuntu 24.04 ao atualizar sua versão do Kubernetes para 1.35 ou posterior.
  • OSSku versionado: se você estiver usando Ubuntu2204, atualize seu OSSku para Ubuntu no Kubernetes 1.35 ou posterior ou para Ubuntu2404 no Kubernetes 1.32 ou posterior.

Para obter mais informações sobre essa desativação, consulte o Problema de desativação do GitHub e a publicação das Atualizações do Azure. Para se manter informado sobre anúncios e atualizações, acompanhe as notas de versão do AKS.

Importante

A partir de 30 de novembro de 2025, AKS (Serviço de Kubernetes do Azure) não dá mais suporte ou fornece atualizações de segurança para Azure Linux 2.0. A imagem do nó Azure 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 você não poderá dimensionar os pools de nós. Migre para uma versão do Linux Azure com suporte atualizando seus pools de nós para uma versão do Kubernetes com suporte ou migrando para osSku AzureLinux3. Para obter mais informações, consulte Problema de desativação do GitHub e o comunicado de desativação das Atualizações do Azure. Para se manter informado sobre anúncios e atualizações, acompanhe as notas de versão do AKS.

Versões do sistema operacional com suporte

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

  • --os-type: tipo de sistema operacional, incluindo Linux ou Windows. Não é possível especificar o tipo de sistema operacional Windows durante a criação ou atualização do cluster.
  • --os-sku: usado para especificar a versão do sistema operacional ou a variante do sistema operacional. Não é possível especificar a SKU do sistema operacional Windows durante a criação ou atualização do cluster. Para obter mais informações sobre as opções de SKU do sistema operacional com suporte, consulte Azure CLI do AKS ou API.
  • --kubernetes-version: versão do Kubernetes a ser usada para criar o pool de nós ou cluster.

Orientação de melhor prática

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 especificando --os-type Linux e --os-sku Ubuntu. Isso atualizará você 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 ao especificar --os-type Linux e --os-sku AzureLinux. Isso atualizará você automaticamente para a versão mais recente padrão 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 ele for lançado.
Tipo do SO SKU do SO Versões compatíveis do Kubernetes Versionamento padrão
Linux Ubuntu Esse SKU do sistema operacional tem suporte em todas as versões do Kubernetes. A versão do sistema operacional para esse SKU do sistema operacional é alterada com base na versão do Kubernetes. O Ubuntu 22.04 é o padrão para as versões do Kubernetes 1.25 a 1.34. O Ubuntu 24.04 é o padrão para versões do Kubernetes 1.35+.
Linux Ubuntu2404 Esse SKU do sistema operacional só terá suporte no Kubernetes 1.32 a 1.38. Recomendamos essa SKU de sistema operacional versionada se você deseja migrar para a nova versão do sistema operacional sem atualizar a sua versão do Kubernetes. Ubuntu 24.04 é padrão ao usar --os-sku Ubuntu nas versões 1.35+ do Kubernetes.
Linux Ubuntu2204 Esse SKU do sistema operacional tem suporte nas versões do Kubernetes 1.25 a 1.36. Recomendamos essa SKU versionada do sistema operacional no caso de precisar reverter para o Ubuntu 22.04. O Ubuntu 22.04 é padrão ao usar --os-sku Ubuntu nas versões 1.25 a 1.35 do Kubernetes.
Linux AzureLinux Esse SKU do sistema operacional tem suporte em todas as versões do Kubernetes. A versão do sistema operacional para esse SKU do sistema operacional é alterada com base na versão do Kubernetes. Azure Linux 2.0 é padrão para o Kubernetes versão 1.27 a 1.31. Azure Linux 3.0 é padrão para o Kubernetes versão 1.32+. Quando o sinalizador de recurso AzureLinuxV3Preview está habilitado no AKS 1.31, --os-sku AzureLinux é definido como 3.0.
Linux AzureLinux3 Esse SKU do sistema operacional tem suporte no Kubernetes 1.28 a 1.36. Recomendamos esse SKU do sistema operacional se você quiser testar a nova versão do sistema operacional sem atualizar sua versão do Kubernetes. Você também pode usar esse SKU do sistema operacional para migrar do Azure Linux 2.0 para Azure Linux 3.0.
Linux AzureLinuxOSGuard Esse SKU do sistema operacional tem suporte nas versões do Kubernetes 1.32 e superiores. As versões do Azure Linux com proteção de SO são atualizadas através de atualizações da imagem do nó. Para obter mais informações, consulte Azure Linux com o OS Guard para AKS.
Linux Flatcar Esse SKU do sistema operacional tem suporte em todas as versões do Kubernetes. As versões Flatcar são atualizadas através de upgrades de imagem de nó. Para obter mais informações, consulte Flatcar Container Linux para AKS.
Windows Windows2019 1.14 a 1.32 Padrão para o tipo de sistema operacional Windows nas versões do Kubernetes de 1.14 a 1.24.
Windows Windows 2022 1.23 a 1.34 Padrão para o tipo de sistema operacional Windows nas versões 1.25 a 1.34 do Kubernetes.

Migrar para uma nova versão do sistema operacional

Quando uma nova versão do sistema operacional é lançada no AKS, inicialmente há suporte na versão prévia. Depois de testar em versão prévia por alguns meses, o AKS disponibiliza a nova versão do sistema operacional em geral (GA) e atualiza o SKU do sistema operacional padrão (Ubuntu ou AzureLinux) para a versão mais recente do sistema operacional GA. Essa atualização padrão ocorre com uma nova versão do Kubernetes.

Recomendamos testar suas cargas de trabalho de não produção com a nova versão do sistema operacional quando ela estiver disponível na versão prévia. Para acessar funções de visualização, verifique se você tem a extensão de visualização instalada. Você pode instalar a extensão usando o az extension add --name aks-preview comando.

Há duas maneiras de migrar para uma nova versão do sistema operacional:

  • SKU do sistema operacional padrão: se você estiver usando um SKU do sistema operacional padrão, como Ubuntu ou AzureLinux, você obterá automaticamente a versão mais recente do GA ao atualizar sua versão do Kubernetes. Não há nenhuma alteração manual necessária para migrar para uma nova versão do sistema operacional. Clusters e pools de nós que usam o SKU do Ubuntu sistema operacional migram automaticamente para o Ubuntu 24.04 ao atualizar a versão do Kubernetes para 1.35 ou superior.
  • SKU do sistema operacional versionado: se você estiver usando um SKU do sistema operacional versionado, como Ubuntu2404, AzureLinux3, ou Windows2025, você precisará migrar manualmente para uma nova versão do sistema operacional para evitar atualizações bloqueadas do Kubernetes. Caso você esteja usando um sistema operacional Linux, poderá atualizar o SKU do sistema operacional em um pool de nós existente a fim de 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 comando az aks nodepool update. Nos casos em que há uma nova versão do sistema operacional disponível na versão prévia, essa funcionalidade permite migrar seu pool de nós para a nova versão do sistema operacional sem a necessidade de atualizar sua versão do Kubernetes.

Observação

Os valores a seguir não têm suporte 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 a respectiva --os-sku que 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-skucom suporte. O comando poderá falhar se o sistema operacional de destino não tiver uma imagem do nó com suporte para a versão do Kubernetes, o tamanho da VM ou a habilitação FIPS.

Migrar para o Ubuntu 24.04

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

Observação

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

  • Não há suporte para FIPS.
  • O Ubuntu 24.04 tem suporte nas versões do Kubernetes 1.32 a 1.38.
  • As imagens de nó do Ubuntu 24.04 no AKS usam o containerd 2.0 por padrão. As cargas de trabalho que dependem do comportamento de runtime do contêiner devem ser validadas com o containerd 2.0 durante a migração para o Ubuntu 24.04.
  • Você precisa atualizar o SKU do sistema operacional para uma opção de sistema operacional com suporte 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.
  • Você precisa da versão prévia do CLI do Azure 18.0.0b5 ou posterior para a versão prévia e da versão 2.82.0 para a versão GA instalada e configurada. Para localizar sua versão da CLI, execute az --version. Se precisar instalar ou atualizar, consulte Instalar CLI do Azure.

Atualize para --os-sku Ubuntu2404 em um 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 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 do Kubernetes 1.32 a 1.36. Você também pode usar Azure Linux 3.0 especificando --os-sku AzureLinux3.

Observação

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

  • --os-sku AzureLinux3 há suporte nas versões do Kubernetes 1.28 a 1.36.
  • --os-sku AzureLinux3 destina-se à migração para Azure Linux 3.0 sem atualizar sua versão do Kubernetes. Você precisa atualizar o SKU do sistema operacional para uma opção de sistema operacional com suporte antes de atualizar sua versão do Kubernetes para 1.37+.
  • Você precisa do CLI do Azure versão 18.0.0b36 ou posterior para preview e versão 2.78.0 ou posterior para GA instalado e configurado. Para localizar sua versão da CLI, execute az --version. Se precisar instalar ou atualizar, consulte Instalar CLI do Azure.

Atualize para --os-sku AzureLinux3 em um 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 AzureLinux3 \
    --kubernetes-version 1.30.0 \
    --name $NODE_POOL_NAME \
    --node-count 1

Reverter a versão do sistema operacional

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

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

  • Se você estiver testando uma nova versão do sistema operacional e tiver problemas.
  • Depois de atualizar para uma versão do Kubernetes que dá suporte à nova versão do sistema operacional como padrão, talvez você queira reverter para o SKU Ubuntu ou AzureLinux padrão do sistema operacional. Isso permite que você obtenha versões futuras do sistema operacional como parte das atualizações do Kubernetes em vez de exigir uma atualização do pool de nós.

Reverter a versão do sistema operacional para o SKU padrão do sistema operacional

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

Observação

Os valores a seguir não têm suporte 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 a respectiva --os-sku que pretende usar.

SKU do SO Versão padrão do sistema operacional
Ubuntu Quando você tem o SKU Ubuntudo sistema operacional, o Ubuntu 22.04 é a versão padrão do sistema operacional se sua versão do Kubernetes for de 1.25 a 1.34. O Ubuntu 24.04 é o padrão para ubuntu no Kubernetes 1.35 a 1.37.
AzureLinux Quando você tem o SKU do sistema operacional AzureLinux, Azure Linux 2.0 é o padrão para o AzureLinux no Kubernetes 1.26 a 1.31. Azure Linux 3.0 é o padrão para o AzureLinux no Kubernetes 1.32 a 1.36.

Atualizar a SKU do sistema operacional para o Ubuntu em um pool de nós já existente

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

Atualize o --os-sku Ubuntu em um 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 Ubuntu \
    --name $NODE_POOL_NAME \
    --node-count 1

Você pode usar o az aks nodepool update comando para migrar entre qualquer Linux os-skucom suporte. O comando poderá falhar se o sistema operacional de destino não tiver uma imagem do nó com suporte para a versão do Kubernetes, o tamanho da VM ou a habilitação FIPS.

Atualize o SKU do sistema operacional para Azure Linux em um pool de nós existente

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

Atualize para --os-sku AzureLinux em um 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 AzureLinux \
    --name $NODE_POOL_NAME \
    --node-count 1

Reverter para o Ubuntu 22.04

Observação

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

  • Não há suporte para FIPS e CVM.
  • O Ubuntu 22.04 tem suporte nas versões do Kubernetes 1.25 a 1.36.
  • --os-sku Ubuntu2204 destina-se a reverter para o Ubuntu 22.04 na versão atual do Kubernetes. Você precisa atualizar o SKU do sistema operacional para uma opção de sistema operacional com suporte para atualizar sua versão do Kubernetes para 1.37 e superior.

Reverta o --os-sku Ubuntu2204 em um 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óximas etapas

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

  • Last updated on