Kubernetes-versioner som stöds i Azure Kubernetes Service (AKS)

Kubernetes-communityn släpper mindre versioner ungefär var fjärde månad.

Delversioner innehåller nya funktioner och förbättringar. Korrigeringsversioner är vanligare (ibland varje vecka) och är avsedda för kritiska felkorrigeringar i en delversion. Korrigeringsversioner omfattar korrigeringar för säkerhetsrisker eller större buggar.

Kubernetes-versioner

Kubernetes använder standardschemat för semantisk versionshantering för varje version:

[major].[minor].[patch]

Examples:
  1.29.2
  1.29.1

Varje tal i versionen anger allmän kompatibilitet med den tidigare versionen:

  • Större versioner ändras när inkompatibla API-uppdateringar eller bakåtkompatibilitet kan brytas.
  • Mindre versioner ändras när funktionsuppdateringar görs som är bakåtkompatibla med de andra mindre versionerna.
  • Korrigeringsversioner ändras när bakåtkompatibla felkorrigeringar görs.

Sikta på att köra den senaste korrigeringsversionen av den delversion som du kör. Om ditt produktionskluster till exempel är på 1.29.1 och 1.29.2 är den senaste tillgängliga korrigeringsversionen som är tillgänglig för 1.29-delversionen bör du uppgradera till 1.29.2 så snart som möjligt för att säkerställa att klustret är helt korrigerat och stöds.

AKS Kubernetes-versionskalender

Visa kommande versioner i AKS Kubernetes-versionskalendern. Om du vill se uppdateringar i realtid av regionens versionsstatus och viktig information om versioner går du till webbsidan för AKS-versionsstatus. Mer information om webbsidan för versionsstatus finns i AKS-versionsspåraren.

Kommentar

AKS följer 12 månaders support för en allmänt tillgänglig Kubernetes-version (GA). Läs mer om vår supportpolicy för Kubernetes-versionshantering genom att läsa våra vanliga frågor och svar.

Tidigare versionshistorik finns i Kubernetes-historik.

K8s-version Uppströmsversion FÖRHANDSVERSION AV AKS AKS GA Livets slut Plattformssupport
1,26 Dec 2022 febr. 2023 Apr 2023 Mars 2024 Till 1.30 GA
1.27* april 2023 juni 2023 Jul 2023 Jul 2024, LTS till jul 2025 Till 1.31 GA
1.28 aug. 2023 sept. 2023 November 2023 Nov 2024 Till 1.32 GA
1,29 Dec. 2023 Febr. 2024 Mar 2024 Till 1.33 GA
1,30 Apr 2024 Maj 2024 Jun 2024 Till 1.34 GA

* Anger att versionen är avsedd för långsiktig support

Gantt-schema för AKS Kubernetes-versionsschema

Om du föredrar att se den här informationen visuellt, här är ett Gantt-schema med alla aktuella versioner som visas:

Gantt-schema som visar livscykeln för alla Kubernetes-versioner som för närvarande är aktiva i AKS.

AKS-komponenter – icke-bakåtkompatibla ändringar efter version

Observera följande viktiga ändringar innan du uppgraderar till någon av de tillgängliga delversionerna:

