Dela via


Viktig information för AKS-motorn på Azure Stack Hub

Gäller för version v0.80.2 av AKS-motorn.

I den här artikeln beskrivs innehållet i AKS-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad till Azure Stack Hub-plattformen. Den här artikeln är inte avsedd att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Att tänka på när du uppgraderar

  • Använder du rätt marketplace-objekt, AKS Base Ubuntu 20.04 Image Distro eller AKS Base Windows Server för din version av AKS-motorn? Du hittar versionerna i avsnittet Ladda ned nya avbildningar och AKS-motorn.
  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. Se kommandoparametrarna distribuera ett Kubernetes-kluster.
  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?
  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du använda uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det. Ett säkerhetskopieringskluster rekommenderas starkt.
  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.
  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara detsamma som det ursprungliga, men planera för att några fler virtuella datorer ska skapas under processen.
  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.
  • Konfigurera en stegvis uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i produktionsklustret.

Använd uppgraderingskommandot

Du måste använda kommandot enligt beskrivningen aks-engine upgrade i Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma upgrade kommando igen för att fortsätta uppgraderingsprocessen. Kommandot upgrade är idempotent och bör återuppta uppgraderingen av klustret när du har skicka kommandot igen. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka dess slutförande.

Uppskattad uppgraderingstid

Den uppskattade uppgraderingstiden är 12 till 15 minuter per virtuell dator i klustret. Det kan till exempel ta cirka 5 timmar att uppgradera ett 20-nodkluster.

Instruktioner för att använda AKS-motorn 0.70.0 och senare

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-bas-Ubuntu-avbildningen och AKS-motorn.

Som beskrivs i dokumentationen för AKS-motorn för Azure Stack Hub kräver distribution av ett Kubernetes-kluster:

  • Aks-motorns binärfil (krävs).
  • AKS Base Ubuntu 16.04-LTS Image Distro (inaktuell – använd inte längre, ändra i API Model för att använda 20.04 i stället).
  • AKS Base Ubuntu 18.04-LTS Image Distro (inaktuell – använd inte längre, ändra i API Model för att använda 20.04 i stället).
  • AKS Base Ubuntu 20.04-LTS Image Distro (krävs för Linux-agenter).
  • AKS Base Windows Server Image (en av följande bilder krävs för Windows-agenter):
    • AKS Base Windows Server Image Containerd.
    • AKS Base Windows Server Image Docker.

Nya versioner av dessa avbildningar är tillgängliga med den här uppdateringen:

Uppgradera Kubernetes-kluster som skapats med Ubuntu 16.04-distributionen

Från och med AKS Engine v0.63.0 är Ubuntu 16.04-distributionen inte längre ett alternativ som stöds eftersom operativsystemet har nått sin livslängd. För AKS Engine v0.67.0 eller senare versioner skriver aks-engine-uppgraderingen automatiskt över det distro-värde som inte stöds aks-ubuntu-16.04 med med aks-ubuntu-18.04. Om du använder Kubernetes v1.24 eller senare för AKS Engine v0.75.3 eller senare skriver uppgraderingen aks-engine-azurestack automatiskt över det distro-värde som inte stöds aks-ubuntu-16.04 med aks-ubuntu-20.04.

Uppgradera Kubernetes-kluster som skapats med Ubuntu 18.04-distributionen

Från och med AKS Engine v0.75.3 är Ubuntu 18.04-distributionen inte längre ett alternativ som stöds eftersom operativsystemet har nått sin livslängd. För AKS Engine v0.75.3 eller senare versioner skriver uppgraderingen aks-engine-azurestack automatiskt över det distro-värde som inte stöds aks-ubuntu-18.04 med aks-ubuntu-20.04.

Uppgradera Kubernetes-kluster som skapats med Docker-containerkörning

I Kubernetes v1.24 togs dockershim-komponenten bort från kubelet. Därför är docker-containerkörningen inte längre ett alternativ som stöds. Mer information finns i Viktig information om Kubernetes v1.24. För AKS Engine v0.75.3 eller senare versioner skriver uppgraderingen aks-engine-azurestack automatiskt över värdet som inte stöds docker containerRuntime med containerd.

För AKS Engine version v0.75.3 kan kluster med Windows-noder på Kubernetes v1.23 använda Windows-basavbildningen med Docker-körningen. Kluster med Windows-noder på Kubernetes v1.24 kan använda Windows-basavbildningen med Containerd-körningen.

AKS-motor och Azure Stack-versionsmappning

