Compartilhar via

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

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

Importante

A partir de 17 de março de 2027, o 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 problema de desativação do GitHub e o anúncio de desativação do Azure Updates. Para se manter informado sobre anúncios e atualizações, acompanhe as notas de lançamento do AKS.

Importante

A partir de 30 de novembro de 2025, o AKS (Serviço de Kubernetes do Azure) não dá mais suporte ou fornece atualizações de segurança para o Azure Linux 2.0. A imagem do nó do Azure no Linux 2.0 foi 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 Azure Linux com suporte atualizando os pools de nós para uma versão do Kubernetes com suporte ou migrando para o osSku AzureLinux3. Para obter mais informações, consulte o problema de desativação do GitHub e o anúncio de desativação do Azure Updates. Para se manter informado sobre anúncios e atualizações, acompanhe as notas de lançamento 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. Você não pode 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. Você não pode 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 a CLI ou a API do AKS do Azure.
  • --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 especificando --os-type Linux e --os-sku AzureLinux. Isso atualizará você 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 especificando --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. O Azure Linux 2.0 é o padrão para o Kubernetes versão 1.27 a 1.31. O Azure Linux 3.0 é o 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 o 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 o 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 Tipo de SO Windows na versão 1.14 a 1.24 do Kubernetes.
Windows Windows 2022 1.23 a 1.34 Configuração padrão para o tipo de sistema operacional Windows no Kubernetes da versão 1.25 à 1.34.

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 ter a versão de pré-lançamento da CLI do Azure 18.0.0b5 ou posterior para pré-lançamento e a versão 2.82.0 para GA instalada e configurada. Para localizar sua versão da CLI, execute az --version. Se você precisa instalar ou atualizar, consulte Instalar a 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 o Azure Linux 3.0

O Azure Linux 3.0 é o padrão nas --os-sku AzureLinux versões do Kubernetes 1.32 a 1.36. Você também pode usar o 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 o 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 da CLI do Azure versão 18.0.0b36 ou posterior para versão prévia e versão 2.78.0 ou posterior para GA instalada e configurada. Para localizar sua versão da CLI, execute az --version. Se você precisa instalar ou atualizar, consulte Instalar a 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 AzureLinuxdo sistema operacional, o Azure Linux 2.0 é o padrão para o AzureLinux no Kubernetes 1.26 a 1.31. O 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