Supported Kubernetes versions in Azure Kubernetes Service (AKS) (Versões do Kubernetes suportadas no Azure Kubernetes Service [AKS])

A comunidade Kubernetes lança versões secundárias aproximadamente a cada quatro meses.

As versões secundárias incluem novos recursos e melhorias. Os lançamentos de patches são mais frequentes (às vezes semanalmente) e destinam-se a correções de bugs críticos dentro de uma versão secundária. As versões de patches incluem correções para vulnerabilidades de segurança ou bugs importantes.

Versões do Kubernetes

O Kubernetes usa o esquema de versionamento semântico padrão para cada versão:

[major].[minor].[patch]

Examples:
  1.29.2
  1.29.1

Cada número na versão reflete a compatibilidade com versões anteriores:

• Versões principais: introduza alterações de API incompatíveis ou quebre a compatibilidade com versões anteriores.
• Versões secundárias: adicione novos recursos, mantendo a compatibilidade com versões anteriores.
• Versões de patch: Incluem correções de bugs compatíveis com versões anteriores.

Use sempre a versão de patch mais recente para a sua versão secundária atual. Por exemplo, se o cluster de produção estiver em 1.29.1 e 1.29.2 for a versão de patch mais recente disponível para a versão menor 1.29, deverá atualizar para o 1.29.2 o mais rápido possível para garantir que o cluster seja totalmente corrigido e suportado.

Calendário de lançamento do AKS Kubernetes

Verifique o calendário de lançamentos do AKS Kubernetes para os próximos lançamentos de versões. Para ver atualizações em tempo real do status de lançamento da região e das notas de versão, visite a página de status de lançamento do AKS. Para saber mais sobre a página de status da versão, consulte AKS release tracker.

Para obter o histórico de lançamentos anteriores, consulte Histórico do Kubernetes.

Versões LTS

O suporte de longo prazo (LTS) precisa ser habilitado para obter suporte estendido. Você pode encontrar mais informações em Habilitar suporte de longo prazo.

Cronograma de lançamentos do AKS Kubernetes gráfico de Gantt

Se você preferir ver essas informações visualmente, aqui está um gráfico de Gantt com todas as versões atuais exibidas:

Alterações disruptivas dos componentes do AKS por versão

Observe as seguintes alterações importantes antes de atualizar para qualquer uma das versões secundárias disponíveis:

Kubernetes 1.33.0

Kubernetes 1,32

Kubernetes 1,31

Kubernetes 1,30

Kubernetes 1,29

Alias versão menor

Você pode criar um cluster AKS sem especificar uma versão de patch. Ao criar um cluster sem designar um patch, o cluster executa o patch GA mais recente da versão menor. Por exemplo, se você criar um cluster com 1.29 e 1.29.2 for o patch GA mais recente disponível, seu cluster será criado com 1.29.2. Se deseja atualizar a sua versão do patch na mesma versão menor, use autoupgrade.

Para ver em que patch você está, execute o az aks show --resource-group myResourceGroup --name myAKSCluster comando. A currentKubernetesVersion propriedade mostra toda a versão do Kubernetes.

{
 "apiServerAccessProfile": null,
  "autoScalerProfile": null,
  "autoUpgradeProfile": null,
  "azurePortalFqdn": "myaksclust-myresourcegroup.portal.hcp.eastus.azmk8s.io",
  "currentKubernetesVersion": "1.29.2",
}

Política de suporte da versão do Kubernetes

O AKS define uma versão geralmente disponível (GA) como uma versão disponível em todas as regiões e habilitada em todas as medições de SLO ou SLA. O AKS suporta três versões secundárias GA do Kubernetes:

O AKS suporta três versões menores em GA:

• A última versão GA (N).
• As duas versões secundárias anteriores (N-1 e N-2).
  • Cada versão secundária suportada pode suportar qualquer número de patches em um determinado momento. A AKS reserva-se o direito de descontinuar patches se for detetada uma vulnerabilidade de segurança ou CVE crítica. Para saber mais sobre a disponibilidade de patches e qualquer descontinuação ad-hoc, consulte as notas de versão e visite a página de status de lançamento do AKS.

O AKS também pode suportar versões de visualização, que são explicitamente rotuladas e sujeitas aos termos e condições de visualização.