Azure Stack Hub-version Version av AKS-motorn
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0, 0.67.3
2108 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0
2206 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0
2301 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0
2306 0.78.0, 0.79.0*, 0.80.2*
2311 0.80.2*

Kommentar

*Stödd. Mer information finns i supportprincipen för AKS-motorns version.

AKS-motor och motsvarande bildmappning

Du hittar kubernetes-versioner som stöds för AKS Engine på Azure Stack Hub i följande tabell. Använd inte kommandot aks-engine get-versions , som returnerar versioner som stöds i globala Azure och i Azure Stack Hub.

AKS-motor AKS-basavbildning Kubernetes-versioner API-modellexempel
v0.43.1 AKS Base Ubuntu 16.04-LTS Image Distro, oktober 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Image Distro, mars 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, maj 2020 (2020.05.13), AKS Base Windows Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS Image Distro, augusti 2020 (2020.08.24), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS Image Distro, september 2020 (2020.09.14), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, januari 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS Base Windows Image (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), AKS Base Windows Image (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API-modellexempel (Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) 1.19.15, 1.20.11 API-modellexempel (Linux, Windows)
v0.67.3 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) 1.19.15, 1.20.11 API-modellexempel (Linux, Windows)
v0.70.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q2 (2022.04.07), AKS Base Windows Image (17763.2565.220408) 1.21.10*, 1.22.7* API-modellexempel (Linux, Windows)
v0.71.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q3 (2022.08.12), AKS Base Windows Image (17763.3232.220805) 1.22.7*, 1.23.6* API-modellexempel (Linux, Windows)
v0.73.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q4 (2022.11.02), AKS Base Windows Image (17763.3532.221102) 1.22.15*, 1.23.13* API-modellexempel (Linux, Windows)
v0.75.3 AKS Base Ubuntu 20.04-LTS Image Distro (2023.032.2), AKS Base Windows Server 2019 Image Docker (17763.3887.20230332), AKS Base Windows Server 2019 Image Containerd (17763.3887.20230332) 1.23.15*, 1.24.9** API-modellexempel (Linux, Windows)
v0.76.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.116.3), AKS Base Windows Server 2019 Image Containerd (17763.4252.20231163) 1.24.11**, 1.25.7** API-modellexempel (Linux, Windows)
v0.77.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.206.1), AKS Base Windows Server 2019 Image Containerd (17763.4645.20232061) 1.25.7**, 1.26.6** API-modellexempel (Linux, Windows)
v0.78.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.242.3), AKS Base Windows Server 2019 Image Containerd (17763.4737.20232423) 1.25.13**, 1.26.8** API-modellexempel (Linux, Windows)
v0.79.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.296.1), AKS Base Windows Server 2019 Image Containerd (17763.4974.20232961) 1.26.9**, 1.27.6** API-modellexempel (Linux, Windows)
v0.80.2 AKS Base Ubuntu 20.04-LTS Image Distro (2024.032.1), AKS Base Windows Server 2019 Image Containerd (17763.5329.20240321) 1.27.10**, 1.28.6** API-modellexempel (Linux, Windows)

Kommentar

*Från och med Kubernetes v1.21 stöds endast molnleverantören för Azure på Azure Stack Hub.

Kommentar

** Från och med Kubernetes v1.24 stöds endast containerkörningen containerd . Mer information finns i avsnittet Uppgradera Kubernetes-kluster som skapats med Docker Container Runtime .

Uppdateringsplanering

AKS-motorkommandot upgrade automatiserar fullständigt uppgraderingsprocessen för klustret och hanterar virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Innan du tillämpar uppdateringen bör du granska viktig information.

Nyheter med AKSe 0.76.0

  • Stöd har lagts till för Kubernetes v1.24.11 och v1.25.7.
  • Du hittar andra funktioner på gitHub-sidan v0.76.0.

Nyheter med AKSe 0.75.3 och senare

AKS Engine-versionen v0.75.3 och alla framtida AKS Engine-versioner på Azure Stack Hub kommer från den nya lagringsplatsen aks-engine-azurestack. Därför bör alla aks-engine kommandon ersättas med aks-engine-azurestack. Kommandon för att få den senaste VERSIONEN av AKS-motorn på Azure Stack Hub har också ändrats. Du kan se de nya kommandona i Skapa Linux-klient och Skapa Windows-klient. Skapa ett problem på den nya lagringsplatsen om du hittar några problem.