Kubernetes-version AKS-hanterade tillägg AKS-komponenter OS-komponenter Icke-bakåtkompatibla ändringar Kommentar
1,26 Azure Policy 1.3.0
Metrics-Server 0.6.3
KEDA 2.10.1
Öppna Service Mesh 1.2.3
Core DNS V1.9.4
Overlay VPA 0.11.0
Azure-Keyvault-SecretsProvider 1.4.1
Application Gateway Ingress Controller (AGIC) 1.5.3
Image Cleaner v1.2.3
Azure Workload Identity v1.0.0
MDC Defender 1.0.56
Azure Active Directory Pod Identity 1.8.13.6
GitOps 1.7.0
KMS 0.5.0
azurefile-csi-driver 1.26.10
Cilium 1.12.8
CNI 1.4.44
Autoskalning av kluster 1.8.5.3
OS Image Ubuntu 22.04 Cgroups V2
ContainerD 1.7
Azure Linux 2.0
Cgroups V1
ContainerD 1.6
azurefile-csi-driver 1.26.10 Ingen
1.27 Azure Policy 1.3.0
azuredisk-csi driver v1.28.5
azurefile-csi driver v1.28.7
blob-csi v1.22.4
csi-attacher v4.3.0
csi-resizer v1.8.0
csi-snapshotter v6.2.2
snapshot-controller v6.2.2
Metrics-Server 0.6.3
Keda 2.11.2
Öppna Service Mesh 1.2.3
Core DNS V1.9.4
Overlay VPA 0.11.0
Azure-Keyvault-SecretsProvider 1.4.1
Application Gateway Ingress Controller (AGIC) 1.7.2
Image Cleaner v1.2.3
Azure Workload Identity v1.0.0
MDC Defender 1.0.56
Azure Active Directory Pod Identity 1.8.13.6
GitOps 1.7.0
azurefile-csi-driver 1.28.7
KMS 0.5.0
CSI Secret Store-drivrutin 1.3.4-1
Cilium 1.13.10-1
CNI 1.4.44
Autoskalning av kluster 1.8.5.3
OS Image Ubuntu 22.04 Cgroups V2
ContainerD 1.7 för Linux och 1.6 för Windows
Azure Linux 2.0
Cgroups V1
ContainerD 1.6
Keda 2.11.2
Cilium 1.13.10-1
azurefile-csi-driver 1.28.7
azuredisk-csi driver v1.28.5
blob-csi v1.22.4
csi-attacher v4.3.0
csi-resizer v1.8.0
csi-snapshotter v6.2.2
snapshot-controller v6.2.2
På grund av FIPS-certifieringsstatusen för Ubuntu 22.04 växlar vi AKS FIPS-noder från 18.04 till 20.04 från 1.27 och senare.
1.28 Azure Policy 1.3.0
azurefile-csi-driver 1.29.2
csi-node-driver-registrar v2.9.0
csi-livenessprobe 2.11.0
azuredisk-csi-linux v1.29.2
azuredisk-csi-windows v1.29.2
csi-provisioner v3.6.2
csi-attacher v4.5.0
csi-resizer v1.9.3
csi-snapshotter v6.2.2
snapshot-controller v6.2.2
Metrics-Server 0.6.3
KEDA 2.11.2
Öppna Service Mesh 1.2.7
Core DNS V1.9.4
Overlay VPA 0.13.0
Azure-Keyvault-SecretsProvider 1.4.1
Application Gateway Ingress Controller (AGIC) 1.7.2
Image Cleaner v1.2.3
Azure-arbetsbelastningsidentitet v1.2.0
MDC Defender Security Publisher 1.0.68
CSI Secret Store-drivrutin 1.3.4-1
MDC Defender Old File Cleaner 1.3.68
MDC Defender Pod Collector 1.0.78
MDC Defender Lågnivåinsamlare 1.3.81
Azure Active Directory Pod Identity 1.8.13.6
GitOps 1.8.1
Cilium 1.13.10-1
CNI v1.4.43.1 (standard)/v1.5.11 (Azure CNI-överlägg)
Autoskalning av kluster 1.27.3
Tigera-Operator 1.28.13
OS Image Ubuntu 22.04 Cgroups V2
ContainerD 1.7.5 för Linux och 1.7.1 för Windows
Azure Linux 2.0
Cgroups V1
ContainerD 1.6
azurefile-csi-driver 1.29.2
csi-resizer v1.9.3
csi-attacher v4.4.2
csi-provisioner v4.4.2
blob-csi v1.23.2
azurefile-csi driver v1.29.2
azuredisk-csi driver v1.29.2
csi-livenessprobe v2.11.0
csi-node-driver-registrar v2.9.0
Ingen
1,29 Azure Policy 1.3.0
csi-provisioner v4.0.0
csi-attacher v4.5.0
csi-snapshotter v6.3.3
snapshot-controller v6.3.3
Metrics-Server 0.6.3
KEDA 2.11.2
Öppna Service Mesh 1.2.7
Core DNS V1.9.4
Overlay VPA 0.13.0
Azure-Keyvault-SecretsProvider 1.4.1
Application Gateway Ingress Controller (AGIC) 1.7.2
Image Cleaner v1.2.3
Azure-arbetsbelastningsidentitet v1.2.0
MDC Defender Security Publisher 1.0.68
MDC Defender Old File Cleaner 1.3.68
MDC Defender Pod Collector 1.0.78
MDC Defender Lågnivåinsamlare 1.3.81
Azure Active Directory Pod Identity 1.8.13.6
GitOps 1.8.1
CSI Secret Store-drivrutin 1.3.4-1
azurefile-csi-driver 1.29.3
Cilium 1.13.5
CNI v1.4.43.1 (standard)/v1.5.11 (Azure CNI-överlägg)
Autoskalning av kluster 1.27.3
Tigera-Operator 1.30.7
OS Image Ubuntu 22.04 Cgroups V2
ContainerD 1.7.5 för Linux och 1.7.1 för Windows
Azure Linux 2.0
Cgroups V1
ContainerD 1.6
Tigera-Operator 1.30.7
csi-provisioner v4.0.0
csi-attacher v4.5.0
csi-snapshotter v6.3.3
snapshot-controller v6.3.3
Ingen