O AKS fornece suporte de plataforma apenas para uma versão secundária GA do Kubernetes após as versões regulares suportadas. A janela de suporte das versões do Kubernetes na plataforma AKS é conhecida como "N-3". Para obter mais informações, consulte a política de suporte da plataforma.

A janela suportada das versões secundárias do Kubernetes no AKS é conhecida como "N-2", onde N se refere à versão mais recente, o que significa que duas versões secundárias anteriores também são suportadas.

Por exemplo, no dia em que o AKS introduz a versão 1.29, é fornecido suporte para as seguintes versões:

Quando uma nova versão secundária é introduzida, a versão secundária mais antiga é preterida e removida. Por exemplo, digamos que a lista atual de versões secundárias suportadas seja:

1.29
1.28
1.27

Quando o AKS lança a versão 1.30, todas as versões 1.27 saem do suporte 30 dias depois.

O AKS pode suportar qualquer número de patches com base na disponibilidade de lançamento da comunidade upstream para uma determinada versão menor. A AKS reserva-se o direito de descontinuar qualquer um desses patches a qualquer momento devido a um CVE ou potencial problema de erro. Recomenda-se sempre usar o patch mais recente para uma versão menor.

Política de suporte da plataforma

A política de suporte da plataforma é um plano de suporte reduzido para determinadas versões não suportadas do Kubernetes. Durante o suporte da plataforma, os clientes só recebem suporte da Microsoft para problemas relacionados à plataforma AKS/Azure. Não há suporte para quaisquer problemas relacionados à funcionalidade e aos componentes do Kubernetes.

A política de suporte da plataforma aplica-se a clusters numa versão n-3 (onde n é a versão menor mais recente suportada de AKS GA), antes de o cluster descer para n-4. Por exemplo, o Kubernetes v1.26 é considerado suporte de plataforma quando a v1.29 é a versão mais recente do GA. No entanto, durante a versão v1.30-GA, a v1.26 deve atualizar automaticamente para a v1.27. Se você estiver executando uma versão n-2, no momento em que ela se torna n-3, ela também se torna obsoleta e você entra na política de suporte da plataforma.

O AKS conta com os lançamentos e patches do Kubernetes, que é um projeto Open Source que suporta apenas uma janela deslizante de três versões secundárias. O AKS só pode garantir suporte total enquanto essas versões estão sendo atendidas a montante. Como não há mais patches sendo produzidos na origem, o AKS pode deixar essas versões sem correções ou criar uma derivação. Devido a essa limitação, o suporte à plataforma não oferece suporte para nada que dependa do Kubernetes upstream.

Esta tabela descreve as diretrizes de suporte para o Suporte da Comunidade em comparação com o suporte da Plataforma.

Versões suportadas kubectl

Você pode usar uma versão menor do kubectl que seja mais antiga ou mais recente que a da sua versão do kube-apiserver, política de suporte do Kubernetes para kubectl.

Por exemplo, se o seu kube-apiserver estiver em 1.28, então você pode usar as versões 1.27 a 1.29 do com esse kubectl.

Para instalar ou atualizar kubectl para a versão mais recente, execute:

az aks install-cli

Install-AzAksKubectl -Version latest

Suporte de Longo Prazo (LTS)

O AKS oferece um ano de suporte comunitário e um ano de suporte de longo prazo (LTS), incluindo correções de segurança retroportadas da comunidade upstream. O nosso grupo de trabalho LTS upstream contribui esforços para a comunidade para proporcionar aos nossos clientes um período de suporte mais longo.

Para obter mais informações sobre LTS, consulte Suporte de longo prazo para o Serviço Kubernetes do Azure (AKS).

Processo de lançamento e descontinuação

Você pode consultar os lançamentos de novas versões e descontinuações no calendário de lançamentos do AKS Kubernetes.

Para novas versões secundárias do Kubernetes:

• O AKS anuncia novas datas de lançamento da versão e a descontinuação da versão antiga nas notas de versão do AKS pelo menos 30 dias antes da remoção.
• O AKS usa o Azure Advisor para alertá-lo se uma nova versão pode causar problemas em seu cluster devido a APIs obsoletas. O Azure Advisor também alerta você se você estiver sem suporte
• O AKS publica uma notificação de integridade do serviço disponível para todos os usuários com acesso ao AKS e ao portal e envia um e-mail para os administradores de assinatura com as datas de remoção da versão planejadas.

  Note

  Para saber quem são os administradores da sua subscrição ou para a alterar, consulte Gerir subscrições do Azure.