AKS Engine version v0.75.3 på Azure Stack Hub erbjuder Ubuntu 20.04 LTS som sin Linux-basavbildning. Från och med den här versionen stöds inte längre Ubuntu 18.04. Mer information finns i Uppgradera Kubernetes-kluster som skapats med Ubuntu 18.04 Distro .

Från och med Kubernetes v1.24 stöds endast körningen containerd . Mer information finns i Uppgradera Kubernetes-kluster som skapats med Docker-körning . För AKS Engine version v0.75.3 kan kluster med Windows-noder på Kubernetes v1.23 använda Windows-basavbildningen med Docker-körning. Kluster med Windows-noder på Kubernetes v1.24 kan använda Windows-basavbildningen med Containerd-körning.

Du hittar fler funktioner på gitHub-sidan v0.75.3.

Instruktioner för att använda AKS-motorn 0.70.0 och senare

Microsoft uppgraderade Azure Cloud Provider i version 0.70.0. Azure Cloud Provider är en kärnkomponent som delas mellan AKS Azure- och AKS-motorn på Azure Stack Hub.

Så här använder du AKS-motorn 0.70.0 och senare:

  • Om du försöker skapa ett nytt Kubernetes-kluster för första gången: Använd exempel-API-modellen som tillhandahålls för lämplig version i AKS-motorn och motsvarande tabell för bildmappning .

  • Om du skapar ett nytt kluster, men vill använda din befintliga API-modell: Ändra DIN API-modell genom att följa anvisningarna för Molnleverantör för Azure . Om den nya inställningen inte inkluderas resulterar det i ett distributionsfel.

  • Om du använder lagringsvolymer: Kontrollera att du använder AzureDiskCSI-drivrutinen . Version 0.70.0 och senare stöder endast CSI-drivrutiner, inte den äldre lagringsprovidern i träd. Om du vill uppgradera följer du anvisningarna i uppgraderingen när du använder lagringsvolymer.

Kända problem

  • Att distribuera flera Kubernetes-tjänster parallellt i ett enda kluster kan leda till ett fel i den grundläggande lastbalanserarens konfiguration. Vi rekommenderar att du distribuerar en tjänst i taget.
  • Eftersom aks-engine-verktyget är en delad källkodslagringsplats i Azure och Azure Stack Hub kan det leda till att du tror att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver de som tidigare angavs. Du kan ignorera dem och använda versionstabellen ovan som officiell guide för den här uppdateringen.
  • AKS Engine v0.67.0 använder fel Windows-avbildning vid distribution av Windows-kluster. Lös problemet med v0.70.0.

Referens

Följande lista är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub kombinerad:

Gäller för version v0.67.0 av AKS-motorn.

I den här artikeln beskrivs innehållet i AKS-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad till Azure Stack Hub-plattformen. Den här artikeln är inte avsedd att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Uppdateringsplanering

AKS-motorkommandot upgrade automatiserar fullständigt uppgraderingsprocessen för klustret. Den hanterar virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Innan du tillämpar uppdateringen bör du granska viktig information.

Att tänka på när du uppgraderar

  • Använder du rätt marketplace-objekt, AKS Base Ubuntu 16.04-LTS eller 18.04 Image Distro eller AKS Base Windows Server för din version av AKS-motorn? Du hittar versionerna i avsnittet "Ladda ned nya avbildningar och AKS-motorn".
  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. Se kommandoparametrarna distribuera ett Kubernetes-kluster.
  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?
  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du använda uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det. Ett säkerhetskopieringskluster rekommenderas starkt.
  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.
  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara detsamma som det ursprungliga, men planera för att några fler virtuella datorer ska skapas under processen.
  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.
  • Konfigurera en stegvis uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i produktionsklustret.

Använd uppgraderingskommandot

Du måste använda kommandot enligt beskrivningen aks-engine upgrade i Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma upgrade kommando igen för att fortsätta uppgraderingsprocessen. Kommandot upgrade är idempotent och bör återuppta uppgraderingen av klustret när du har skicka kommandot igen. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka dess slutförande.

Uppskattad uppgraderingstid

Den uppskattade uppgraderingstiden är 12 till 15 minuter per virtuell dator i klustret. Det kan till exempel ta cirka 5 timmar att uppgradera ett 20-nodkluster.

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-bas-Ubuntu-avbildningen och AKS-motorn.