Alias-delversion

Kommentar

Alias delversion kräver Azure CLI version 2.37 eller senare samt API-version 20220401 eller senare. Använd az upgrade för att installera den senaste versionen av CLI.

Med AKS kan du skapa ett kluster utan att ange den exakta korrigeringsversionen. När du skapar ett kluster utan att ange en korrigering kör klustret delversionens senaste GA-korrigering. Om du till exempel skapar ett kluster med 1.29 och 1.29.2 är den senaste tillgängliga ga'd-korrigeringen skapas klustret med 1.29.2. Om du vill uppgradera korrigeringsversionen i samma delversion använder du automatisk uppgradering.

Kör kommandot för att se vilken korrigering du är på az aks show --resource-group myResourceGroup --name myAKSCluster . Egenskapen currentKubernetesVersion visar hela Kubernetes-versionen.

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

Stödprincip för Kubernetes-version

AKS definierar en allmänt tillgänglig version (GA) som en version som är tillgänglig i alla regioner och aktiverad i alla SLO- eller SLA-mått. AKS stöder tre ga-delversioner av Kubernetes:

  • Den senaste ga-delversionen som släpptes i AKS (som vi kallar N).
  • Två tidigare delversioner.
    • Varje delversion som stöds stöder också högst två stabila korrigeringar.

AKS kan också ha stöd för förhandsversioner som uttryckligen är märkta och omfattas av förhandsversionsvillkor.

AKS tillhandahåller plattformsstöd endast för en ga-delversion av Kubernetes efter de vanliga versioner som stöds. Plattformssupportfönstret för Kubernetes-versioner på AKS kallas "N-3". Mer information finns i plattformssupportprincip.

Kommentar

AKS använder säkra distributionsmetoder som omfattar gradvis regiondistribution. Det innebär att det kan ta upp till 10 arbetsdagar innan en ny version eller en ny version är tillgänglig i alla regioner.

Det fönster som stöds i Kubernetes-delversioner på AKS kallas "N-2", där N refererar till den senaste versionen, vilket innebär att två tidigare mindre versioner också stöds.

Den dag då AKS introducerar version 1.29 ges till exempel stöd för följande versioner:

Ny delversion Delversionslista som stöds
1,29 1.29, 1.28, 1.27

När en ny delversion introduceras är den äldsta delversionen inaktuell och borttagen. Anta till exempel att den aktuella delversionslistan som stöds är:

1.29
1.28
1.27

När AKS släpper 1.30 upphör alla 1.27-versioner att ha support 30 dagar senare.

AKS stöder också högst två korrigeringsversioner av en viss delversion. Till exempel med följande versioner som stöds:

Current Supported Version List
------------------------------
1.29.2, 1.29.1, 1.28.7, 1.28.6, 1.27.11, 1.27.10

Om AKS-versioner 1.29.3 och 1.28.8, är de äldsta korrigeringsversionerna inaktuella och borttagna, och versionslistan som stöds blir:

New Supported Version List
----------------------
1.29.3, 1.29.2, 1.28.8, 1.28.7, 1.27.11, 1.27.10

Plattformsstödprincip

