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.

Cuidado

Neste artigo, há referências a versões do Sistema Operacional Ubuntu e Azure Linux que estão sendo preteridas para AKS:

  • A partir de 17 de junho de 2025, o AKS não dará mais suporte ao Ubuntu 18.04. As imagens de nó existentes serão excluídas e o AKS não fornecerá mais atualizações de segurança. Você não poderá mais escalar seus pools de nós. Migre para uma versão do Ubuntu com suporte atualizando os pools de nós para uma versão do Kubernetes com suporte. Para obter mais informações sobre essa desativação, consulte Desativação: pools de nós do Ubuntu 18.04 no AKS.

  • A partir de 17 de março de 2027, o AKS não dará mais suporte ao Ubuntu 20.04. As imagens de nó existentes serão excluídas e o AKS não fornecerá mais atualizações de segurança. Você não poderá mais escalar seus pools de nós. Migre para uma versão do Ubuntu com suporte atualizando os pools de nós para a versão 1.34+ do Kubernetes. Para obter mais informações sobre essa desativação, consulte Desativação: pools de nós do Ubuntu 20.04 no AKS.

  • 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 de nó serão removidas e não será possível escalar os grupos 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 [Desativação] Pools de nós do Azure Linux 2.0 no 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 o Kubernetes versão 1.25 a 1.32.
Linux Ubuntu2404 Esse SKU do sistema operacional só terá suporte no Kubernetes 1.32 a 1.38. O Ubuntu 24.04 está disponível em versão prévia com o Kubernetes 1.32+ usando --os-sku Ubuntu2404. Recomendamos esse SKU do sistema operacional se você quiser testar a nova versão do sistema operacional sem atualizar sua versão do Kubernetes.
Linux Ubuntu2204 Esse SKU do sistema operacional tem suporte no Kubernetes versão 1.25 a 1.36. Atualmente, o Ubuntu 22.04 é padrão ao usar --os-sku Ubuntu. Recomendamos essa SKU do sistema operacional se você precisar reverter para o Ubuntu 22.04 depois de testar o Ubuntu 24.04.
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, ela tem suporte na versão prévia antes de ficar disponível e padrão. 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.

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

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 (versão prévia)

O Ubuntu 24.04 está disponível em versão prévia 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 terá suporte nas versões do Kubernetes 1.32 a 1.38.
  • 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 da CLI do Azure versão 18.0.0b5 ou posterior 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.

Instalar aks-preview extensão

  1. Instale a extensão aks-preview da CLI do Azure usando o comando az extension add.

    Importante

    As funcionalidades em versão preliminar do AKS estão disponíveis de forma optativa e por autoatendimento. As versões prévias são fornecidas “no estado em que se encontram” e “conforme disponíveis” e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões prévias do AKS são parcialmente cobertas pelo suporte ao cliente em uma base de melhor esforço. Dessa forma, esses recursos não são destinados ao uso em produção. Para obter mais informações, consulte os seguintes artigos:

    az extension add --name aks-preview

  2. Atualize para a última versão da extensão usando o comando az extension update. O Ubuntu 24.04 requer um mínimo de 18.0.0b5.

    az extension update --name aks-preview

Registrar o sinalizador de recurso Ubuntu2404Preview

  1. Registre o sinalizador de recurso Ubuntu2404Preview usando o comando az feature register.

    az feature register --namespace "Microsoft.ContainerService" --name "Ubuntu2404Preview"

  2. Verifique o status do registro usando o comando az feature show. Demora alguns minutos para o status mostrar Registrado.

    az feature show --namespace Microsoft.ContainerService --name Ubuntu2404Preview

  3. Quando o status reflete Registrado, atualize o registro do provedor de recursos Microsoft.ContainerService usando o comando az provider register.

    az provider register --namespace Microsoft.ContainerService

Atualize o pool de nós para usar o Ubuntu 24.04

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.

Atualizar o pool de nós para usar o Azure Linux 3.0

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
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.34+.

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