• Você tem 30 dias a partir da remoção da versão para atualizar para uma versão secundária suportada para continuar recebendo suporte.

Para novas versões de correção do Kubernetes:

• Devido à natureza urgente das versões de patch, elas podem ser introduzidas no serviço à medida que ficam disponíveis. Uma vez disponíveis, os adesivos têm um ciclo de vida mínimo de dois meses.
• Em geral, o AKS não comunica amplamente o lançamento de novas versões de patches. No entanto, o AKS monitora e valida constantemente os patches CVE disponíveis para apoiá-los no AKS em tempo hábil. Se um patch crítico for encontrado ou uma ação do usuário for necessária, o AKS notificará você para atualizar para o patch recém-disponível.
• Você tem 30 dias a partir da remoção de uma versão de patch do AKS para atualizar para um patch suportado e continuar recebendo suporte. No entanto, você não poderá mais criar clusters ou pools de nós quando a versão for preterida/removida.

Exceções à política de versões suportadas

A AKS reserva-se o direito de adicionar ou remover versões novas/existentes com um ou mais bugs ou problemas de segurança críticos que afetem a produção sem aviso prévio.

Dependendo da gravidade da falha ou do problema de segurança, versões específicas de patches podem ser ignoradas ou a implementação acelerada.

Portal do Azure e versões da CLI

Se você implantar um cluster AKS com o portal do Azure, CLI do Azure, Azure PowerShell, o cluster assumirá como padrão a versão secundária N-1 e o patch mais recente. Por exemplo, se o AKS suportar 1.29.2, 1.29.1, 1.28.7, 1.28.6, 1.27.11 e 1.27.10, a versão padrão selecionada será 1.28.7.

az aks get-versions --___location eastus --output table

Get-AzAksVersion -Location eastus

FAQ

Como a Microsoft me notifica sobre novas versões do Kubernetes?

A equipe do AKS anuncia novas datas de lançamento da versão do Kubernetes em nossa documentação, no GitHub e por e-mail para administradores de assinatura com clusters próximos do fim do suporte. O AKS também usa o Azure Advisor para alertá-lo dentro do portal do Azure se você estiver sem suporte e informá-lo sobre APIs preteridas que podem afetar seu aplicativo ou processo de desenvolvimento.

Com que frequência devo esperar atualizar as versões do Kubernetes para permanecer no suporte?

A partir do Kubernetes 1.19, a comunidade de código aberto expandiu o suporte para um ano. A AKS compromete-se a fornecer patches e suporte que estejam em conformidade com os compromissos upstream. Para clusters AKS na versão 1.19 ou superior, você pode atualizar no mínimo uma vez por ano para permanecer em uma versão suportada.

O que acontece quando você atualiza um cluster do Kubernetes com uma versão secundária que não é suportada?

Se você estiver na versão n-3 ou mais antiga, isso significa que você está fora do suporte e precisa atualizar. Se a sua atualização da versão n-3 para n-2 for bem-sucedida, você está de volta às nossas políticas de suporte. Por exemplo:

• Se a versão menor mais antiga suportada do AKS for 1.27 e estiver na versão 1.26 ou mais antiga, estará fora do suporte.
• Se você atualizar com sucesso da versão 1.26 para a 1.27 ou superior, estará de volta às nossas políticas de suporte.

Não há suporte para downgrades.

O que significa "Fora do Suporte"?

«Fora do Apoio» significa que:

• A versão que você está executando está fora da lista de versões suportadas.
• Você será solicitado a atualizar o cluster para uma versão suportada ao solicitar suporte, a menos que esteja dentro do período de carência de 30 dias após a descontinuação da versão.

Além disso, o AKS não faz nenhum tempo de execução ou outras garantias para clusters fora da lista de versões suportadas.

O que acontece quando você dimensiona um cluster do Kubernetes com uma versão secundária que não é suportada?

Para versões secundárias não suportadas pelo AKS, o escalonamento para dentro ou para fora deve continuar a funcionar. Como não há garantias com a qualidade do serviço, recomendamos atualizar para trazer seu cluster de volta ao suporte.