Plattformsstödprincip är en reducerad supportplan för vissa Kubernetes-versioner som inte stöds. Under plattformssupporten får kunderna endast support från Microsoft för AKS/Azure-plattformsrelaterade problem. Eventuella problem som rör Kubernetes-funktioner och komponenter stöds inte.

Plattformsstödprincip gäller för kluster i en n-3-version (där n är den senaste versionen av AKS GA-delversionen som stöds) innan klustret sjunker till n-4. Kubernetes v1.26 betraktas till exempel som plattformsstöd när v1.29 är den senaste GA-versionen. Men under v1.30 GA-versionen uppgraderas v1.26 automatiskt till v1.27. Om du kör en n-2-version blir den även inaktuell när den blir n-3 och du anger plattformssupportprincipen.

AKS förlitar sig på versioner och korrigeringar från Kubernetes, som är ett projekt med öppen källkod som endast stöder ett skjutfönster med tre mindre versioner. AKS kan bara garantera fullständigt stöd medan dessa versioner hanteras uppströms. Eftersom det inte finns några fler korrigeringar som skapas uppströms kan AKS antingen lämna dessa versioner okopplade eller förgrena sig. På grund av den här begränsningen stöder plattformssupport inte något från att förlita sig på Kubernetes uppströms.

Den här tabellen beskriver riktlinjer för support för communitystöd jämfört med plattformsstöd.

Supportkategori Community-stöd (N-2) Plattformsstöd (N-3)
Uppgraderingar från N-3 till en version som stöds Stöds Stöds
Plattformstillgänglighet (Azure) Stöds Stöds
Skalning av nodpool Stöds Stöds
VM-tillgänglighet Stöds Stöds
Problem med lagring, nätverk Stöds Stöds förutom felkorrigeringar och tillbakadragna komponenter
Starta/stoppa Stöds Stöds
Rotera certifikat Stöds Stöds
Serviceavtal för infrastruktur Stöds Stöds
Serviceavtal för kontrollplan Stöds Stöds
SLA för plattform (AKS) Stöds Stöds inte
Kubernetes-komponenter (inklusive tillägg) Stöds Stöds inte
Komponentuppdateringar Stöds Stöds inte
Snabbkorrigeringar för komponent Stöds Stöds inte
Tillämpa felkorrigeringar Stöds Stöds inte
Tillämpa säkerhetskorrigeringar Stöds Stöds inte
Stöd för Kubernetes API Stöds Stöds inte
Skapa kluster- eller nodpool Stöds Stöds inte
Ögonblicksbild av nodpool Stöds Stöds inte
Uppgradering av nodavbildning Stöds Stöds inte

Kommentar

Tabellen ovan kan komma att ändras och beskriver vanliga supportscenarier. Scenarier som rör Kubernetes-funktioner och komponenter stöds inte för N-3. Mer support finns i Support och felsökning för AKS.

Versioner som stöds kubectl

Du kan använda en lägre version som är äldre eller nyare kubectl i förhållande till kube-apiserver-versionen, i överensstämmelse med Kubernetes-supportprincipen för kubectl.

Om kube-apiserver till exempel är på 1.28 kan du använda versionerna 1.27 till 1.29 av kubectl med den kube-apiservern.

Om du vill installera eller uppdatera kubectl till den senaste versionen kör du:

az aks install-cli

Långsiktigt stöd (LTS)

AKS tillhandahåller ett års communitystöd och ett års långsiktig support (LTS) för att säkerhetskopiera portsäkerhetskorrigeringar från communityn uppströms i vår offentliga lagringsplats. Vår överordnade LTS-arbetsgrupp bidrar med insatser tillbaka till communityn för att ge våra kunder ett längre supportfönster.

Mer information om LTS finns i Långsiktigt stöd för Azure Kubernetes Service (AKS).

Lanserings- och utfasningsprocess

Du kan referera till kommande versioner och utfasningar i AKS Kubernetes-versionskalendern.