Som beskrivs i dokumentationen för AKS-motorn för Azure Stack Hub kräver distribution av ett Kubernetes-kluster:

  • Aks-motorns binärfil (krävs).
  • AKS Base Ubuntu 16.04-LTS Image Distro (inaktuell – använd inte längre, ändra i API-modellen så att 18.04 används i stället).
  • AKS Base Ubuntu 18.04-LTS Image Distro (krävs för Linux-agenter).
  • AKS Base Windows Server Image Distro (krävs för Windows-agenter).

Nya versioner av dessa avbildningar är tillgängliga med den här uppdateringen:

Uppgradera Kubernetes-kluster som skapats med Ubuntu 16.04-distributionen

Från och med AKS Engine v0.67.0 är Ubuntu 16.04-distributionen inte längre ett alternativ som stöds eftersom operativsystemet har nått sin livslängd. För att uppgradera ett kluster måste du ange os-distributionen till aks-ubuntu-18.04 i din indata-API-modell, den som genereras av aks-engine deploy och skickas som indata till aks-engine upgrade:

"masterProfile": {
    "distro": "aks-ubuntu-18.04"
},

"agentPoolProfiles": [{
    "distro": "aks-ubuntu-18.04"
}]

AKS-motor och Azure Stack-versionsmappning

Azure Stack Hub-version Version av AKS-motorn
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0
2108 0.63.0, 0.67.0

Uppgraderingssökväg för Kubernetes-version i AKS-motorn v0.67.0

Du hittar den aktuella versionen och uppgraderingsversionen för Azure Stack Hub i följande tabell. Den här tabellen gäller aks-motorklustret i Azure Stack Hub. Använd inte kommandot aks-engine get-versions , som returnerar versioner som stöds i globala Azure och i Azure Stack Hub.

Aktuell version Uppgradering tillgänglig
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11, 1.17.17 1.18.18
1.18.15, 1.18.18 1.19.10
1.19.10 1.19.15, 1.20.11
1.20.6 1.20.11