Você pode ficar em uma versão do Kubernetes para sempre?

Se um cluster estiver sem suporte para mais de três versões secundárias e acarretar riscos de segurança, o Azure entrará em contato proativamente com você. Eles aconselham você a atualizar seu cluster. Se você não tomar mais medidas, o Azure reserva-se o direito de atualizar automaticamente seu cluster em seu nome.

O que acontece se dimensionar um cluster de Kubernetes com uma versão secundária que não é suportada?

Para versões secundárias não suportadas pelo AKS, o escalonamento para dentro ou para fora deve continuar a funcionar. Como não há garantias com a qualidade do serviço, recomendamos atualizar para trazer seu cluster de volta ao suporte.

Qual versão o plano de controle suporta se o pool de nós não estiver em uma das versões AKS suportadas?

O plano de controlo deve estar dentro de um intervalo de versões de todos os grupos de nós. Para obter detalhes sobre como atualizar o plano de controlo ou os pools de nós, visite a documentação sobre atualização dos pools de nós.

Qual é a diferença permitida nas versões entre o plano de controlo e o conjunto de nós?

A política de distorção de versão agora permite uma diferença de até 3 versões entre o plano de controle e os pools de agentes. O AKS segue esta mudança de política de versão distorcida a partir da versão 1.28.

Posso ignorar várias versões do AKS durante a atualização do cluster?

Se você atualizar um cluster AKS suportado, as versões secundárias do Kubernetes não poderão ser ignoradas. A política de desvio de versão dos planos de controle do Kubernetes não suporta a passagem de versões secundárias. Por exemplo, atualizações entre:

• 1.28.x ->1.29.x: permitido.
• 1.27.x ->1.28.x: permitido.
• 1.27.x ->1.29.x: não permitido.

Para atualizações de versão do plano de controlo, é possível ir até 3 versões menores para versões suportadas pela comunidade sequencialmente.

Para atualizar de 1.27.x ->1.29.x:

1. Atualize de 1.27.x para> 1.28.x.
2. Atualize de 1.28.x para> 1.29.x.

Observação: A partir da versão 1.28, as versões do pool de agentes podem ser até 3 versões mais antigas que as versões do plano de controle, conforme a política de discrepância de versão. Se a sua versão estiver muito atrás da versão mínima suportada, talvez seja necessário fazer mais de uma operação de atualização do plano de controle para chegar à versão mínima suportada. Por exemplo, se a versão atual do plano de controle for 1.23.x e você pretende atualizar para uma versão mínima suportada de 1.27.x como exemplo. Você pode ter que atualizar sequencialmente 4 vezes de 1.23.x para chegar a 1.27.x. Observe também que as versões do pool de agentes podem ser atualizadas para a versão menor do plano de controlo. No exemplo anterior, você pode atualizar a versão do agentpool duas vezes, uma vez de 1.23.x para 1.25.x, quando a versão do plano de controle estiver em 1.25.x. E então de 1.25.x para 1.27.x, quando a versão do plano de controle está em 1.27.x. Ao realizar uma atualização in-place, como o plano de controle e o pool de agentes juntos, aplicam-se as mesmas regras que se aplicam à atualização do plano de controle.

Se estiver a realizar uma atualização a partir de uma versão não suportada , a atualização é feita sem qualquer garantia de funcionalidade e é excluída dos contratos de nível de serviço e da garantia limitada. Os clusters que executam versão sem suporte têm a flexibilidade de separar as atualizações do plano de controle das atualizações do pool de nós. No entanto, se a sua versão estiver desatualizada, recomendamos que recrie o cluster.

Posso criar um novo cluster 1.xx.x durante a janela de suporte da plataforma?

Não, a criação de novos clusters não é possível durante o período de Suporte da Plataforma.

Estou numa versão recém-depreciada que está fora do suporte da plataforma, ainda posso adicionar novos grupos de nós? Ou devo atualizar?

Sim, você pode adicionar pools de agentes, desde que sejam compatíveis com a versão do plano de controle.

Próximos passos

Para obter informações sobre como atualizar seu cluster, consulte:

• Atualizar um cluster do Azure Kubernetes Service (AKS)
• Atualizar vários clusters AKS através do Azure Kubernetes Fleet Manager