För nya delversioner av Kubernetes:

  • AKS publicerar ett meddelande med planerat datum för en ny version och respektive gammal versionsutfasning på AKS-versionsanteckningarna minst 30 dagar före borttagningen.
  • AKS använder Azure Advisor för att varna dig om en ny version kan orsaka problem i klustret på grund av inaktuella API:er. Azure Advisor varnar dig också om du inte har support
  • AKS publicerar ett meddelande om tjänstens hälsotillstånd som är tillgängligt för alla användare med ÅTKOMST till AKS och portalen och skickar ett e-postmeddelande till prenumerationsadministratörerna med de planerade datumen för versionsborttagning.

    Kommentar

    Om du vill ta reda på vem som är dina prenumerationsadministratörer eller ändra den kan du läsa hantera Azure-prenumerationer.

  • Du har 30 dagar på dig från versionsborttagningen för att uppgradera till en delversion som stöds för att fortsätta få support.

För nya korrigeringsversioner av Kubernetes:

  • På grund av korrigeringsversionernas brådskande karaktär kan de introduceras i tjänsten när de blir tillgängliga. När det är tillgängligt har korrigeringar en livscykel på minst två månader.
  • I allmänhet kommunicerar AKS inte i stort sett versionen av nya korrigeringsversioner. AKS övervakar och validerar dock ständigt tillgängliga CVE-korrigeringar för att stödja dem i AKS i tid. Om en kritisk korrigering hittas eller om användaråtgärd krävs meddelar AKS dig att uppgradera till den nyligen tillgängliga korrigeringen.
  • Du har 30 dagar på dig från att en korrigeringsversion har tagits bort från AKS för att uppgradera till en korrigering som stöds och fortsätta att få support. Du kommer dock inte längre att kunna skapa kluster eller nodpooler när versionen är inaktuell/borttagen.

Principfel för versioner som stöds

AKS förbehåller sig rätten att lägga till eller ta bort nya/befintliga versioner med en eller flera kritiska produktionspåverkande buggar eller säkerhetsproblem utan förvarning.

Specifika korrigeringsversioner kan hoppas över eller distributionen påskyndas, beroende på hur allvarligt felet eller säkerhetsproblemet är.

Azure-portalen och CLI-versioner

När du distribuerar ett AKS-kluster med Azure-portalen, Azure CLI, Azure PowerShell, standardvärdet för klustret till N-1-delversionen och den senaste korrigeringen. Om AKS till exempel stöder 1.29.2, 1.29.1, 1.28.7, 1.28.6, 1.27.11 och 1.27.10 är standardversionen 1.28.7.

Om du vill ta reda på vilka versioner som är tillgängliga för din prenumeration och region använder du az aks get-versions kommandot . I följande exempel visas tillgängliga Kubernetes-versioner för regionen EastUS :

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

Vanliga frågor

Hur meddelar Microsoft mig om nya Kubernetes-versioner?

AKS-teamet publicerar meddelanden med planerade datum för de nya Kubernetes-versionerna i vår dokumentation, GitHub, och i e-postmeddelanden till prenumerationsadministratörer som äger kluster som kommer att falla ur supporten. AKS använder också Azure Advisor för att varna dig i Azure-portalen om du inte har support och informera dig om inaktuella API:er som kan påverka din program- eller utvecklingsprocess.

Hur ofta ska jag förvänta mig att uppgradera Kubernetes-versioner för att behålla supporten?

Från och med Kubernetes 1.19 har öppen källkod community utökat stödet till ett år. AKS åtar sig att aktivera korrigeringar och stöd för matchning av uppströmsåtaganden. För AKS-kluster på 1.19 och senare kan du uppgradera minst en gång om året för att behålla en version som stöds.

Vad händer när du uppgraderar ett Kubernetes-kluster med en delversion som inte stöds?

Om du har n-3-versionen eller äldre innebär det att du inte har support och uppmanas att uppgradera. När uppgraderingen från version n-3 till n-2 lyckas är du tillbaka i våra supportprinciper. Till exempel:

  • Om den äldsta aks-delversionen som stöds är 1.27 och du är på 1,26 år eller äldre är du utanför supporten.
  • När du uppgraderar från 1.26 till 1.27 eller senare är du tillbaka i våra supportprinciper.

Nedgraderingar stöds inte.

Vad betyder "Utanför supporten"?

"Utanför supporten" innebär att:

  • Den version som du kör ligger utanför listan över versioner som stöds.
  • Du uppmanas att uppgradera klustret till en version som stöds när du begär support, såvida du inte befinner dig inom respitperioden på 30 dagar efter versionsutfasningen.