I JSON-filen för API-modellen anger du versions- och versionsvärdena under avsnittet orchestratorProfile . Om du till exempel planerar att distribuera Kubernetes 1.17.17 måste följande två värden anges (se exemplet kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS-motor och motsvarande bildmappning

AKS-motor AKS-basavbildning Kubernetes-versioner API-modellexempel
v0.43.1 AKS Base Ubuntu 16.04-LTS Image Distro, oktober 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Image Distro, mars 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, maj 2020 (2020.05.13), AKS Base Windows Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS Image Distro, augusti 2020 (2020.08.24), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS Image Distro, september 2020 (2020.09.14), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, januari 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS Base Windows Image (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), AKS Base Windows Image (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 API-modellexempel (Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) 1.19.15, 1.20.11 API-modellexempel (Linux, Windows)

Nyheter

Om du är intresserad av att delta i en privat förhandsversion kan du begära förhandsversionsåtkomst.

De nya funktionerna omfattar:

  • Stöd för Kubernetes 1.19.15 och 1.20.11

Kända problem

  • Att distribuera flera Kubernetes-tjänster parallellt i ett enda kluster kan leda till ett fel i den grundläggande lastbalanserarens konfiguration. Vi rekommenderar att du distribuerar en tjänst i taget.
  • Eftersom aks-engine-verktyget är en delad källkodslagringsplats i Azure och Azure Stack Hub kan det leda till att du tror att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver de som tidigare angavs. Du kan ignorera dem och använda versionstabellen ovan som officiell guide för den här uppdateringen.

Referens

Följande lista är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub kombinerad:

Gäller för version v0.60.1 av AKS-motorn.

I den här artikeln beskrivs innehållet i AKS-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad till Azure Stack Hub-plattformen. Den här artikeln är inte avsedd att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Uppdateringsplanering

AKS-motorkommandot upgrade automatiserar fullständigt uppgraderingsprocessen för klustret och hanterar virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Innan du tillämpar uppdateringen bör du granska viktig information.

Att tänka på när du uppgraderar

  • Använder du rätt marketplace-objekt, AKS Base Ubuntu 16.04-LTS eller 18.04 Image Distro eller AKS Base Windows Server för din version av AKS-motorn? Du hittar versionerna i avsnittet "Ladda ned nya avbildningar och AKS-motorn".
  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. Se kommandoparametrarna distribuera ett Kubernetes-kluster.
  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?
  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du använda uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det. Ett säkerhetskopieringskluster rekommenderas starkt.
  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.
  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara detsamma som det ursprungliga, men planera för att några fler virtuella datorer ska skapas under processen.
  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.
  • Konfigurera en stegvis uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i produktionsklustret.

Använd uppgraderingskommandot

Du måste använda kommandot enligt beskrivningen aks-engine upgrade i Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma upgrade kommando igen för att fortsätta uppgraderingsprocessen. Kommandot upgrade är idempotent och bör återuppta uppgraderingen av klustret när du har skicka kommandot igen. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka dess slutförande.

Uppskattad uppgraderingstid

Den uppskattade uppgraderingstiden är 12 till 15 minuter per virtuell dator i klustret. Det kan till exempel ta cirka 5 timmar att uppgradera ett kluster med 20 noder.

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-bas-Ubuntu-avbildningen och AKS-motorn.

Som beskrivs i dokumentationen för AKS-motorn på Azure Stack Hub kräver distribution av ett Kubernetes-kluster:

  • Aks-motorns binärfil (krävs).
  • AKS Base Ubuntu 16.04-LTS Image Distro (inaktuell – använd inte längre, ändra i API-modellen så att 18.04 används i stället).
  • AKS Base Ubuntu 18.04-LTS Image Distro (krävs för Linux-agenter).
  • AKS Base Windows Server Image Distro (krävs för Windows-agenter).

Nya versioner av dessa är tillgängliga med den här uppdateringen:

AKS-motor och Azure Stack-versionsmappning

Azure Stack Hub-version Version av AKS-motorn
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1

Uppgraderingssökväg för Kubernetes-version i AKS-motorn v0.60.1

Du hittar den aktuella versionen och uppgraderingsversionen för Azure Stack Hub i följande tabell. Den här tabellen gäller aks-motorklustret i Azure Stack Hub. Använd inte kommandot aks-engine get-versions , som returnerar versioner som stöds i globala Azure och i Azure Stack Hub.

Aktuell version Uppgradering tillgänglig
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11 1.17.17, 1.18.15
1.17.17 1.18.15

I JSON-filen för API-modellen anger du versions- och versionsvärdena under avsnittet orchestratorProfile . Om du till exempel planerar att distribuera Kubernetes 1.17.17 måste följande två värden anges (se exemplet kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS-motor och motsvarande bildmappning

AKS-motor AKS-basavbildning Kubernetes-versioner API-modellexempel
v0.43.1 AKS Base Ubuntu 16.04-LTS Image Distro, oktober 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Image Distro, mars 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, maj 2020 (2020.05.13), AKS Base Windows Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS Image Distro, augusti 2020 (2020.08.24), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS Image Distro, september 2020 (2020.09.14), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, januari 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
AKS Base Windows Image (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Nyheter

Om du är intresserad av att delta i en privat förhandsversion kan du begära förhandsversionsåtkomst.

De nya funktionerna omfattar:

  • Allmän tillgänglighet för Ubuntu 18.04.
  • Offentlig förhandsversion av certifikatrotation #4214.
  • T4 Nvidia GPU Private Preview #4259.
  • Privat förhandsversion av Azure Active Directory-integrering.
  • CSI-drivrutin för privat förhandsversion av Azure Blobs #712.
  • CSI Driver Azure Disks Public Preview #712.
  • CSI Driver NFS Public Preview #712.
  • Stöd för Kubernetes 1. 17.17 #4188 och 1.18.15 #4187.

Kända problem

  • Att distribuera flera Kubernetes-tjänster parallellt i ett enda kluster kan leda till ett fel i den grundläggande lastbalanserarens konfiguration. Vi rekommenderar att du distribuerar en tjänst i taget.
  • Eftersom aks-engine-verktyget är en delad källkodslagringsplats i Azure och Azure Stack Hub kan det leda till att du tror att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver de som tidigare angavs. Du kan ignorera dem och använda versionstabellen ovan som officiell guide för den här uppdateringen.

Referens

Följande lista är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub kombinerad:

Gäller för version v0.55.4 av AKS-motorn.

I den här artikeln beskrivs innehållet i AKS-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad till Azure Stack Hub-plattformen. Den här artikeln är inte avsedd att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Uppdateringsplanering

AKS-motorkommandot upgrade automatiserar fullständigt uppgraderingsprocessen för klustret och hanterar virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Innan du tillämpar uppdateringen bör du granska viktig information.

Att tänka på när du uppgraderar

  • Använder du rätt marketplace-objekt, AKS Base Ubuntu 16.04-LTS Image Distro för din version av AKS-motorn? Du hittar versionerna i avsnittet "Ladda ned ny avbildning och AKS-motor".
  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. Se kommandoparametrarna distribuera ett Kubernetes-kluster.
  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?
  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du använda uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det. Ett säkerhetskopieringskluster rekommenderas starkt.
  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.
  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara detsamma som det ursprungliga, men planera för att några fler virtuella datorer ska skapas under processen.
  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.
  • Konfigurera en stegvis uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i produktionsklustret.

Använd uppgraderingskommandot

Du måste använda kommandot enligt beskrivningen aks-engine upgrade i Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma upgrade kommando igen för att fortsätta uppgraderingsprocessen. Kommandot upgrade är idempotent och bör återuppta uppgraderingen av klustret när du har skicka kommandot igen. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka dess slutförande.

Uppskattad uppgraderingstid

Den uppskattade uppgraderingstiden är 12 till 15 minuter per virtuell dator i klustret. Det kan till exempel ta cirka 5 timmar att uppgradera ett kluster med 20 noder.

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-basmotorn Ubuntu Image och AKS.

Som beskrivs i dokumentationen för AKS-motorn på Azure Stack Hub kräver distribution av ett Kubernetes-kluster två huvudkomponenter:

  • Aks-motorns binärfil (krävs).
  • AKS Base Ubuntu 16.04-LTS Image Distro

Nya versioner av dessa avbildningar är tillgängliga med den här uppdateringen:

AKS-motor och Azure Stack-versionsmappning

Azure Stack Hub-version Version av AKS-motorn
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4

Uppgraderingssökväg för Kubernetes-version i AKS-motorn v0.55.4

Du hittar den aktuella versionen och uppgraderingsversionen för Azure Stack Hub i följande tabell. Den här tabellen gäller aks-motorklustret i Azure Stack Hub. Använd inte kommandot aks-engine get-versions , som returnerar versioner som stöds i globala Azure och i Azure Stack Hub.

Aktuell version Uppgradering tillgänglig
1.15.10 1.15.12
1.15.12, 1.16.8, 1.16.9 1.16.14
1.16.8, 1.16.9, 1.16.14 1.17.11

I JSON-filen för API-modellen anger du versions- och versionsvärdena under avsnittet orchestratorProfile . Om du till exempel planerar att distribuera Kubernetes 1.17.17 måste följande två värden anges (se exemplet kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

AKS-motor och motsvarande bildmappning

Kubernetes-versioner Kommentar
1.15.5, 1.15.4, 1.14.8, 1.14.7
1.15.10, 1.14.7
1.15.12, 1.16.8, 1.16.9 API-modellexempel (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API-modellexempel (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 API-modellexempel (Linux, Windows)

Nyheter

  • Uppdatera Azure Stacks virtuella Linux-hårddisk till 2020.09.14 #3828
  • Lägger till stöd för K8s v1.17.11 på Azure Stack #3702
  • Lägger till stöd för K8s v1.16.14 på Azure Stack #3704
  • Linux VHD-uppdatering till 2020.09.14 #3750
  • Windows VHD-uppdatering till augusti #3730
  • Uppgraderar Kubernetes metrics-server till v0.3.7 #3669
  • Uppgraderar Docker-versionen för att åtgärda loggrotationsproblemet #3693
  • Uppgraderar CoreDNS till v1.7.0 #3608
  • Använda moby 19.03.x-paket #3549
  • Korrigeringar av azure-cni-uppdateringsstrategin #3571

Kända problem

  • Att distribuera flera Kubernetes-tjänster parallellt i ett enda kluster kan leda till ett fel i den grundläggande lastbalanserarens konfiguration. Vi rekommenderar att du distribuerar en tjänst i taget.
  • När du kör aks-engine get-versionsgenererar utdata information som gäller för Azure och Azure Stack Hub. Det finns dock inget explicit sätt att urskilja vad som motsvarar Azure Stack Hub. Använd inte det här kommandot för att avgöra vilka versioner som är tillgängliga för uppgradering. Använd uppgraderingsreferenstabellen som beskrivs i föregående avsnitt.
  • Eftersom aks-engine-verktyget är en delad källkodslagringsplats i Azure och Azure Stack Hub kan det leda till att du tror att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver de som tidigare angavs. Du kan ignorera dem och använda versionstabellen ovan som officiell guide för den här uppdateringen.

Referens

Det här är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub tillsammans:

Gäller för version 0.48.0 eller tidigare av AKS-motorn.

I den här artikeln beskrivs innehållet i AKS-motorn (Azure Kubernetes Service) i Azure Stack Hub-uppdateringen. Uppdateringen innehåller förbättringar och korrigeringar för den senaste versionen av AKS-motorn som är riktad till Azure Stack Hub-plattformen. Den här artikeln är inte avsedd att dokumentera versionsinformationen för AKS-motorn för globala Azure.

Uppdateringsplanering

AKS-motorkommandot upgrade automatiserar fullständigt uppgraderingsprocessen för klustret och hanterar virtuella datorer (VM), nätverk, lagring, Kubernetes och orkestreringsuppgifter. Innan du tillämpar uppdateringen bör du granska viktig information.

Att tänka på när du uppgraderar

  • Använder du rätt marketplace-objekt, AKS Base Ubuntu 16.04-LTS Image Distro för din version av AKS-motorn? Du hittar versionerna i avsnittet Ladda ned de nya aks-basversionerna Ubuntu Image och AKS-motorn.
  • Använder du rätt klusterspecifikation (apimodel.json) och resursgrupp för målklustret? När du ursprungligen distribuerade klustret genererades den här filen i utdatakatalogen. Se kommandoparametrarna distribuera ett Kubernetes-kluster.
  • Använder du en tillförlitlig dator för att köra AKS-motorn och från vilken du utför uppgraderingsåtgärder?
  • Om du uppdaterar ett driftkluster med aktiva arbetsbelastningar kan du använda uppgraderingen utan att påverka dem, förutsatt att klustret är under normal belastning. Du bör dock ha ett säkerhetskopieringskluster om det finns ett behov av att omdirigera användare till det. Ett säkerhetskopieringskluster rekommenderas starkt.
  • Om möjligt kör du kommandot från en virtuell dator i Azure Stack Hub-miljön för att minska nätverkshoppen och potentiella anslutningsfel.
  • Kontrollera att din prenumeration har tillräckligt med kvot för hela processen. Processen allokerar nya virtuella datorer under processen. Det resulterande antalet virtuella datorer skulle vara detsamma som det ursprungliga, men planera för att några fler virtuella datorer ska skapas under processen.
  • Inga systemuppdateringar eller schemalagda aktiviteter planeras.
  • Konfigurera en stegvis uppgradering på ett kluster som har konfigurerats med samma värden som produktionsklustret och testa uppgraderingen där innan du gör det i produktionsklustret.

Använd uppgraderingskommandot

Du måste använda kommandot enligt beskrivningen aks-engine upgrade i Uppgradera ett Kubernetes-kluster på Azure Stack Hub.

Uppgraderingsavbrott

Ibland avbryter oväntade faktorer uppgraderingen av klustret. Ett avbrott kan inträffa när AKS-motorn rapporterar ett fel eller om något händer med AKS-motorns körningsprocess. Granska orsaken till avbrottet, åtgärda det och skicka samma upgrade kommando igen för att fortsätta uppgraderingsprocessen. Kommandot upgrade är idempotent och bör återuppta uppgraderingen av klustret när du har skicka kommandot igen. Normalt ökar avbrott tiden för att slutföra uppdateringen, men bör inte påverka dess slutförande.

Uppskattad uppgraderingstid

Den uppskattade uppgraderingstiden är 12 till 15 minuter per virtuell dator i klustret. Det kan till exempel ta cirka 5 timmar att uppgradera ett kluster med 20 noder.

Ladda ned ny avbildning och AKS-motor

Ladda ned de nya versionerna av AKS-basmotorn Ubuntu Image och AKS.

Som beskrivs i dokumentationen för AKS-motorn på Azure Stack Hub kräver distribution av ett Kubernetes-kluster två huvudkomponenter:

  • Aks-motorns binärfil (krävs).
  • AKS Base Ubuntu 16.04-LTS Image Distro.

Nya versioner av dessa är tillgängliga med den här uppdateringen:

Uppgraderingssökväg för Kubernetes-version

Du hittar den aktuella versionen och uppgraderingsversionen för Azure Stack Hub i följande tabell. Den här tabellen gäller aks-motorklustret i Azure Stack Hub. Använd inte kommandot aks-engine get-versions , som returnerar versioner som stöds i globala Azure och i Azure Stack Hub.

Aktuell version Uppgradering tillgänglig
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

Nyheter

  • Stöd för Kubernetes version 1.15.10 (#2834). När du distribuerar ett nytt kluster i din API-modell .json fil (kallas även klusterdefinitionsfilen) anger du både versionsnumret och delversionsnumret i följande format. Ett exempel på en klusterdefinitionsfil finns i kubernetes-azurestack.json.

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Kommentar

    Om Kubernetes-versionen inte uttryckligen anges i API-modellen .json fil används version 1.15 (#2932) och orchestratorVersion är standardvärdet 1.15.11, vilket resulterar i ett fel under distributionen av klustret.

  • Med aks-engine v0.43.1 fungerar standardfrekvensinställningarna för molnleverantören för att utföra sin kontrollloop och andra uppgifter fungerar inte bra med Tröskelvärden för Azure Stack Hub Resource Manager för inkommande begäranden. Den här uppdateringen ändrar standardinställningarna för Azure Stack Hub för att minska återförsöksbelastningen till Azure Stack Hub Resource Manager (#2861).

  • Det nya verifieringssteget i aks-engine resulterar antingen i att körningen stoppar eller visar varningar om API-modellen .json fil innehåller egenskaper som inte stöds av Azure Stack Hub (#2717).

  • Med en ny verifieringsincheckning verifierar aks-motorn tillgängligheten för den version av AKS-basavbildningen som behövs för versionen av aks-engine-körningen (#2342). Detta inträffar efter parsning av API-modellen .json-filen och innan du anropar Azure Stack Hub Resource Manager.

  • Med det nya aks-engine-alternativet "--control-plane-only" i upgrade kommandot kan användaren uppgradera åtgärder till att endast rikta in sig på de virtuella huvuddatorerna (#2635).

  • Uppdateringar av Linux Kernel version 4.15.0-1071-azure för Ubuntu 16.04-LTS. Mer information finns i "Package: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security]".

  • Nya hyperkube-uppdateringar som stöder Kubernetes-versionerna 1.14.8 och 1.15.10.

  • Uppdatera kubectl så att det matchar kubernetes-versionen för klustret. Den här komponenten är tillgänglig i Kubernetes-klusterkontrollplanets noder. Du kan köra den med SSH till en huvudserver.

  • Uppdateringar för Azure Container Monitor-tillägget med den senaste versionen från februari 2020 (#2850).

  • Uppgradering av coredns till version v1.6.6 (#2555).

  • Uppgradera etcd till version 3.3.18 (#2462).

  • Uppgradera moby till version 3.0.11 (#2887).

  • Med den här versionen minskar AKS Engine beroendet från k8s.gcr.io och med nu använda den officiella Kubernetes MCR registry @ mcr.microsoft.com när du skapar dess avbildningar (#2722).

Kända problem

  • Att distribuera flera Kubernetes-tjänster parallellt i ett enda kluster kan leda till ett fel i den grundläggande lastbalanserarens konfiguration. Vi rekommenderar att du distribuerar en tjänst i taget.
  • När aks-motorn körs get-versions skapas information som gäller för Azure och Azure Stack Hub. Det finns dock inget explicit sätt att urskilja vad som motsvarar Azure Stack Hub. Använd inte det här kommandot för att avgöra vilka versioner som är tillgängliga för uppgradering. Använd uppgraderingsreferenstabellen som beskrivs i föregående avsnitt.
  • Eftersom aks-engine-verktyget är en delad källkodslagringsplats i Azure och Azure Stack Hub kan det leda till att du tror att verktyget stöder andra versioner av Kubernetes och OS-plattformen utöver de som tidigare angavs. Du kan ignorera dem och använda versionstabellen ovan som officiell guide för den här uppdateringen.

Referens

Följande är en lista över några av de buggar som har åtgärdats och den fullständiga uppsättningen viktig information från version 0.44.0 till version 0.48.0. Viktig information omfattar både Azure och Azure Stack Hub.

Felkorrigeringar

  • userAssignedIdentityId i Windows azure.json saknade citattecken (#2327)

  • update config Tillägg är endast uppgradering (#2282)

  • Överskriden tidsgräns för att hämta hanterings-IP på Windows-noder (#2284)

  • Lägg till 1.0.28 Azure CNI-.zip fil i Windows VHD (#2268)

  • Korrigera standardordningen för inställning IPAddressCount (#2358)

  • Uppdatera för att använda enstaka omsagent yaml för alla K8s-versioner för att undvika manuella fel och enkel underhåll (#2692)

Viktig information

Det här är den fullständiga uppsättningen viktig information för Azure och Azure Stack Hub tillsammans:

Nästa steg