Dessutom ger AKS inga körningsgarantier eller andra garantier för kluster utanför listan över versioner som stöds.

Vad händer när du skalar ett Kubernetes-kluster med en delversion som inte stöds?

För mindre versioner som inte stöds av AKS bör in- eller utskalning fortsätta att fungera. Eftersom det inte finns några garantier med tjänstkvalitet rekommenderar vi att du uppgraderar för att få tillbaka klustret till support.

Kan du stanna på en Kubernetes-version för alltid?

Om ett kluster inte har stöd för fler än tre (3) mindre versioner och har visat sig medföra säkerhetsrisker kontaktar Azure dig proaktivt för att uppgradera klustret. Om du inte vidtar ytterligare åtgärder förbehåller sig Azure rätten att automatiskt uppgradera klustret åt dig.

Vad händer om du skalar ett Kubernetes-kluster med en delversion som inte stöds?

För mindre versioner som inte stöds av AKS bör in- eller utskalning fortsätta att fungera. Eftersom det inte finns några garantier med tjänstkvalitet rekommenderar vi att du uppgraderar för att få tillbaka klustret till support.

Vilken version stöder kontrollplanet om nodpoolen inte finns i någon av de AKS-versioner som stöds?

Kontrollplanet måste finnas i ett fönster med versioner från alla nodpooler. Mer information om hur du uppgraderar kontrollplanet eller nodpoolerna finns i dokumentationen om hur du uppgraderar nodpooler.

Vad är den tillåtna skillnaden i versioner mellan kontrollplan och nodpool?

Versionsförskjutningsprincipen tillåter nu en skillnad på upp till 3 versioner mellan kontrollplans- och agentpooler. AKS följer den här skeva versionsprincipändringen från och med version 1.28.

Kan jag hoppa över flera AKS-versioner under klusteruppgradering?

När du uppgraderar ett AKS-kluster som stöds går det inte att hoppa över Kubernetes-delversioner. Kubernetes-kontrollplans versionsförskjutningsprincip stöder inte delversionshopp. Till exempel uppgraderingar mellan:

  • 1.28.x ->1.29.x: tillåten.
  • 1.27.x ->1.28.x: tillåten.
  • 1.27.x ->1.29.x: tillåts inte.

Uppgradera från 1.27.x ->1.29.x:

  1. Uppgradera från 1.27.x ->1.28.x.
  2. Uppgradera från 1.28.x ->1.29.x.

Det går bara att hoppa över flera versioner när du uppgraderar från en version som inte stöds till den lägsta versionen som stöds. Du kan till exempel uppgradera från en 1.25.x som inte stöds till en 1.27.x som stöds om 1.27 är den lägsta delversionen som stöds.

När du utför en uppgradering från en version som inte stöds och hoppar över två eller flera mindre versioner utförs uppgraderingen utan någon funktionsgaranti och undantas från serviceavtalen och den begränsade garantin. Kluster som kör version som inte stöds har flexibiliteten att koppla från uppgraderingar av kontrollplan med nodpoolsuppgraderingar. Men om din version är betydligt inaktuell rekommenderar vi att du återskapar klustret.

Kan jag skapa ett nytt 1.xx.x-kluster under dess 30 dagars supportfönster?

Nej. När en version är inaktuell/borttagen kan du inte skapa ett kluster med den versionen. När ändringen distribueras börjar du se att den gamla versionen har tagits bort från versionslistan. Den här processen kan ta upp till två veckor från tillkännagivandet, progressivt per region.

Jag har en nyligen inaktuell version, kan jag fortfarande lägga till nya nodpooler? Eller måste jag uppgradera?

Nej. Du får inte lägga till nodpooler av den inaktuella versionen i klustret. Skapande eller uppgradering av nodpooler upp till versionskontrollplanets version som inte stöds tillåts, oavsett versionsskillnad mellan nodpoolen och kontrollplanet. Endast mindre aliasuppgraderingar tillåts.

Hur ofta uppdaterar du korrigeringar?

Korrigeringar har en minsta livscykel på två månader. Följ AKS-viktig information för att hålla dig uppdaterad när nya korrigeringar släpps.

Nästa steg

Information om hur du uppgraderar klustret finns i: